Menu
▾
▴
[Docutils-checkins] SF.net SVN: docutils:[8759] trunk/docutils
|
From: <mi...@us...> - 2021-05-27 15:06:55
|
Revision: 8759
http://sourceforge.net/p/docutils/code/8759
Author: milde
Date: 2021-05-27 15:06:51 +0000 (Thu, 27 May 2021)
Log Message:
-----------
Minor documentation update.
Modified Paths:
--------------
trunk/docutils/FAQ.txt
trunk/docutils/docs/user/config.txt
trunk/docutils/docutils/writers/_html_base.py
Modified: trunk/docutils/FAQ.txt
===================================================================
--- trunk/docutils/FAQ.txt 2021-05-27 15:06:37 UTC (rev 8758)
+++ trunk/docutils/FAQ.txt 2021-05-27 15:06:51 UTC (rev 8759)
@@ -983,10 +983,22 @@
.. note:: For the html5 writer, `initial_header_level`_ defaults to
``2`` because this is what the `HTML5 standard`__ expects as
start value for headings nested in <section> elements.
+
+ .. Sectioning content elements are always considered subsections of
+ their nearest ancestor *sectioning root* [#]_ or their nearest
+ ancestor element of *sectioning content* [#]_, whichever is nearest,
+ [...]
+
+ .. [#] <blockquote>, <body>, <details>, <dialog>, <fieldset>,
+ <figure>, <td>
+ .. [#] <article>, <aside>, <nav>, <section>
+
+ I.e., a top-level <section> is a subsection of <body>.
__ https://www.w3.org/TR/html53/sections.html#headings-and-sections
+
How are lists formatted in HTML?
--------------------------------
Modified: trunk/docutils/docs/user/config.txt
===================================================================
--- trunk/docutils/docs/user/config.txt 2021-05-27 15:06:37 UTC (rev 8758)
+++ trunk/docutils/docs/user/config.txt 2021-05-27 15:06:51 UTC (rev 8759)
@@ -1106,7 +1106,7 @@
"align" (or other equation-aligning) environment. (C++)
LaTeXML_
- Comprehensive macro support but very slow. (Perl)
+ Comprehensive macro support but *very* slow. (Perl)
TtM_
No "matrix", "align" and "cases" environments. Support may be removed.
Modified: trunk/docutils/docutils/writers/_html_base.py
===================================================================
--- trunk/docutils/docutils/writers/_html_base.py 2021-05-27 15:06:37 UTC (rev 8758)
+++ trunk/docutils/docutils/writers/_html_base.py 2021-05-27 15:06:51 UTC (rev 8759)
@@ -880,7 +880,7 @@
def visit_field_list(self, node):
atts = {}
- classes = node.setdefault('classes', [])
+ classes = node.setdefault('classes', [])
for i, cls in enumerate(classes):
if cls.startswith('field-indent-'):
try:
@@ -1628,9 +1628,11 @@
if isinstance(node.parent, nodes.topic):
self.body.append(
self.starttag(node, 'p', '', CLASS='topic-title'))
+ # TODO: use role="heading" or <h1>? (HTML5 only)
elif isinstance(node.parent, nodes.sidebar):
self.body.append(
self.starttag(node, 'p', '', CLASS='sidebar-title'))
+ # TODO: use role="heading" or <h1>? (HTML5 only)
elif isinstance(node.parent, nodes.Admonition):
self.body.append(
self.starttag(node, 'p', '', CLASS='admonition-title'))
@@ -1645,6 +1647,8 @@
else:
assert isinstance(node.parent, nodes.section)
h_level = self.section_level + self.initial_header_level - 1
+ # TODO: use '<h6 aria-level="%s">' % h_level
+ # for h_level > 6 (HTML5 only)
atts = {}
if (len(node.parent) >= 2 and
isinstance(node.parent[1], nodes.subtitle)):
This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.
|
