diff options
Diffstat (limited to 'docutils/test/functional')
| -rw-r--r-- | docutils/test/functional/expected/footnotes_html5.html | 123 | ||||
| -rw-r--r-- | docutils/test/functional/expected/standalone_rst_html5.html | 170 | ||||
| -rw-r--r-- | docutils/test/functional/input/footnotes.txt | 28 |
3 files changed, 212 insertions, 109 deletions
diff --git a/docutils/test/functional/expected/footnotes_html5.html b/docutils/test/functional/expected/footnotes_html5.html index c966185b0..383b26d6c 100644 --- a/docutils/test/functional/expected/footnotes_html5.html +++ b/docutils/test/functional/expected/footnotes_html5.html @@ -14,53 +14,114 @@ <p>Paragraphs may contain footnote references (manually numbered<a class="footnote-reference superscript" href="#footnote-1" id="footnote-reference-1"><span class="fn-bracket">[</span>1<span class="fn-bracket">]</span></a>, anonymous auto-numbered<a class="footnote-reference superscript" href="#footnote-2" id="footnote-reference-2"><span class="fn-bracket">[</span>3<span class="fn-bracket">]</span></a>, labeled auto-numbered<a class="footnote-reference superscript" href="#label" id="footnote-reference-3"><span class="fn-bracket">[</span>2<span class="fn-bracket">]</span></a>, or symbolic<a class="footnote-reference superscript" href="#footnote-3" id="footnote-reference-4"><span class="fn-bracket">[</span>*<span class="fn-bracket">]</span></a>) or citation references (<a class="citation-reference" href="#cit2002" id="citation-reference-1">[CIT2002]</a>, <a class="citation-reference" href="#du2015" id="citation-reference-2">[DU2015]</a>).</p> -<dl class="footnote superscript"> -<dt class="label" id="footnote-1"><span class="fn-bracket">[</span>1<span class="fn-bracket">]</span><span class="fn-backref">(<a href="#footnote-reference-1">1</a>,<a href="#footnote-reference-5">2</a>)</span></dt> -<dd><p>A footnote contains body elements, consistently indented by at +<aside class="footnote superscript" id="footnote-1" role="note"> +<span class="label"><span class="fn-bracket">[</span>1<span class="fn-bracket">]</span></span> +<span class="fn-backref">(<a href="#footnote-reference-1">1</a>,<a href="#footnote-reference-5">2</a>)</span> +<p>A footnote contains body elements, consistently indented by at least 3 spaces.</p> <p>This is the footnote's second paragraph.</p> -</dd> -<dt class="label" id="label"><span class="fn-bracket">[</span>2<span class="fn-bracket">]</span><span class="fn-backref">(<a href="#footnote-reference-3">1</a>,<a href="#footnote-reference-6">2</a>)</span></dt> -<dd><p>Footnotes may be numbered, either manually (as in<a class="footnote-reference superscript" href="#footnote-1" id="footnote-reference-5"><span class="fn-bracket">[</span>1<span class="fn-bracket">]</span></a>) or +</aside> +<aside class="footnote superscript" id="label" role="note"> +<span class="label"><span class="fn-bracket">[</span>2<span class="fn-bracket">]</span></span> +<span class="fn-backref">(<a href="#footnote-reference-3">1</a>,<a href="#footnote-reference-6">2</a>)</span> +<p>Footnotes may be numbered, either manually (as in<a class="footnote-reference superscript" href="#footnote-1" id="footnote-reference-5"><span class="fn-bracket">[</span>1<span class="fn-bracket">]</span></a>) or automatically using a "#"-prefixed label. This footnote has a label so it can be referred to from multiple places, both as a footnote reference (<a class="footnote-reference superscript" href="#label" id="footnote-reference-6"><span class="fn-bracket">[</span>2<span class="fn-bracket">]</span></a>) and as a <a class="reference internal" href="#label">hyperlink reference</a>.</p> -</dd> -<dt class="label" id="footnote-2"><a class="fn-backref" href="#footnote-reference-2"><span class="fn-bracket">[</span>3<span class="fn-bracket">]</span></a></dt> -<dd><p>This footnote is numbered automatically and anonymously using a +</aside> +<aside class="footnote superscript" id="footnote-2" role="note"> +<span class="label"><span class="fn-bracket">[</span><a class="fn-backref" href="#footnote-reference-2">3</a><span class="fn-bracket">]</span></span> +<p>This footnote is numbered automatically and anonymously using a label of "#" only.</p> <p>This is the second paragraph.</p> <p>And this is the third paragraph.</p> -</dd> -<dt class="label" id="footnote-3"><a class="fn-backref" href="#footnote-reference-4"><span class="fn-bracket">[</span>*<span class="fn-bracket">]</span></a></dt> -<dd><p>Footnotes may also use symbols, specified with a "*" label. +</aside> +<aside class="footnote superscript" id="footnote-3" role="note"> +<span class="label"><span class="fn-bracket">[</span><a class="fn-backref" href="#footnote-reference-4">*</a><span class="fn-bracket">]</span></span> +<p>Footnotes may also use symbols, specified with a "*" label. Here's a reference to the next footnote:<a class="footnote-reference superscript" href="#footnote-4" id="footnote-reference-7"><span class="fn-bracket">[</span>†<span class="fn-bracket">]</span></a>.</p> -</dd> -<dt class="label" id="footnote-4"><a class="fn-backref" href="#footnote-reference-7"><span class="fn-bracket">[</span>†<span class="fn-bracket">]</span></a></dt> -<dd><p>This footnote shows the next symbol in the sequence.</p> -</dd> -<dt class="label" id="footnote-5"><span class="fn-bracket">[</span>4<span class="fn-bracket">]</span></dt> -<dd><p>Here's an unreferenced footnote, with a reference to a +</aside> +<aside class="footnote superscript" id="footnote-4" role="note"> +<span class="label"><span class="fn-bracket">[</span><a class="fn-backref" href="#footnote-reference-7">†</a><span class="fn-bracket">]</span></span> +<p>This footnote shows the next symbol in the sequence.</p> +</aside> +<aside class="footnote superscript" id="footnote-5" role="note"> +<span class="label"><span class="fn-bracket">[</span>4<span class="fn-bracket">]</span></span> +<p>Here's an unreferenced footnote, with a reference to a nonexistent footnote:<a class="footnote-reference superscript" href="#footnote-6" id="footnote-reference-8"><span class="fn-bracket">[</span>5<span class="fn-bracket">]</span></a>.</p> -</dd> -</dl> +</aside> <section id="citations"> <h2>Citations</h2> -<dl class="citation"> -<dt class="label" id="cit2002"><span class="fn-bracket">[</span>CIT2002<span class="fn-bracket">]</span><span class="fn-backref">(<a href="#citation-reference-1">1</a>,<a href="#citation-reference-3">2</a>)</span></dt> -<dd><p>Citations are text-labeled footnotes. They may be +<aside class="citation" id="cit2002" role="note"> +<span class="label"><span class="fn-bracket">[</span>CIT2002<span class="fn-bracket">]</span></span> +<span class="fn-backref">(<a href="#citation-reference-1">1</a>,<a href="#citation-reference-3">2</a>)</span> +<p>Citations are text-labeled footnotes. They may be rendered separately and differently from footnotes.</p> -</dd> -<dt class="label" id="du2015"><a class="fn-backref" href="#citation-reference-2"><span class="fn-bracket">[</span>DU2015<span class="fn-bracket">]</span></a></dt> -<dd><p><cite>Example document</cite>, Hometown: 2015.</p> -</dd> -</dl> +</aside> +<aside class="citation" id="du2015" role="note"> +<span class="label"><span class="fn-bracket">[</span><a class="fn-backref" href="#citation-reference-2">DU2015</a><span class="fn-bracket">]</span></span> +<p><cite>Example document</cite>, Hometown: 2015.</p> +</aside> <p>Here's a reference to the above, <a class="citation-reference" href="#cit2002" id="citation-reference-3">[CIT2002]</a>.</p> -<dl class="footnote superscript"> -<dt class="label" id="footnote-6"><a class="fn-backref" href="#footnote-reference-8"><span class="fn-bracket">[</span>5<span class="fn-bracket">]</span></a></dt> -<dd><p>this footnote is missing in the standard example document.</p> +<aside class="footnote superscript" id="footnote-6" role="note"> +<span class="label"><span class="fn-bracket">[</span><a class="fn-backref" href="#footnote-reference-8">5</a><span class="fn-bracket">]</span></span> +<p>this footnote is missing in the standard example document.</p> +</aside> +<p>Footnotes may contain block elements like lists<a class="footnote-reference superscript" href="#list-note" id="footnote-reference-9"><span class="fn-bracket">[</span>7<span class="fn-bracket">]</span></a><a class="footnote-reference superscript" href="#footnote-7" id="footnote-reference-10"><span class="fn-bracket">[</span>6<span class="fn-bracket">]</span></a>, +admonitions<a class="footnote-reference superscript" href="#footnote-8" id="footnote-reference-11"><span class="fn-bracket">[</span>8<span class="fn-bracket">]</span></a>, or tables<a class="footnote-reference superscript" href="#footnote-9" id="footnote-reference-12"><span class="fn-bracket">[</span>9<span class="fn-bracket">]</span></a>.</p> +<aside class="footnote superscript" id="footnote-7" role="note"> +<span class="label"><span class="fn-bracket">[</span><a class="fn-backref" href="#footnote-reference-10">6</a><span class="fn-bracket">]</span></span> +<ol class="arabic simple"> +<li><p>An ordered list</p></li> +<li><p>in a footnote.</p></li> +</ol> +</aside> +<aside class="footnote superscript" id="list-note" role="note"> +<span class="label"><span class="fn-bracket">[</span>7<span class="fn-bracket">]</span></span> +<span class="fn-backref">(<a href="#footnote-reference-9">1</a>,<a href="#footnote-reference-13">2</a>)</span> +<ul class="simple"> +<li><p>An unordered list (bullet list)</p></li> +<li><p>in a footnote.</p></li> +</ul> +<p>And a trailing paragraph.</p> +</aside> +<aside class="footnote superscript" id="footnote-8" role="note"> +<span class="label"><span class="fn-bracket">[</span><a class="fn-backref" href="#footnote-reference-11">8</a><span class="fn-bracket">]</span></span> +<dl class="field-list simple"> +<dt>Field<span class="colon">:</span></dt> +<dd><p>list</p> +</dd> +<dt>with<span class="colon">:</span></dt> +<dd><p>2 items.</p> </dd> </dl> +</aside> +<aside class="footnote superscript" id="footnote-9" role="note"> +<span class="label"><span class="fn-bracket">[</span><a class="fn-backref" href="#footnote-reference-12">9</a><span class="fn-bracket">]</span></span> +<div class="admonition note"> +<p class="admonition-title">Note</p> +<p>This is a note in a note.</p> +</div> +</aside> +<aside class="footnote superscript" id="footnote-10" role="note"> +<span class="label"><span class="fn-bracket">[</span>10<span class="fn-bracket">]</span></span> +<table> +<colgroup> +<col style="width: 36%" /> +<col style="width: 64%" /> +</colgroup> +<tbody> +<tr><td><p>a</p></td> +<td><p>table</p></td> +</tr> +<tr><td><p>in a</p></td> +<td><p>footnote</p></td> +</tr> +</tbody> +</table> +</aside> +<p>This<a class="footnote-reference superscript" href="#list-note" id="footnote-reference-13"><span class="fn-bracket">[</span>7<span class="fn-bracket">]</span></a> is a second reference to the footnote containing +a bullet. list.</p> </section> </main> </body> diff --git a/docutils/test/functional/expected/standalone_rst_html5.html b/docutils/test/functional/expected/standalone_rst_html5.html index 54255a2e2..e52f614de 100644 --- a/docutils/test/functional/expected/standalone_rst_html5.html +++ b/docutils/test/functional/expected/standalone_rst_html5.html @@ -470,45 +470,51 @@ Python-specific usage examples; begun with ">>>" </section> <section id="footnotes"> <h3><a class="toc-backref" href="#toc-entry-17"><span class="sectnum">2.11</span> Footnotes</a></h3> -<dl class="footnote brackets"> -<dt class="label" id="footnote-1"><span class="fn-bracket">[</span>1<span class="fn-bracket">]</span><span class="fn-backref">(<a href="#footnote-reference-1">1</a>,<a href="#footnote-reference-5">2</a>,<a href="#footnote-reference-9">3</a>)</span></dt> -<dd><p>A footnote contains body elements, consistently indented by at +<aside class="footnote brackets" id="footnote-1" role="note"> +<span class="label"><span class="fn-bracket">[</span>1<span class="fn-bracket">]</span></span> +<span class="fn-backref">(<a href="#footnote-reference-1">1</a>,<a href="#footnote-reference-5">2</a>,<a href="#footnote-reference-9">3</a>)</span> +<p>A footnote contains body elements, consistently indented by at least 3 spaces.</p> <p>This is the footnote's second paragraph.</p> -</dd> -<dt class="label" id="label"><span class="fn-bracket">[</span>2<span class="fn-bracket">]</span><span class="fn-backref">(<a href="#footnote-reference-3">1</a>,<a href="#footnote-reference-6">2</a>)</span></dt> -<dd><p>Footnotes may be numbered, either manually (as in <a class="footnote-reference brackets" href="#footnote-1" id="footnote-reference-5"><span class="fn-bracket">[</span>1<span class="fn-bracket">]</span></a>) or +</aside> +<aside class="footnote brackets" id="label" role="note"> +<span class="label"><span class="fn-bracket">[</span>2<span class="fn-bracket">]</span></span> +<span class="fn-backref">(<a href="#footnote-reference-3">1</a>,<a href="#footnote-reference-6">2</a>)</span> +<p>Footnotes may be numbered, either manually (as in <a class="footnote-reference brackets" href="#footnote-1" id="footnote-reference-5"><span class="fn-bracket">[</span>1<span class="fn-bracket">]</span></a>) or automatically using a "#"-prefixed label. This footnote has a label so it can be referred to from multiple places, both as a footnote reference (<a class="footnote-reference brackets" href="#label" id="footnote-reference-6"><span class="fn-bracket">[</span>2<span class="fn-bracket">]</span></a>) and as a <a class="reference internal" href="#label">hyperlink reference</a>.</p> -</dd> -<dt class="label" id="footnote-2"><a class="fn-backref" href="#footnote-reference-2"><span class="fn-bracket">[</span>3<span class="fn-bracket">]</span></a></dt> -<dd><p>This footnote is numbered automatically and anonymously using a +</aside> +<aside class="footnote brackets" id="footnote-2" role="note"> +<span class="label"><span class="fn-bracket">[</span><a class="fn-backref" href="#footnote-reference-2">3</a><span class="fn-bracket">]</span></span> +<p>This footnote is numbered automatically and anonymously using a label of "#" only.</p> <p>This is the second paragraph.</p> <p>And this is the third paragraph.</p> -</dd> -<dt class="label" id="footnote-3"><a class="fn-backref" href="#footnote-reference-4"><span class="fn-bracket">[</span>*<span class="fn-bracket">]</span></a></dt> -<dd><p>Footnotes may also use symbols, specified with a "*" label. +</aside> +<aside class="footnote brackets" id="footnote-3" role="note"> +<span class="label"><span class="fn-bracket">[</span><a class="fn-backref" href="#footnote-reference-4">*</a><span class="fn-bracket">]</span></span> +<p>Footnotes may also use symbols, specified with a "*" label. Here's a reference to the next footnote: <a class="footnote-reference brackets" href="#footnote-4" id="footnote-reference-7"><span class="fn-bracket">[</span>†<span class="fn-bracket">]</span></a>.</p> -</dd> -<dt class="label" id="footnote-4"><a class="fn-backref" href="#footnote-reference-7"><span class="fn-bracket">[</span>†<span class="fn-bracket">]</span></a></dt> -<dd><p>This footnote shows the next symbol in the sequence.</p> -</dd> -<dt class="label" id="footnote-5"><span class="fn-bracket">[</span>4<span class="fn-bracket">]</span></dt> -<dd><p>Here's an unreferenced footnote, with a reference to a +</aside> +<aside class="footnote brackets" id="footnote-4" role="note"> +<span class="label"><span class="fn-bracket">[</span><a class="fn-backref" href="#footnote-reference-7">†</a><span class="fn-bracket">]</span></span> +<p>This footnote shows the next symbol in the sequence.</p> +</aside> +<aside class="footnote brackets" id="footnote-5" role="note"> +<span class="label"><span class="fn-bracket">[</span>4<span class="fn-bracket">]</span></span> +<p>Here's an unreferenced footnote, with a reference to a nonexistent footnote: <a href="#system-message-2"><span class="problematic" id="footnote-reference-8">[5]_</span></a>.</p> -</dd> -</dl> +</aside> </section> <section id="citations"> <h3><a class="toc-backref" href="#toc-entry-18"><span class="sectnum">2.12</span> Citations</a></h3> -<dl class="citation"> -<dt class="label" id="cit2002"><span class="fn-bracket">[</span>CIT2002<span class="fn-bracket">]</span><span class="fn-backref">(<a href="#citation-reference-1">1</a>,<a href="#citation-reference-2">2</a>)</span></dt> -<dd><p>Citations are text-labeled footnotes. They may be +<aside class="citation" id="cit2002" role="note"> +<span class="label"><span class="fn-bracket">[</span>CIT2002<span class="fn-bracket">]</span></span> +<span class="fn-backref">(<a href="#citation-reference-1">1</a>,<a href="#citation-reference-2">2</a>)</span> +<p>Citations are text-labeled footnotes. They may be rendered separately and differently from footnotes.</p> -</dd> -</dl> +</aside> <p>Here's a reference to the above, <a class="citation-reference" href="#cit2002" id="citation-reference-2">[CIT2002]</a>, and a <a href="#system-message-3"><span class="problematic" id="citation-reference-3">[nonexistent]_</span></a> citation.</p> </section> @@ -830,44 +836,55 @@ allowed (e.g. inside a directive).</p> </section> <section id="target-footnotes"> <h4><a class="toc-backref" href="#toc-entry-58"><span class="sectnum">2.14.6</span> Target Footnotes</a></h4> -<dl class="footnote brackets"> -<dt class="label" id="footnote-7"><span class="fn-bracket">[</span>7<span class="fn-bracket">]</span><span class="fn-backref">(<a href="#footnote-reference-18">1</a>,<a href="#footnote-reference-19">2</a>,<a href="#footnote-reference-20">3</a>,<a href="#footnote-reference-25">4</a>)</span></dt> -<dd><p><a class="reference external" href="http://www.python.org/">http://www.python.org/</a></p> -</dd> -<dt class="label" id="footnote-8"><a class="fn-backref" href="#footnote-reference-21"><span class="fn-bracket">[</span>8<span class="fn-bracket">]</span></a></dt> -<dd><p><a class="reference external" href="http://pygments.org/">http://pygments.org/</a></p> -</dd> -<dt class="label" id="footnote-9"><a class="fn-backref" href="#footnote-reference-22"><span class="fn-bracket">[</span>9<span class="fn-bracket">]</span></a></dt> -<dd><p><a class="reference external" href="http://docutils.sourceforge.net/docs/user/config.html#table-style">http://docutils.sourceforge.net/docs/user/config.html#table-style</a></p> -</dd> -<dt class="label" id="footnote-10"><a class="fn-backref" href="#footnote-reference-23"><span class="fn-bracket">[</span>10<span class="fn-bracket">]</span></a></dt> -<dd><p><a class="reference external" href="http://tug.ctan.org/tex-archive/macros/latex/contrib/booktabs/booktabs.pdf">http://tug.ctan.org/tex-archive/macros/latex/contrib/booktabs/booktabs.pdf</a></p> -</dd> -<dt class="label" id="footnote-11"><a class="fn-backref" href="#footnote-reference-24"><span class="fn-bracket">[</span>11<span class="fn-bracket">]</span></a></dt> -<dd><p><a class="reference external" href="http://docutils.sourceforge.net/docs/dev/todo.html#interpreted-text">http://docutils.sourceforge.net/docs/dev/todo.html#interpreted-text</a></p> -</dd> -<dt class="label" id="footnote-12"><a class="fn-backref" href="#footnote-reference-26"><span class="fn-bracket">[</span>12<span class="fn-bracket">]</span></a></dt> -<dd><p><a class="reference external" href="https://docutils.sourceforge.io/">https://docutils.sourceforge.io/</a></p> -</dd> -<dt class="label" id="footnote-13"><a class="fn-backref" href="#footnote-reference-27"><span class="fn-bracket">[</span>13<span class="fn-bracket">]</span></a></dt> -<dd><p><a class="reference external" href="https://docutils.sourceforge.io/docs/ref/rst/directives.html">https://docutils.sourceforge.io/docs/ref/rst/directives.html</a></p> -</dd> -<dt class="label" id="footnote-14"><a class="fn-backref" href="#footnote-reference-28"><span class="fn-bracket">[</span>14<span class="fn-bracket">]</span></a></dt> -<dd><p><a class="reference external" href="https://docutils.sourceforge.io/docs/ref/rst/directives.html#metadata">https://docutils.sourceforge.io/docs/ref/rst/directives.html#metadata</a></p> -</dd> -<dt class="label" id="footnote-15"><a class="fn-backref" href="#footnote-reference-29"><span class="fn-bracket">[</span>15<span class="fn-bracket">]</span></a></dt> -<dd><p><a class="reference external" href="https://developer.mozilla.org/en-US/docs/Web/HTML/Viewport_meta_tag">https://developer.mozilla.org/en-US/docs/Web/HTML/Viewport_meta_tag</a></p> -</dd> -<dt class="label" id="footnote-16"><a class="fn-backref" href="#footnote-reference-30"><span class="fn-bracket">[</span>16<span class="fn-bracket">]</span></a></dt> -<dd><p><a class="reference external" href="https://stackoverflow.com/questions/39547412/same-font-size-for-h1-and-h2-in-article">https://stackoverflow.com/questions/39547412/same-font-size-for-h1-and-h2-in-article</a></p> -</dd> -<dt class="label" id="footnote-17"><a class="fn-backref" href="#footnote-reference-31"><span class="fn-bracket">[</span>17<span class="fn-bracket">]</span></a></dt> -<dd><p><a class="reference external" href="https://html.spec.whatwg.org/#text-level-semantics">https://html.spec.whatwg.org/#text-level-semantics</a></p> -</dd> -<dt class="label" id="footnote-18"><a class="fn-backref" href="#footnote-reference-32"><span class="fn-bracket">[</span>18<span class="fn-bracket">]</span></a></dt> -<dd><p><a class="reference external" href="https://html.spec.whatwg.org/multipage/edits.html">https://html.spec.whatwg.org/multipage/edits.html</a></p> -</dd> -</dl> +<aside class="footnote brackets" id="footnote-7" role="note"> +<span class="label"><span class="fn-bracket">[</span>7<span class="fn-bracket">]</span></span> +<span class="fn-backref">(<a href="#footnote-reference-18">1</a>,<a href="#footnote-reference-19">2</a>,<a href="#footnote-reference-20">3</a>,<a href="#footnote-reference-25">4</a>)</span> +<p><a class="reference external" href="http://www.python.org/">http://www.python.org/</a></p> +</aside> +<aside class="footnote brackets" id="footnote-8" role="note"> +<span class="label"><span class="fn-bracket">[</span><a class="fn-backref" href="#footnote-reference-21">8</a><span class="fn-bracket">]</span></span> +<p><a class="reference external" href="http://pygments.org/">http://pygments.org/</a></p> +</aside> +<aside class="footnote brackets" id="footnote-9" role="note"> +<span class="label"><span class="fn-bracket">[</span><a class="fn-backref" href="#footnote-reference-22">9</a><span class="fn-bracket">]</span></span> +<p><a class="reference external" href="http://docutils.sourceforge.net/docs/user/config.html#table-style">http://docutils.sourceforge.net/docs/user/config.html#table-style</a></p> +</aside> +<aside class="footnote brackets" id="footnote-10" role="note"> +<span class="label"><span class="fn-bracket">[</span><a class="fn-backref" href="#footnote-reference-23">10</a><span class="fn-bracket">]</span></span> +<p><a class="reference external" href="http://tug.ctan.org/tex-archive/macros/latex/contrib/booktabs/booktabs.pdf">http://tug.ctan.org/tex-archive/macros/latex/contrib/booktabs/booktabs.pdf</a></p> +</aside> +<aside class="footnote brackets" id="footnote-11" role="note"> +<span class="label"><span class="fn-bracket">[</span><a class="fn-backref" href="#footnote-reference-24">11</a><span class="fn-bracket">]</span></span> +<p><a class="reference external" href="http://docutils.sourceforge.net/docs/dev/todo.html#interpreted-text">http://docutils.sourceforge.net/docs/dev/todo.html#interpreted-text</a></p> +</aside> +<aside class="footnote brackets" id="footnote-12" role="note"> +<span class="label"><span class="fn-bracket">[</span><a class="fn-backref" href="#footnote-reference-26">12</a><span class="fn-bracket">]</span></span> +<p><a class="reference external" href="https://docutils.sourceforge.io/">https://docutils.sourceforge.io/</a></p> +</aside> +<aside class="footnote brackets" id="footnote-13" role="note"> +<span class="label"><span class="fn-bracket">[</span><a class="fn-backref" href="#footnote-reference-27">13</a><span class="fn-bracket">]</span></span> +<p><a class="reference external" href="https://docutils.sourceforge.io/docs/ref/rst/directives.html">https://docutils.sourceforge.io/docs/ref/rst/directives.html</a></p> +</aside> +<aside class="footnote brackets" id="footnote-14" role="note"> +<span class="label"><span class="fn-bracket">[</span><a class="fn-backref" href="#footnote-reference-28">14</a><span class="fn-bracket">]</span></span> +<p><a class="reference external" href="https://docutils.sourceforge.io/docs/ref/rst/directives.html#metadata">https://docutils.sourceforge.io/docs/ref/rst/directives.html#metadata</a></p> +</aside> +<aside class="footnote brackets" id="footnote-15" role="note"> +<span class="label"><span class="fn-bracket">[</span><a class="fn-backref" href="#footnote-reference-29">15</a><span class="fn-bracket">]</span></span> +<p><a class="reference external" href="https://developer.mozilla.org/en-US/docs/Web/HTML/Viewport_meta_tag">https://developer.mozilla.org/en-US/docs/Web/HTML/Viewport_meta_tag</a></p> +</aside> +<aside class="footnote brackets" id="footnote-16" role="note"> +<span class="label"><span class="fn-bracket">[</span><a class="fn-backref" href="#footnote-reference-30">16</a><span class="fn-bracket">]</span></span> +<p><a class="reference external" href="https://stackoverflow.com/questions/39547412/same-font-size-for-h1-and-h2-in-article">https://stackoverflow.com/questions/39547412/same-font-size-for-h1-and-h2-in-article</a></p> +</aside> +<aside class="footnote brackets" id="footnote-17" role="note"> +<span class="label"><span class="fn-bracket">[</span><a class="fn-backref" href="#footnote-reference-31">17</a><span class="fn-bracket">]</span></span> +<p><a class="reference external" href="https://html.spec.whatwg.org/#text-level-semantics">https://html.spec.whatwg.org/#text-level-semantics</a></p> +</aside> +<aside class="footnote brackets" id="footnote-18" role="note"> +<span class="label"><span class="fn-bracket">[</span><a class="fn-backref" href="#footnote-reference-32">18</a><span class="fn-bracket">]</span></span> +<p><a class="reference external" href="https://html.spec.whatwg.org/multipage/edits.html">https://html.spec.whatwg.org/multipage/edits.html</a></p> +</aside> </section> <section id="replacement-text"> <h4><a class="toc-backref" href="#toc-entry-59"><span class="sectnum">2.14.7</span> Replacement Text</a></h4> @@ -1585,11 +1602,10 @@ chemicals.</p> <cite>acronymes</cite>. In HTML, the <acronym> tag is obsolete and authors are advised to use <abbr> instead. The HTML5 writer uses <abbr> for Docutil's <abbreviation> element.</p> -<dl class="footnote brackets"> -<dt class="label" id="footnote-6"><a class="fn-backref" href="#footnote-reference-11"><span class="fn-bracket">[</span>‡<span class="fn-bracket">]</span></a></dt> -<dd><p>Irish Organic Farmers and Growers Association</p> -</dd> -</dl> +<aside class="footnote brackets" id="footnote-6" role="note"> +<span class="label"><span class="fn-bracket">[</span><a class="fn-backref" href="#footnote-reference-11">‡</a><span class="fn-bracket">]</span></span> +<p>Irish Organic Farmers and Growers Association</p> +</aside> </dd> <dt>ruby, rt, rp</dt> <dd><p>Ruby annotations</p> @@ -1715,16 +1731,18 @@ a substitution.</p> </blockquote> </dd> </dl> -<dl class="footnote brackets"> -<dt class="label" id="attribute-optional"><span class="fn-bracket">[</span>5<span class="fn-bracket">]</span><span class="fn-backref">(<a href="#footnote-reference-10">1</a>,<a href="#footnote-reference-14">2</a>,<a href="#footnote-reference-16">3</a>,<a href="#footnote-reference-17">4</a>)</span></dt> -<dd><p>Would gain from support for attributes/arguments +<aside class="footnote brackets" id="attribute-optional" role="note"> +<span class="label"><span class="fn-bracket">[</span>5<span class="fn-bracket">]</span></span> +<span class="fn-backref">(<a href="#footnote-reference-10">1</a>,<a href="#footnote-reference-14">2</a>,<a href="#footnote-reference-16">3</a>,<a href="#footnote-reference-17">4</a>)</span> +<p>Would gain from support for attributes/arguments to inline roles. See <a class="reference external" href="http://docutils.sourceforge.net/docs/dev/todo.html#interpreted-text">TODO</a> <a class="footnote-reference brackets" href="#footnote-11" id="footnote-reference-24"><span class="fn-bracket">[</span>11<span class="fn-bracket">]</span></a></p> -</dd> -<dt class="label" id="attribute-required"><span class="fn-bracket">[</span>6<span class="fn-bracket">]</span><span class="fn-backref">(<a href="#footnote-reference-12">1</a>,<a href="#footnote-reference-13">2</a>,<a href="#footnote-reference-15">3</a>)</span></dt> -<dd><p>Requires support for attributes to inline +</aside> +<aside class="footnote brackets" id="attribute-required" role="note"> +<span class="label"><span class="fn-bracket">[</span>6<span class="fn-bracket">]</span></span> +<span class="fn-backref">(<a href="#footnote-reference-12">1</a>,<a href="#footnote-reference-13">2</a>,<a href="#footnote-reference-15">3</a>)</span> +<p>Requires support for attributes to inline roles to make sense.</p> -</dd> -</dl> +</aside> </section> <section id="indicating-edits"> <h3><a class="toc-backref" href="#toc-entry-51"><span class="sectnum">3.4</span> Indicating Edits</a></h3> diff --git a/docutils/test/functional/input/footnotes.txt b/docutils/test/functional/input/footnotes.txt index fd443ad59..8c4c464e7 100644 --- a/docutils/test/functional/input/footnotes.txt +++ b/docutils/test/functional/input/footnotes.txt @@ -7,11 +7,35 @@ symbolic [*]_) or citation references ([CIT2002]_, [DU2015]_). .. include:: data/standard.txt :start-after: Footnotes - --------- + --------- :end-before: Here's a reference to the above, [CIT2002]_, - + .. [DU2015] `Example document`, Hometown: 2015. Here's a reference to the above, [CIT2002]_. .. [5] this footnote is missing in the standard example document. + +Footnotes may contain block elements like lists [#list-note]_ [#]_, +admonitions [#]_, or tables [#]_. + +.. [#] #. An ordered list + #. in a footnote. + +.. [#list-note] * An unordered list (bullet list) + * in a footnote. + + And a trailing paragraph. + +.. [#] :Field: list + :with: 2 items. + +.. [#] .. note:: This is a note in a note. + +.. [#] ===== ========= + a table + in a footnote + ===== ========= + +This [#list-note]_ is a second reference to the footnote containing +a bullet. list. |