|
From: <mi...@us...> - 2022-06-19 14:01:06
|
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.
|