66 lines
2.3 KiB
Python
66 lines
2.3 KiB
Python
|
# $Id: standalone.py 9539 2024-02-17 10:36:51Z milde $
|
||
|
|
# Author: David Goodger <goodger@python.org>
|
||
|
|
# Copyright: This module has been placed in the public domain.
|
||
|
|
|
||
|
|
"""
|
||
|
|
Standalone file Reader for the reStructuredText markup syntax.
|
||
|
|
"""
|
||
|
|
|
||
|
|
__docformat__ = 'reStructuredText'
|
||
|
|
|
||
|
|
|
||
|
|
from docutils import frontend, readers
|
||
|
|
from docutils.transforms import frontmatter, references, misc
|
||
|
|
|
||
|
|
|
||
|
|
class Reader(readers.Reader):
|
||
|
|
|
||
|
|
supported = ('standalone',)
|
||
|
|
"""Contexts this reader supports."""
|
||
|
|
|
||
|
|
document = None
|
||
|
|
"""A single document tree."""
|
||
|
|
|
||
|
|
settings_spec = (
|
||
|
|
'Standalone Reader Options',
|
||
|
|
None,
|
||
|
|
(('Disable the promotion of a lone top-level section title to '
|
||
|
|
'document title (and subsequent section title to document '
|
||
|
|
'subtitle promotion; enabled by default).',
|
||
|
|
['--no-doc-title'],
|
||
|
|
{'dest': 'doctitle_xform', 'action': 'store_false',
|
||
|
|
'default': True, 'validator': frontend.validate_boolean}),
|
||
|
|
('Disable the bibliographic field list transform (enabled by '
|
||
|
|
'default).',
|
||
|
|
['--no-doc-info'],
|
||
|
|
{'dest': 'docinfo_xform', 'action': 'store_false',
|
||
|
|
'default': True, 'validator': frontend.validate_boolean}),
|
||
|
|
('Activate the promotion of lone subsection titles to '
|
||
|
|
'section subtitles (disabled by default).',
|
||
|
|
['--section-subtitles'],
|
||
|
|
{'dest': 'sectsubtitle_xform', 'action': 'store_true',
|
||
|
|
'default': False, 'validator': frontend.validate_boolean}),
|
||
|
|
('Deactivate the promotion of lone subsection titles.',
|
||
|
|
['--no-section-subtitles'],
|
||
|
|
{'dest': 'sectsubtitle_xform', 'action': 'store_false'}),
|
||
|
|
))
|
||
|
|
|
||
|
|
config_section = 'standalone reader'
|
||
|
|
config_section_dependencies = ('readers',)
|
||
|
|
|
||
|
|
def get_transforms(self):
|
||
|
|
return super().get_transforms() + [
|
||
|
|
references.Substitutions,
|
||
|
|
references.PropagateTargets,
|
||
|
|
frontmatter.DocTitle,
|
||
|
|
frontmatter.SectionSubTitle,
|
||
|
|
frontmatter.DocInfo,
|
||
|
|
references.AnonymousHyperlinks,
|
||
|
|
references.IndirectHyperlinks,
|
||
|
|
references.Footnotes,
|
||
|
|
references.ExternalTargets,
|
||
|
|
references.InternalTargets,
|
||
|
|
references.DanglingReferences,
|
||
|
|
misc.Transitions,
|
||
|
|
]
|