Enhanced Sphinx TocTree which shows classes, functions etc. as if they were sections.
Docs | |
---|---|
Tests | |
PyPI | |
Anaconda | |
Activity | |
QA | |
Other |
This idea has been suggested in sphinx-doc/sphinx#6316 and sphinx-doc/sphinx#6435
You can see toctree-plus
in action in this project's documentation,
and the documentation for domdf-python-tools (ReadTheDocs Sphinx Theme) and whey (Furo Sphinx Theme).
toctree_plus
can be installed from PyPI or Anaconda.
To install with pip
:
$ python -m pip install toctree_plus
To install with conda
:
- First add the required channels
$ conda config --add channels https://conda.anaconda.org/conda-forge $ conda config --add channels https://conda.anaconda.org/domdfcoding
- Then install
$ conda install toctree_plus
Enable toctree_plus
by adding "sphinxcontrib.toctree_plus"
to the extensions
variable in conf.py
:
extensions = [
...
"sphinxcontrib.toctree_plus",
]
For more information see https://www.sphinx-doc.org/en/master/usage/extensions/index.html#third-party-extensions .
There is currently only a single configuration option: toctree_plus_types
.
This determines the directive types that appear in the toctree. The default value is {"class", "function", "method"}
.