class documentation

class Writer(writers.UnfilteredWriter): (source)

View In Hierarchy

Undocumented

Method translate Do final translation of self.document into self.output. Called from write. Override in subclasses.
Class Variable config​_section The name of the config file section specific to this component (lowercase, no brackets). Override in subclasses.
Class Variable config​_section​_dependencies A list of names of config file sections that are to be applied before config_section, in order (from general to specific). In other words, the settings in config_section are to be overlaid on top of the settings from these sections. The "general" section is assumed implicitly. Override in subclasses.
Class Variable supported Formats this writer supports.

Inherited from UnfilteredWriter:

Method get​_transforms Transforms required by this class. Override in subclasses.

Inherited from Writer (via UnfilteredWriter):

Method __init__ Undocumented
Method assemble​_parts Assemble the self.parts dictionary. Extend in subclasses.
Method write Process a document into its final form.
Class Variable component​_type Name of the component type ('reader', 'parser', 'writer'). Override in subclasses.
Class Variable output Final translated form of document (Unicode string for text, binary string for other forms); set by translate.
Instance Variable destination docutils.io Output object; where to write the document. Set by write.
Instance Variable document The document to write (Docutils doctree); set by write.
Instance Variable language Language module for the document; set by write.
Instance Variable parts Mapping of document part names to fragments of self.output. Values are Unicode strings; encoding is up to the client. The 'whole' key should contain the entire document output.

Inherited from Component (via UnfilteredWriter, Writer):

Method supports Is format supported by this component?

Inherited from SettingsSpec (via UnfilteredWriter, Writer, Component):

Class Variable relative​_path​_settings Settings containing filesystem paths. Override in subclasses. Settings listed here are to be interpreted relative to the current working directory.
Class Variable settings​_default​_overrides A dictionary of auxiliary defaults, to override defaults for settings defined in other components. Override in subclasses.
Class Variable settings​_defaults A dictionary of defaults for settings not in settings_spec (internal settings, intended to be inaccessible by command-line and config file). Override in subclasses.
Class Variable settings​_spec Runtime settings specification. Override in subclasses.

Inherited from TransformSpec (via UnfilteredWriter, Writer, Component):

Class Variable default​_transforms Undocumented
Class Variable unknown​_reference​_resolvers No summary
def translate(self): (source)

Do final translation of self.document into self.output. Called from write. Override in subclasses.

Usually done with a docutils.nodes.NodeVisitor subclass, in combination with a call to docutils.nodes.Node.walk() or docutils.nodes.Node.walkabout(). The NodeVisitor subclass must support all standard elements (listed in docutils.nodes.node_class_names) and possibly non-standard elements used by the current Reader as well.

config_section: str = (source)
The name of the config file section specific to this component (lowercase, no brackets). Override in subclasses.
config_section_dependencies: tuple[str, ...] = (source)
A list of names of config file sections that are to be applied before config_section, in order (from general to specific). In other words, the settings in config_section are to be overlaid on top of the settings from these sections. The "general" section is assumed implicitly. Override in subclasses.
supported: tuple[str, ...] = (source)
Formats this writer supports.