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

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

Revision: 9080
          http://sourceforge.net/p/docutils/code/9080
Author:   milde
Date:     2022-06-19 14:01:03 +0000 (Sun, 19 Jun 2022)
Log Message:
-----------
Announce use of dpub-ARIA role "doc-footnote"

instead of ARIA role "note" for footnotes in Docutils 0.20.

Cf. [bugs:#450].

Modified Paths:
--------------
    trunk/docutils/RELEASE-NOTES.txt
    trunk/docutils/docs/ref/doctree.txt

Modified: trunk/docutils/RELEASE-NOTES.txt
===================================================================
--- trunk/docutils/RELEASE-NOTES.txt	2022-06-19 14:00:56 UTC (rev 9079)
+++ trunk/docutils/RELEASE-NOTES.txt	2022-06-19 14:01:03 UTC (rev 9080)
@@ -36,11 +36,9 @@
     ``[role="doc-noteref"]`` instead of ``.footnote-reference``
     (see minimal.css for examples).
 
-  - Remove option ``--embed-images`` (obsoleted by "image_loading_")
-    in Docutils 2.0.
+  - Use dpub-ARIA role "doc-footnote" (instead of ARIA role "note")
+    for footnotes in Docutils 0.20.
 
-    .. _image_loading: docs/user/config.html#image-loading
-
   - Move attribution behind the blockquote to comply with the `"living
     standard"`__. (HTML5__ allows <cite> elements inside a blockquote.)
 
@@ -48,6 +46,11 @@
     __ https://www.w3.org/TR/2014/REC-html5-20141028/grouping-content.html
        #the-blockquote-element
 
+  - Remove option ``--embed-images`` (obsoleted by "image_loading_")
+    in Docutils 2.0.
+
+    .. _image_loading: docs/user/config.html#image-loading
+
 * `latex2e` writer:
 
   - Change default of use_latex_citations_ setting to True
@@ -58,7 +61,7 @@
 
   - Remove ``use_verbatim_when_possible`` setting
     (use literal_block_env_: verbatim) in Docutils 2.0.
-    
+
   - Do not insert ``\usepackage[utf8]{inputenc}`` into UTF-8 encoded
     LaTeX sources. UTF-8 is the default encoding for LaTeX2e since 2018.
 

Modified: trunk/docutils/docs/ref/doctree.txt
===================================================================
--- trunk/docutils/docs/ref/doctree.txt	2022-06-19 14:00:56 UTC (rev 9079)
+++ trunk/docutils/docs/ref/doctree.txt	2022-06-19 14:01:03 UTC (rev 9080)
@@ -2263,23 +2263,25 @@
 
     The `DocBook "footnote"`_ element combines features of ``footnote``
     and footnote_reference_.
+    
+    The DPub ARIA role `"doc-footnote"`__ may be used to mark a (conforming__)
+    `HTML emulation`__ as "ancillary information, such as a citation or
+    commentary, that provides additional context to a referenced passage
+    of text".
 
-    The `ARIA role "note"`__ may be used to mark a (conforming__)
-    `HTML emulation`__ as "a section whose content is parenthetic or
-    ancillary to the main content of the resource".
+    For collections of notes that occur at the end of a section, the
+    the DPub ARIA role `"doc-endnotes"`__ is more appropriate.
 
-    Depending on the note's position, the `epub:type`__ *footnote* or
-    *endnote* and the DPub ARIA role `"doc-footnote"`__ or
-    `"doc-endnote"`__ may be applicable.
+    The corresponding types in the `EPUB 3 Structural Semantics
+    Vocabulary`__ are "footnote" and "endnote".
 
     .. _DocBook "footnote": https://tdg.docbook.org/tdg/5.1/footnote.html
-    __ https://www.w3.org/TR/wai-aria-1.1/#note
+    __ https://www.w3.org/TR/dpub-aria-1.0/#doc-footnote
     __ https://www.w3.org/TR/html-aria/#docconformance
     __ https://www.w3.org/TR/html51/
        common-idioms-without-dedicated-elements.html#footnotes
-    __ https://idpf.github.io/epub-vocabs/structure/#notes
-    __ https://www.w3.org/TR/dpub-aria-1.0/#doc-footnote
-    __ https://www.w3.org/TR/dpub-aria-1.0/#doc-endnote
+    __ https://www.w3.org/TR/dpub-aria-1.0/#doc-endnotes
+    __ https://www.w3.org/TR/epub-ssv-11/#notes
 
 :Processing:
     A ``footnote`` element should be set off from the rest of the

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