2 # Author: David Goodger <goodger@python.org>
3 # Copyright: This module has been placed in the public domain.
6 Standalone file Reader for the reStructuredText markup syntax.
9 __docformat__
= 'reStructuredText'
13 from docutils
import frontend
, readers
14 from docutils
.transforms
import frontmatter
, references
, misc
17 class Reader(readers
.Reader
):
19 supported
= ('standalone',)
20 """Contexts this reader supports."""
23 """A single document tree."""
28 (('Disable the promotion of a lone top-level section title to '
29 'document title (and subsequent section title to document '
30 'subtitle promotion; enabled by default).',
32 {'dest': 'doctitle_xform', 'action': 'store_false', 'default': 1,
33 'validator': frontend
.validate_boolean
}),
34 ('Disable the bibliographic field list transform (enabled by '
37 {'dest': 'docinfo_xform', 'action': 'store_false', 'default': 1,
38 'validator': frontend
.validate_boolean
}),
39 ('Activate the promotion of lone subsection titles to '
40 'section subtitles (disabled by default).',
41 ['--section-subtitles'],
42 {'dest': 'sectsubtitle_xform', 'action': 'store_true', 'default': 0,
43 'validator': frontend
.validate_boolean
}),
44 ('Deactivate the promotion of lone subsection titles.',
45 ['--no-section-subtitles'],
46 {'dest': 'sectsubtitle_xform', 'action': 'store_false'}),
49 config_section
= 'standalone reader'
50 config_section_dependencies
= ('readers',)
52 def get_transforms(self
):
53 return readers
.Reader
.get_transforms(self
) + [
54 references
.Substitutions
,
55 references
.PropagateTargets
,
57 frontmatter
.SectionSubTitle
,
59 references
.AnonymousHyperlinks
,
60 references
.IndirectHyperlinks
,
62 references
.ExternalTargets
,
63 references
.InternalTargets
,
64 references
.DanglingReferences
,