sphinx-autodoc-sphinx 0.0.1a8

Sphinx extension for documenting extension config values as first-class conf.py reference entries

sphinx-autodoc-sphinx

Sphinx extension for documenting config values registered by app.add_config_value() as copyable conf.py reference entries.

Rendered entries use the shared stack: sphinx_ux_autodoc_layout owns the visible api-* structure, sphinx_ux_badges owns badge output, and sphinx_autodoc_typehints_gp is auto-loaded so displayed config types follow the same annotation rules as the rest of the autodoc family.

Install

$ pip install sphinx-autodoc-sphinx

Usage

extensions = ["sphinx_autodoc_sphinx"]

Then document one config value:

```{eval-rst}
.. autoconfigvalue:: sphinx_fonts.sphinx_font_preload
```

Or generate a full reference section for an extension module:

.. autoconfigvalue-index:: sphinx_fonts
.. autoconfigvalues:: sphinx_fonts

.. autoconfigvalue-page:: sphinx_autodoc_argparse.exemplar

Documentation

See the full documentation for live demos, generated confval entries, and downstream usage patterns.