sphinx-toolbox / toctree_plus

Enhanced Sphinx TocTree that shows classes and functions as if they were sections.

Home Page:https://toctree-plus.readthedocs.io/en/latest

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

.. toctree:: +

Enhanced Sphinx TocTree which shows classes, functions etc. as if they were sections.

Docs Documentation Build Status Docs Check Status
Tests Linux Test Status Windows Test Status macOS Test Status Coverage
PyPI PyPI - Package Version PyPI - Supported Python Versions PyPI - Supported Implementations PyPI - Wheel
Anaconda Conda - Package Version Conda - Platform
Activity GitHub last commit GitHub commits since tagged version Maintenance PyPI - Downloads
QA CodeFactor Grade Flake8 Status mypy status
Other License GitHub top language Requirements Status

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).

Installation

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 .

Configuration

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"}.

Links

About

Enhanced Sphinx TocTree that shows classes and functions as if they were sections.

https://toctree-plus.readthedocs.io/en/latest

License:BSD 2-Clause "Simplified" License


Languages

Language:HTML 75.9%Language:TeX 22.7%Language:Python 1.4%Language:Just 0.0%