PackageTocTree

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

Bases: docutils.parsers.rst.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
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.