v0.4.2: subtitles, set default options, watcher fixes

What's Changed

• feat: add subtitle option to section by @machow in #187
• feat: add config file (_quarto.yml) to quartodoc build --watch by @hamelsmu in #229
• feat: option defaults by @machow in #233
• fix: ignore extraneous files for quartdoc build -- watch by @hamelsmu in #228
• fix: dynamic load better handles instances by @machow in #231

Full Changelog: v0.4.1...v0.4.2

v0.4.1: include_empty option to skip undocumented objects

What's Changed

• Add include_empty option to Auto, which skips documenting objects without a docstring (#218)

Full Changelog: v0.4.0...v0.4.1

v0.4.0: very simple, automatic package docs; better automodule

What's Changed

• add --watch flag to quartodoc build by @hamelsmu in #210
• feat: automodule by @machow in #212
  • creates a default reference, if user doesn't specify sections.
• fix: modules now can include classes as members
  • We're still exploring the best way to have embedded docs (e.g. when documenting a module, including docs for a method on the class on the module).
• docs: refactor headings by @hamelsmu in #216

Full Changelog: v0.3.5...v0.4.0

v0.3.5

What's Changed

• fix: better messaging when object can't be found by @machow in #192
• fix: do not render attribute annotations twice by @machow in #205
• fix: Add .qmd path to summary link for Page by @schloerke in #202
• fix: do not accept extra fields in pydantic by @machow in #200
• feat: use italics when rendering a "required" default value by @schloerke in #207
• dev: pin pydantic to v1 by @machow in #214

New Contributors

• @schloerke made their first contribution in #207

Full Changelog: v0.3.4...v0.3.5

v0.3.4

What's Changed

• feat: Add a high-level dynamic argument, to attempt loading every object dynamically by default (#182)
• feat: add entries for canonical paths to sphinx inventory. This enables more robust interlinking (#180)
• feat: yaml validation by @hamelsmu in #189
  • This should result in better messages, when there is an error in quartodoc configs!
• fix: correct sidebar structure by (#173)
• refactor: add _render_table method to consolidate code by @machow in #181

Full Changelog: v0.3.3...v0.3.4

v0.3.3: support griffe v0.28, wrap interlinks in code

What's Changed

Fixes

• fix: support griffe v0.28 by @machow in #152
• fix dynamic class loading by @machow in #174
• fix: do not sanitize interlinks in table descriptions by @machow in #178

Features

• feat: interlink link content now in a code element by @machow in #179

Misc

• dev: pin versions & get rid of panflute by @hamelsmu in #162
• dev: remove python 3.8 tag by @machow in #171
• chore: add COC, update license and authors by @machow in #70

New Contributors

• @hamelsmu made their first contribution in #162

Full Changelog: v0.3.2...v0.3.3

v0.3.2: lua interlinks filter

Note that this PR removes the old python interlinks filter, in favor of a lua one. This enables people to use versions of quarto v1.3+.

The filter should be installed automatically, when you run quarto add extension machow/quartodoc.

What's Changed

• docs: miscellaneous updates by @machow in #148
• feat: Lua interlinks filter by @machow in #128
  • The only change in behavior should be the output if it cannot find an item to create a link from. Previously, for a link like :function:`my_func` it output the full input. The new output is closer to a reader might expect.
  • old output: :function:`my_func`
  • new output: `my_func`

Full Changelog: v0.3.1...v0.3.2

v0.3.1: add builder source_dir option

What's Changed

• feat: Builder source_dir parameter for non-package loads by @machow in #131
• docs: correctly escape when mentioning quarto block by @machow in #126
• docs: use quartodoc build for cli instructions by @machow in #127
• tests: python interlinks by @machow in #122
• docs: quarto install link by @machow in #129
• docs: how to document classes by @machow in #132

Full Changelog: v0.3.0...v0.3.1

v0.3.0: config layouts, module docs, CLI entrypoint

What's Changed

• feat: layouts module for representing config settings (#64)
• feat: allow documenting entire modules (#81)
• feat: add cli entrypoint (#107)
• feat: quartodoc build accepts --filter argument (#121)
• feat: top-level imports of Auto, blueprint, and collect (#121)
• ux: log when an api page is written (#89)
• refactor!: remove Builder methods: .do_collect(), do_blueprint(), do_summarize() (#121)
• refactor!: Builder.rewrite_all_pages now set to False by default (#121)
• fix: sidebar now always includes page named index (#79)
• fix: always render *args and **kwargs in signature (#102)
• fix: better support for rendering /, and * in signatures (#119)
• docs: site overhaul (#121)

Full Changelog: v0.2.1...v0.3.0

Fix: contents of custom sections missing, breaking renders

What's Changed

• fix: patched docstrings missing their contents by @machow in #84

Full Changelog: v0.2.1...v0.2.2