Domain¶
Python¶
- foo.spam(eggs)¶
My spam
autofunction¶
- sphinx_press_theme.add_toctree_data(app, pagename, templatename, context, doctree)¶
Create toctree_data, used to build sidebar navigation
- Parameters:
pagename (str) – The name of the page
templatename (str) – The name of the templatename
context (dict) – The context
doctree (docutils.nodes.document) – A doctree
Add to toctree_data to context that will be available on templates. Although data is “global”, it is called once per page because current page is “highlighted”, and some part of TOC might be collapsed.
- Returns:
None
autoclass¶
- class sphinx.environment.collectors.EnvironmentCollector¶
An EnvironmentCollector is a specific data collector from each document.
It gathers data and stores
BuildEnvironment
as a database. Examples of specific data would be images, download files, section titles, metadatas, index entries and toctrees, etc.Note
This class essentially wraps a sub-set of Sphinx event callbacks.
- clear_doc(app: Sphinx, env: BuildEnvironment, docname: str) None ¶
Remove specified data of a document.
This method is called on the removal of the document.
See also
- get_outdated_docs(app: Sphinx, env: BuildEnvironment, added: set[str], changed: set[str], removed: set[str]) list[str] ¶
Return a list of docnames to re-read.
This method is called before reading the documents.
See also
- get_updated_docs(app: Sphinx, env: BuildEnvironment) list[str] ¶
Return a list of docnames to re-read.
This method is called after reading the whole of documents.
See also
- merge_other(app: Sphinx, env: BuildEnvironment, docnames: set[str], other: BuildEnvironment) None ¶
Merge in specified data regarding docnames from a different BuildEnvironment object which coming from a subprocess in parallel builds.
See also
- process_doc(app: Sphinx, doctree: nodes.document) None ¶
Process a document and gather specific data from it.
This method is called after the document is read.
See also