diff options
| author | milde <milde@929543f6-e4f2-0310-98a6-ba3bd3dd1d04> | 2021-06-25 20:56:23 +0000 |
|---|---|---|
| committer | milde <milde@929543f6-e4f2-0310-98a6-ba3bd3dd1d04> | 2021-06-25 20:56:23 +0000 |
| commit | 12b5c07335625e59415f7cc167832cc78d5996ed (patch) | |
| tree | def9ee6fdc949efb6d2f62bb456dba21c6521c13 /docutils/docs | |
| parent | e400a59eee150af30ba8d4eda7d14656b92c4cc1 (diff) | |
| download | docutils-12b5c07335625e59415f7cc167832cc78d5996ed.tar.gz | |
HTML5: small fixes, preparation for footnote handling refactoring.
git-svn-id: https://svn.code.sf.net/p/docutils/code/trunk@8772 929543f6-e4f2-0310-98a6-ba3bd3dd1d04
Diffstat (limited to 'docutils/docs')
| -rw-r--r-- | docutils/docs/ref/doctree.txt | 23 | ||||
| -rw-r--r-- | docutils/docs/user/config.txt | 1 |
2 files changed, 17 insertions, 7 deletions
diff --git a/docutils/docs/ref/doctree.txt b/docutils/docs/ref/doctree.txt index 3d04ff57d..5deae0c02 100644 --- a/docutils/docs/ref/doctree.txt +++ b/docutils/docs/ref/doctree.txt @@ -2379,16 +2379,27 @@ Details ``footnote`` is similar to the `DocBook "footnote"`_ element but does not create a footnote_reference_. - There is `no equivalent in HTML`__. The ARIA_ role `"note"`__, or the - DPub-ARIA role `"doc-footnote"`__ may be used semantically represent - footnotes in HTML. As the spatial positioning is not determined, - the corresponding `epub:type`__ is the deprecated "note" (rather - than "footnote" or "endnote"). + There is `no equivalent in HTML`__. The ARIA role `"note"`__ may be + used to mark an `<aside> or <section> element`__ as "a section whose + content is parenthetic or ancillary to the main content of the + resource". + + ``footnote`` elements can be used for both, + + * notes that occur within the body of the document (`epub:type`__ + *footnote* or DPub-ARIA role `"doc-footnote"`__) or + + * collections of notes that occur at the end of a section or the + document (`epub:type` *endnote*,DPub-ARIA role + `"doc-endnotes"`__). + __ https://www.w3.org/TR/html51/common-idioms-without-dedicated-elements.html#footnotes __ 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://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-endnotes :Processing: A ``footnote`` element should be set off from the rest of the diff --git a/docutils/docs/user/config.txt b/docutils/docs/user/config.txt index f43b859ce..4a0299aba 100644 --- a/docutils/docs/user/config.txt +++ b/docutils/docs/user/config.txt @@ -215,7 +215,6 @@ Option: ``--auto-id-prefix`` (hidden, intended mainly for programmatic use). .. _identifier normalization: ../ref/rst/directives.html#identifier-normalization -__ ../../RELEASE-NOTES.html#future-changes datestamp --------- |