module sphinxext.sphinx_toctree_extension

Inheritance diagram of pyquickhelper.sphinxext.sphinx_toctree_extension

Short summary

module pyquickhelper.sphinxext.sphinx_toctree_extension

#directive-toctree>`_ Overwrites `toctree <https://www.sphinx-doc.org/en/master/markup/toctree.html directive to get catch exceptions when a document is processed inline.

source on GitHub

Classes

class

truncated documentation

CustomAdaptersTocTree

Sphinx directive

CustomTocTree

Overwrites toctree. The code is …

CustomTocTreeCollector

Overwrites TocTreeCollector. …

Functions

function

truncated documentation

setup

Setup for toctree and toctree2 (sphinx).

Properties

property

truncated documentation

config

Reference to the Config object.

env

Reference to the BuildEnvironment object.

Methods

method

truncated documentation

enable

process_doc

Build a TOC from the doctree and store it in the inventory.

run

Documentation

#directive-toctree>`_ Overwrites `toctree <https://www.sphinx-doc.org/en/master/markup/toctree.html directive to get catch exceptions when a document is processed inline.

source on GitHub

class pyquickhelper.sphinxext.sphinx_toctree_extension.CustomAdaptersTocTree(env: BuildEnvironment)[source]

Bases: TocTree

Sphinx directive

class pyquickhelper.sphinxext.sphinx_toctree_extension.CustomTocTree(name, arguments, options, content, lineno, content_offset, block_text, state, state_machine)[source]

Bases: TocTree

Overwrites toctree. The code is located at sphinx/directives/other.py.

source on GitHub

final_argument_whitespace = False[source]

May the final argument contain whitespace?

has_content = True[source]

May the directive have content?

option_spec = {'caption': <function unchanged_required>, 'glob': <function flag>, 'hidden': <function flag>, 'includehidden': <function flag>, 'maxdepth': <class 'int'>, 'name': <function unchanged>, 'numbered': <function int_or_nothing>, 'reversed': <function flag>, 'titlesonly': <function flag>}[source]

Mapping of option names to validator functions.

optional_arguments = 0[source]

Number of optional arguments after the required arguments.

required_arguments = 0[source]

Number of required directive arguments.

class pyquickhelper.sphinxext.sphinx_toctree_extension.CustomTocTreeCollector[source]

Bases: TocTreeCollector

Overwrites TocTreeCollector.

source on GitHub

process_doc(app, doctree)[source]

Build a TOC from the doctree and store it in the inventory.

source on GitHub

pyquickhelper.sphinxext.sphinx_toctree_extension.setup(app)[source]

Setup for toctree and toctree2 (sphinx).

source on GitHub