ModuleTocTree

class documenteer.sphinxext.packagetoctree.ModuleTocTree(name, arguments, options, content, lineno, content_offset, block_text, state, state_machine)

Bases: docutils.parsers.rst.Directive

Toctree that automatically displays a list of modules in the Stack documentation.

Notes

Modules are detected as document paths. All modules have index pages with paths modules/{{name}}/index by virtue of the linking during the build process. Thus this directive does not directly interact with eups.

Options

skip

Module (or modules) to skip (optional). For multiple modules, provide a comma-delimited list. If possible, use the -s option from the stack-docs command-line app instead to prevent orphan document issues.

Attributes Summary

has_content
option_spec

Methods Summary

run()

Main entrypoint method.

Attributes Documentation

has_content = False

option_spec = {'skip': <function unchanged>}

Methods Documentation

run()

Main entrypoint method.

Returns

new_nodeslist

Nodes to add to the doctree.