[Docutils-checkins] SF.net SVN: docutils:[8623] trunk/docutils

[<mi...@us...>]

Revision: 8623
          http://sourceforge.net/p/docutils/code/8623
Author:   milde
Date:     2021-02-13 12:00:58 +0000 (Sat, 13 Feb 2021)
Log Message:
-----------
Update planned changes for HTML5 writer.

Modified Paths:
--------------
    trunk/docutils/RELEASE-NOTES.txt
    trunk/docutils/docutils/writers/_html_base.py

Modified: trunk/docutils/RELEASE-NOTES.txt
===================================================================
--- trunk/docutils/RELEASE-NOTES.txt	2021-02-13 12:00:39 UTC (rev 8622)
+++ trunk/docutils/RELEASE-NOTES.txt	2021-02-13 12:00:58 UTC (rev 8623)
@@ -26,7 +26,9 @@
     and/or ``\DUtitle`` or set to "True".
 
 * `html5` writer:
-    Use <blockquote> instead of <div> tags for topics and admonitions.
+    Use <blockquote> instead of <div> tags for topics and admonitions,
+    <aside> instad of <dl> for footnote text and citations,
+    and <nav> instead of <div> for the Table of Contents.
 
     Use <summary> and <details> tags for term and definition of a
     definition list with class value "details".

Modified: trunk/docutils/docutils/writers/_html_base.py
===================================================================
--- trunk/docutils/docutils/writers/_html_base.py	2021-02-13 12:00:39 UTC (rev 8622)
+++ trunk/docutils/docutils/writers/_html_base.py	2021-02-13 12:00:58 UTC (rev 8623)
@@ -543,6 +543,7 @@
     def visit_citation(self, node):
         # Use definition list for bibliographic references.
         # Join adjacent citation entries.
+        # TODO: use <aside>.
         if not self.in_footnote_list:
             listnode = node.copy()
             listnode['ids'] = []
@@ -855,7 +856,9 @@
         self.body_suffix[:0] = footer
         del self.body[start:]
 
-    # TODO: use the new HTML5 element <aside>? (Also for footnote text)
+    # TODO: use the new HTML5 element <aside> for footnote text
+    # (allows better styling with CSS, the current <dl> list styling
+    # with "float" interferes with sidebars).
     def visit_footnote(self, node):
         if not self.in_footnote_list:
             listnode = node.copy()

This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.