tags in "simple" lists: list items
- contain either a single paragraph, a nested simple list, or a
- paragraph followed by a nested simple list. This means that
- this list can be compact:
-
- - Item 1.
- - Item 2.
-
- But this list cannot be compact:
-
- - Item 1.
-
- This second paragraph forces space between list items.
-
- - Item 2.
-
- - In non-list contexts, omit
tags on a paragraph if that
- paragraph is the only child of its parent (footnotes & citations
- are allowed a label first).
-
- - Regardless of the above, in definitions, table cells, field bodies,
- option descriptions, and list items, mark the first child with
- 'class="first"' and the last child with 'class="last"'. The stylesheet
- sets the margins (top & bottom respectively) to 0 for these elements.
-
- The ``no_compact_lists`` setting (``--no-compact-lists`` command-line
- option) disables list whitespace optimization.
- """
-
- # The following definitions are required for display in browsers limited
- # to CSS1 or backwards compatible behaviour of the writer:
-
- doctype = (
- '\n')
-
- content_type = ('\n')
- content_type_mathml = ('\n')
-
- # encode also non-breaking space
- special_characters = _html_base.HTMLTranslator.special_characters.copy()
- special_characters[0xa0] = ' '
-
- # use character reference for dash (not valid in HTML5)
- attribution_formats = {'dash': ('—', ''),
- 'parentheses': ('(', ')'),
- 'parens': ('(', ')'),
- 'none': ('', '')}
-
- # ersatz for first/last pseudo-classes missing in CSS1
- def set_first_last(self, node):
- self.set_class_on_child(node, 'first', 0)
- self.set_class_on_child(node, 'last', -1)
-
- # add newline after opening tag
- def visit_address(self, node):
- self.visit_docinfo_item(node, 'address', meta=False)
- self.body.append(self.starttag(node, 'pre', CLASS='address'))
-
- def depart_address(self, node):
- self.body.append('\n\n')
- self.depart_docinfo_item()
-
- # ersatz for first/last pseudo-classes
- def visit_admonition(self, node):
- node['classes'].insert(0, 'admonition')
- self.body.append(self.starttag(node, 'div'))
- self.set_first_last(node)
-
- def depart_admonition(self, node=None):
- self.body.append('\n')
-
- # author, authors: use
instead of paragraphs
- def visit_author(self, node):
- if isinstance(node.parent, nodes.authors):
- if self.author_in_authors:
- self.body.append('\n
')
- else:
- self.visit_docinfo_item(node, 'author')
-
- def depart_author(self, node):
- if isinstance(node.parent, nodes.authors):
- self.author_in_authors = True
- else:
- self.depart_docinfo_item()
-
- def visit_authors(self, node):
- self.visit_docinfo_item(node, 'authors')
- self.author_in_authors = False # initialize
-
- def depart_authors(self, node):
- self.depart_docinfo_item()
-
- # use "width" argument instead of "style: 'width'":
- def visit_colspec(self, node):
- self.colspecs.append(node)
- # "stubs" list is an attribute of the tgroup element:
- node.parent.stubs.append(node.attributes.get('stub'))
-
- def depart_colspec(self, node):
- # write out