You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
72 lines
2.6 KiB
72 lines
2.6 KiB
"""
|
|
sphinx.environment.collectors.metadata
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
The metadata collector components for sphinx.environment.
|
|
|
|
:copyright: Copyright 2007-2020 by the Sphinx team, see AUTHORS.
|
|
:license: BSD, see LICENSE for details.
|
|
"""
|
|
|
|
from typing import Any, Dict, List, Set, cast
|
|
|
|
from docutils import nodes
|
|
|
|
from sphinx.application import Sphinx
|
|
from sphinx.environment import BuildEnvironment
|
|
from sphinx.environment.collectors import EnvironmentCollector
|
|
|
|
|
|
class MetadataCollector(EnvironmentCollector):
|
|
"""metadata collector for sphinx.environment."""
|
|
|
|
def clear_doc(self, app: Sphinx, env: BuildEnvironment, docname: str) -> None:
|
|
env.metadata.pop(docname, None)
|
|
|
|
def merge_other(self, app: Sphinx, env: BuildEnvironment,
|
|
docnames: Set[str], other: BuildEnvironment) -> None:
|
|
for docname in docnames:
|
|
env.metadata[docname] = other.metadata[docname]
|
|
|
|
def process_doc(self, app: Sphinx, doctree: nodes.document) -> None:
|
|
"""Process the docinfo part of the doctree as metadata.
|
|
|
|
Keep processing minimal -- just return what docutils says.
|
|
"""
|
|
if len(doctree) > 0 and isinstance(doctree[0], nodes.docinfo):
|
|
md = app.env.metadata[app.env.docname]
|
|
for node in doctree[0]:
|
|
# nodes are multiply inherited...
|
|
if isinstance(node, nodes.authors):
|
|
authors = cast(List[nodes.author], node)
|
|
md['authors'] = [author.astext() for author in authors]
|
|
elif isinstance(node, nodes.field):
|
|
assert len(node) == 2
|
|
field_name = cast(nodes.field_name, node[0])
|
|
field_body = cast(nodes.field_body, node[1])
|
|
md[field_name.astext()] = field_body.astext()
|
|
elif isinstance(node, nodes.TextElement):
|
|
# other children must be TextElement
|
|
# see: http://docutils.sourceforge.net/docs/ref/doctree.html#bibliographic-elements # NOQA
|
|
md[node.__class__.__name__] = node.astext()
|
|
|
|
for name, value in md.items():
|
|
if name in ('tocdepth',):
|
|
try:
|
|
value = int(value)
|
|
except ValueError:
|
|
value = 0
|
|
md[name] = value
|
|
|
|
doctree.pop(0)
|
|
|
|
|
|
def setup(app: Sphinx) -> Dict[str, Any]:
|
|
app.add_env_collector(MetadataCollector)
|
|
|
|
return {
|
|
'version': 'builtin',
|
|
'parallel_read_safe': True,
|
|
'parallel_write_safe': True,
|
|
}
|