docutils.writers._html_base.Writer

class documentation

class Writer(writers.Writer): (source)

Known subclasses: docutils.writers.html4css1.Writer, docutils.writers.html5_polyglot.Writer

View In Hierarchy

Undocumented

Method apply​_template Undocumented
Method assemble​_parts Assemble the self.parts dictionary. Extend in subclasses.
Method get​_transforms Transforms required by this class. Override in subclasses.
Method interpolation​_dict Undocumented
Method translate Do final translation of self.document into self.output. Called from write. 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 default​_template Undocumented
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 supported Formats this writer supports.
Class Variable visitor​_attributes Undocumented
Instance Variable output Final translated form of document (Unicode string for text, binary string for other forms); set by translate.
Instance Variable visitor Undocumented

Inherited from Writer:

Method __init__ Undocumented
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 config​_section The name of the config file section specific to this component (lowercase, no brackets). Override in subclasses.
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 Writer):

Method supports Is format supported by this component?

Inherited from SettingsSpec (via 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​_spec Runtime settings specification. Override in subclasses.

Inherited from TransformSpec (via Writer, Component):

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

Undocumented

def assemble_parts(self): (source)
overrides docutils.writers.Writer.assemble_parts
overridden in docutils.writers.pep_html.Writer
Assemble the self.parts dictionary. Extend in subclasses.
def get_transforms(self): (source)
overrides docutils.writers.Writer.get_transforms
Transforms required by this class. Override in subclasses.
def interpolation_dict(self): (source)
overridden in docutils.writers.pep_html.Writer

Undocumented

def translate(self): (source)
overrides docutils.writers.Writer.translate

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_dependencies: tuple[str, ...] = (source)
overrides docutils.SettingsSpec.config_section_dependencies
overridden in docutils.writers.pep_html.Writer, docutils.writers.s5_html.Writer
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.
default_template: str = (source)
overridden in docutils.writers.html4css1.Writer, docutils.writers.html5_polyglot.Writer

Undocumented

settings_defaults: dict[str, str] = (source)
overrides docutils.SettingsSpec.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.
supported: tuple[str, ...] = (source)
overrides docutils.Component.supported
overridden in docutils.writers.html4css1.Writer, docutils.writers.html5_polyglot.Writer
Formats this writer supports.
visitor_attributes: tuple[str, ...] = (source)

Undocumented

output = (source)
overrides docutils.writers.Writer.output
Final translated form of document (Unicode string for text, binary string for other forms); set by translate.
visitor = (source)

Undocumented