PackageTocTree#

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

Bases: Directive

Toctree that automatically lists packages in the Stack documentation.

Notes

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

Options

skip

Package (or packages) to skip (optional). For multiple packages, 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

May the directive have content?

option_spec

Mapping of option names to validator functions.

Methods Summary

run()

Main entrypoint method.

Attributes Documentation

has_content = False#

May the directive have content?

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

Mapping of option names to validator functions.

Methods Documentation

run()#

Main entrypoint method.

Returns:

new_nodes – Nodes to add to the doctree.

Return type:

list