class HTMLTranslator(nodes.NodeVisitor): (source)
Known subclasses: docutils.writers.html4css1.HTMLTranslator
, docutils.writers.html5_polyglot.HTMLTranslator
Generic Docutils to HTML translator. See the `html4css1` and `html5_polyglot` writers for full featured HTML writers. .. IMPORTANT:: The `visit_*` and `depart_*` methods use a heterogeneous stack, `self.context`. When subclassing, make sure to be consistent in its use! Examples for robust coding: a) Override both `visit_*` and `depart_*` methods, don't call the parent functions. b) Extend both and unconditionally call the parent functions:: def visit_example(self, node): if foo: self.body.append('<div class="foo">') html4css1.HTMLTranslator.visit_example(self, node) def depart_example(self, node): html4css1.HTMLTranslator.depart_example(self, node) if foo: self.body.append('</div>') c) Extend both, calling the parent functions under the same conditions:: def visit_example(self, node): if foo: self.body.append('<div class="foo"> ') else: # call the parent method _html_base.HTMLTranslator.visit_example(self, node) def depart_example(self, node): if foo: self.body.append('</div> ') else: # call the parent method _html_base.HTMLTranslator.depart_example(self, node) d) Extend one method (call the parent), but don't otherwise use the `self.context` stack:: def depart_example(self, node): _html_base.HTMLTranslator.depart_example(self, node) if foo: # implementation-specific code # that does not use `self.context` self.body.append('</div> ') This way, changes in stack use will not bite you.
Method | __init__ |
Undocumented |
Method | add |
Undocumented |
Method | astext |
Undocumented |
Method | attval |
Cleanse, HTML encode, and return attribute value text. |
Method | check |
Check for a simple list that can be rendered compactly. |
Method | cloak |
Try to hide the link text of a email link from harversters. |
Method | cloak |
Try to hide a mailto: URL from harvesters. |
Method | depart |
Undocumented |
Method | depart |
Undocumented |
Method | depart |
Undocumented |
Method | depart |
Undocumented |
Method | depart |
Undocumented |
Method | depart |
Undocumented |
Method | depart |
Undocumented |
Method | depart |
Undocumented |
Method | depart |
Undocumented |
Method | depart |
Undocumented |
Method | depart |
Undocumented |
Method | depart |
Undocumented |
Method | depart |
Undocumented |
Method | depart |
Undocumented |
Method | depart |
Undocumented |
Method | depart |
Undocumented |
Method | depart |
Undocumented |
Method | depart |
Undocumented |
Method | depart |
Undocumented |
Method | depart |
Undocumented |
Method | depart |
Undocumented |
Method | depart |
Undocumented |
Method | depart |
Undocumented |
Method | depart |
Undocumented |
Method | depart |
Undocumented |
Method | depart |
Undocumented |
Method | depart |
Undocumented |
Method | depart |
Undocumented |
Method | depart |
Undocumented |
Method | depart |
Undocumented |
Method | depart |
Undocumented |
Method | depart |
Undocumented |
Method | depart |
Undocumented |
Method | depart |
Undocumented |
Method | depart |
Undocumented |
Method | depart |
Undocumented |
Method | depart |
Undocumented |
Method | depart |
Undocumented |
Method | depart |
Undocumented |
Method | depart |
Undocumented |
Method | depart |
Undocumented |
Method | depart |
Undocumented |
Method | depart |
Undocumented |
Method | depart |
Undocumented |
Method | depart |
Undocumented |
Method | depart |
Undocumented |
Method | depart |
Undocumented |
Method | depart |
Undocumented |
Method | depart |
Undocumented |
Method | depart |
Undocumented |
Method | depart |
Undocumented |
Method | depart |
Undocumented |
Method | depart |
Undocumented |
Method | depart |
Undocumented |
Method | depart |
Undocumented |
Method | depart |
Undocumented |
Method | depart |
Undocumented |
Method | depart |
Undocumented |
Method | depart |
Undocumented |
Method | depart |
Undocumented |
Method | depart |
Undocumented |
Method | depart |
Undocumented |
Method | depart |
Undocumented |
Method | depart |
Undocumented |
Method | depart |
Undocumented |
Method | depart |
Undocumented |
Method | depart |
Undocumented |
Method | depart |
Undocumented |
Method | depart |
Undocumented |
Method | depart |
Undocumented |
Method | depart |
Undocumented |
Method | depart |
Undocumented |
Method | depart |
Undocumented |
Method | depart |
Undocumented |
Method | depart |
Undocumented |
Method | depart |
Undocumented |
Method | depart |
Undocumented |
Method | depart |
Undocumented |
Method | depart_ |
Undocumented |
Method | depart |
Undocumented |
Method | depart |
Undocumented |
Method | depart |
Undocumented |
Method | depart |
Undocumented |
Method | depart |
Undocumented |
Method | depart |
Undocumented |
Method | depart |
Undocumented |
Method | emptytag |
Construct and return an XML-compatible empty tag. |
Method | encode |
Encode special characters in `text` & return. |
Method | is |
Undocumented |
Method | section |
Undocumented |
Method | set |
Set class `class_` on the visible child no. index of `node`. Do nothing if node has fewer children than `index`. |
Method | starttag |
Construct and return a start tag given a node (id & class attributes are extracted), tag name, and optional attributes. |
Method | stylesheet |
Return code to reference or embed stylesheet file `path` |
Method | unimplemented |
Undocumented |
Method | visit |
Undocumented |
Method | visit |
Undocumented |
Method | visit |
Undocumented |
Method | visit |
Undocumented |
Method | visit |
Undocumented |
Method | visit |
Undocumented |
Method | visit |
Undocumented |
Method | visit |
Undocumented |
Method | visit |
Undocumented |
Method | visit |
Undocumented |
Method | visit |
Undocumented |
Method | visit |
Undocumented |
Method | visit |
Undocumented |
Method | visit |
Undocumented |
Method | visit |
Escape double-dashes in comment text. |
Method | visit |
Undocumented |
Method | visit |
Undocumented |
Method | visit |
Undocumented |
Method | visit |
Undocumented |
Method | visit |
Undocumented |
Method | visit |
Undocumented |
Method | visit |
Undocumented |
Method | visit |
Undocumented |
Method | visit |
Undocumented |
Method | visit |
Undocumented |
Method | visit |
Undocumented |
Method | visit |
Undocumented |
Method | visit |
Undocumented |
Method | visit |
Undocumented |
Method | visit |
Undocumented |
Method | visit |
Undocumented |
Method | visit |
Undocumented |
Method | visit |
Undocumented |
Method | visit |
Undocumented |
Method | visit |
Undocumented |
Method | visit |
Undocumented |
Method | visit |
Undocumented |
Method | visit |
Undocumented |
Method | visit |
Undocumented |
Method | visit |
Undocumented |
Method | visit |
Undocumented |
Method | visit |
Undocumented |
Method | visit |
Undocumented |
Method | visit |
Undocumented |
Method | visit |
Undocumented |
Method | visit |
Undocumented |
Method | visit |
Undocumented |
Method | visit |
Undocumented |
Method | visit |
Undocumented |
Method | visit |
Undocumented |
Method | visit |
Undocumented |
Method | visit |
Undocumented |
Method | visit |
Undocumented |
Method | visit |
Undocumented |
Method | visit |
Undocumented |
Method | visit |
Undocumented |
Method | visit |
Undocumented |
Method | visit |
Undocumented |
Method | visit |
Undocumented |
Method | visit |
Undocumented |
Method | visit |
Undocumented |
Method | visit |
Undocumented |
Method | visit |
Undocumented |
Method | visit |
Undocumented |
Method | visit |
Undocumented |
Method | visit |
Undocumented |
Method | visit |
Undocumented |
Method | visit |
Undocumented |
Method | visit |
Undocumented |
Method | visit |
Undocumented |
Method | visit |
Undocumented |
Method | visit |
Undocumented |
Method | visit |
Undocumented |
Method | visit |
Internal only. |
Method | visit |
Undocumented |
Method | visit |
Undocumented |
Method | visit |
Undocumented |
Method | visit |
Undocumented |
Method | visit |
Undocumented |
Method | visit |
Undocumented |
Method | visit |
Undocumented |
Method | visit |
Undocumented |
Method | visit_ |
Undocumented |
Method | visit |
Undocumented |
Method | visit |
Undocumented |
Method | visit |
Undocumented |
Method | visit |
Undocumented |
Method | visit |
Undocumented |
Method | visit |
Undocumented |
Method | visit |
Undocumented |
Class Variable | attribution |
Undocumented |
Class Variable | content |
Undocumented |
Class Variable | doctype |
Undocumented |
Class Variable | embedded |
Undocumented |
Class Variable | generator |
Undocumented |
Class Variable | head |
Undocumented |
Class Variable | in |
Undocumented |
Class Variable | lang |
Undocumented |
Class Variable | math |
Undocumented |
Class Variable | mathjax |
Undocumented |
Class Variable | special |
Character references for characters with a special meaning in HTML. |
Class Variable | stylesheet |
Undocumented |
Class Variable | words |
Undocumented |
Class Variable | xml |
Undocumented |
Instance Variable | author |
Undocumented |
Instance Variable | body |
Undocumented |
Instance Variable | body |
Undocumented |
Instance Variable | body |
Undocumented |
Instance Variable | body |
Undocumented |
Instance Variable | colspecs |
Undocumented |
Instance Variable | compact |
Undocumented |
Instance Variable | compact |
Undocumented |
Instance Variable | compact |
Undocumented |
Instance Variable | context |
Heterogeneous stack. |
Instance Variable | docinfo |
Undocumented |
Instance Variable | footer |
Undocumented |
Instance Variable | fragment |
Undocumented |
Instance Variable | head |
Undocumented |
Instance Variable | head |
Undocumented |
Instance Variable | header |
Undocumented |
Instance Variable | html |
Undocumented |
Instance Variable | html |
Undocumented |
Instance Variable | html |
Undocumented |
Instance Variable | html |
Undocumented |
Instance Variable | html |
Undocumented |
Instance Variable | image |
Undocumented |
Instance Variable | in |
Undocumented |
Instance Variable | in |
Undocumented |
Instance Variable | in |
Undocumented |
Instance Variable | in |
Undocumented |
Instance Variable | initial |
Undocumented |
Instance Variable | language |
Undocumented |
Instance Variable | math |
Undocumented |
Instance Variable | math |
Undocumented |
Instance Variable | math |
Undocumented |
Instance Variable | mathjax |
URL of the MathJax javascript library. |
Instance Variable | meta |
Undocumented |
Instance Variable | section |
Undocumented |
Instance Variable | settings |
Undocumented |
Instance Variable | stylesheet |
Undocumented |
Instance Variable | subtitle |
Undocumented |
Instance Variable | title |
Undocumented |
Inherited from NodeVisitor
:
Method | dispatch |
Call self."``depart_`` + node class name" with `node` as parameter. If the ``depart_...`` method does not exist, call self.unknown_departure. |
Method | dispatch |
Call self."``visit_`` + node class name" with `node` as parameter. If the ``visit_...`` method does not exist, call self.unknown_visit. |
Method | unknown |
Called before exiting unknown `Node` types. |
Method | unknown |
Called when entering unknown `Node` types. |
Class Variable | optional |
Tuple containing node class names (as strings). |
Instance Variable | document |
Undocumented |
docutils.nodes.NodeVisitor.__init__
docutils.writers.s5_html.S5HTMLTranslator
Undocumented
docutils.writers.html4css1.HTMLTranslator
, docutils.writers.html5_polyglot.HTMLTranslator
Undocumented
docutils.writers.html5_polyglot.HTMLTranslator
, docutils.writers.s5_html.S5HTMLTranslator
Undocumented
docutils.writers.html5_polyglot.HTMLTranslator
, docutils.writers.s5_html.S5HTMLTranslator
Undocumented
docutils.writers.html5_polyglot.HTMLTranslator
, docutils.writers.s5_html.S5HTMLTranslator
Undocumented
docutils.writers.html4css1.HTMLTranslator
, docutils.writers.html5_polyglot.HTMLTranslator
Undocumented
docutils.writers.html4css1.HTMLTranslator
, docutils.writers.html5_polyglot.HTMLTranslator
Undocumented
docutils.writers.html4css1.HTMLTranslator
, docutils.writers.html5_polyglot.HTMLTranslator
Undocumented
docutils.writers.html4css1.HTMLTranslator
, docutils.writers.html5_polyglot.HTMLTranslator
Undocumented
Set class `class_` on the visible child no. index of `node`. Do nothing if node has fewer children than `index`.
Construct and return a start tag given a node (id & class attributes are extracted), tag name, and optional attributes.
docutils.writers.html4css1.HTMLTranslator
, docutils.writers.html5_polyglot.HTMLTranslator
Undocumented
docutils.writers.html4css1.HTMLTranslator
, docutils.writers.html5_polyglot.HTMLTranslator
Undocumented
docutils.writers.html4css1.HTMLTranslator
, docutils.writers.html5_polyglot.HTMLTranslator
Undocumented
docutils.writers.html5_polyglot.HTMLTranslator
, docutils.writers.s5_html.S5HTMLTranslator
Undocumented
docutils.writers.html4css1.HTMLTranslator
, docutils.writers.html5_polyglot.HTMLTranslator
Undocumented
docutils.writers.html4css1.HTMLTranslator
Character references for characters with a special meaning in HTML.
Heterogeneous stack. Used by visit_* and depart_* functions in conjunction with the tree traversal. Make sure that the pops correspond to the pushes.
docutils.writers.html4css1.HTMLTranslator
, docutils.writers.html5_polyglot.HTMLTranslator
Undocumented
URL of the MathJax javascript library. The MathJax library ought to be installed on the same server as the rest of the deployed site files and specified in the `math-output` setting appended to "mathjax". See `Docutils Configuration`__. __ https://docutils.sourceforge.io/docs/user/config.html#math-output The fallback tries a local MathJax installation at ``/usr/share/javascript/mathjax/MathJax.js``.