diff options
| author | milde <milde@929543f6-e4f2-0310-98a6-ba3bd3dd1d04> | 2019-11-15 10:36:15 +0000 |
|---|---|---|
| committer | milde <milde@929543f6-e4f2-0310-98a6-ba3bd3dd1d04> | 2019-11-15 10:36:15 +0000 |
| commit | 7f14a81296d7db1f6d3ca2a4e09e22e663cd893f (patch) | |
| tree | dfc8ac1fe882a12abfef93b6d1b226cd5e86bf4d /docutils/test/functional | |
| parent | eaa3c9e0fc2d2122a617b57bb52f56de97a54179 (diff) | |
| download | docutils-7f14a81296d7db1f6d3ca2a4e09e22e663cd893f.tar.gz | |
tests/functional: Set "auto_id_prefix" to "%" (expands to tag-names).
git-svn-id: http://svn.code.sf.net/p/docutils/code/trunk@8414 929543f6-e4f2-0310-98a6-ba3bd3dd1d04
Diffstat (limited to 'docutils/test/functional')
18 files changed, 700 insertions, 699 deletions
diff --git a/docutils/test/functional/expected/cyrillic.tex b/docutils/test/functional/expected/cyrillic.tex index 28a48dcc1..b03e5960f 100644 --- a/docutils/test/functional/expected/cyrillic.tex +++ b/docutils/test/functional/expected/cyrillic.tex @@ -33,7 +33,7 @@ \section{Заголовок% - \label{id1}% + \label{section-1}% } первый пример: «Здравствуй, мир!» diff --git a/docutils/test/functional/expected/footnotes_html5.html b/docutils/test/functional/expected/footnotes_html5.html index b9d5736df..ff511c417 100644 --- a/docutils/test/functional/expected/footnotes_html5.html +++ b/docutils/test/functional/expected/footnotes_html5.html @@ -11,52 +11,52 @@ <div class="document" id="test-footnote-and-citation-rendering"> <h1 class="title">Test footnote and citation rendering</h1> -<p>Paragraphs may contain footnote references (manually numbered<a class="footnote-reference superscript" href="#id7" id="id1">1</a>, anonymous auto-numbered<a class="footnote-reference superscript" href="#id11" id="id2">3</a>, labeled auto-numbered<a class="footnote-reference superscript" href="#label" id="id3">2</a>, or -symbolic<a class="footnote-reference superscript" href="#id12" id="id4">*</a>) or citation references (<a class="citation-reference" href="#cit2002" id="id5">[CIT2002]</a>, <a class="citation-reference" href="#du2015" id="id6">[DU2015]</a>).</p> +<p>Paragraphs may contain footnote references (manually numbered<a class="footnote-reference superscript" href="#footnote-1" id="footnote-reference-1">1</a>, anonymous auto-numbered<a class="footnote-reference superscript" href="#footnote-2" id="footnote-reference-2">3</a>, labeled auto-numbered<a class="footnote-reference superscript" href="#label" id="footnote-reference-3">2</a>, or +symbolic<a class="footnote-reference superscript" href="#footnote-3" id="footnote-reference-4">*</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="id7"><span class="superscript">1</span><span class="fn-backref">(<a href="#id1">1</a>,<a href="#id8">2</a>)</span></dt> +<dt class="label" id="footnote-1"><span class="superscript">1</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 least 3 spaces.</p> <p>This is the footnote's second paragraph.</p> </dd> -<dt class="label" id="label"><span class="superscript">2</span><span class="fn-backref">(<a href="#id3">1</a>,<a href="#id9">2</a>)</span></dt> -<dd><p>Footnotes may be numbered, either manually (as in<a class="footnote-reference superscript" href="#id7" id="id8">1</a>) or +<dt class="label" id="label"><span class="superscript">2</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">1</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="id9">2</a>) and as a <a class="reference internal" href="#label">hyperlink reference</a>.</p> +footnote reference (<a class="footnote-reference superscript" href="#label" id="footnote-reference-6">2</a>) and as a <a class="reference internal" href="#label">hyperlink reference</a>.</p> </dd> -<dt class="label" id="id11"><span class="superscript"><a class="fn-backref" href="#id2">3</a></span></dt> +<dt class="label" id="footnote-2"><span class="superscript"><a class="fn-backref" href="#footnote-reference-2">3</a></span></dt> <dd><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="id12"><span class="superscript"><a class="fn-backref" href="#id4">*</a></span></dt> +<dt class="label" id="footnote-3"><span class="superscript"><a class="fn-backref" href="#footnote-reference-4">*</a></span></dt> <dd><p>Footnotes may also use symbols, specified with a "*" label. -Here's a reference to the next footnote:<a class="footnote-reference superscript" href="#id14" id="id13">†</a>.</p> +Here's a reference to the next footnote:<a class="footnote-reference superscript" href="#footnote-4" id="footnote-reference-7">†</a>.</p> </dd> -<dt class="label" id="id14"><span class="superscript"><a class="fn-backref" href="#id13">†</a></span></dt> +<dt class="label" id="footnote-4"><span class="superscript"><a class="fn-backref" href="#footnote-reference-7">†</a></span></dt> <dd><p>This footnote shows the next symbol in the sequence.</p> </dd> -<dt class="label" id="id15"><span class="superscript">4</span></dt> +<dt class="label" id="footnote-5"><span class="superscript">4</span></dt> <dd><p>Here's an unreferenced footnote, with a reference to a -nonexistent footnote:<a class="footnote-reference superscript" href="#id18" id="id16">5</a>.</p> +nonexistent footnote:<a class="footnote-reference superscript" href="#footnote-6" id="footnote-reference-8">5</a>.</p> </dd> </dl> <div class="section" id="citations"> <h1>Citations</h1> <dl class="citation"> -<dt class="label" id="cit2002"><span class="brackets">CIT2002</span><span class="fn-backref">(<a href="#id5">1</a>,<a href="#id17">2</a>)</span></dt> +<dt class="label" id="cit2002"><span class="brackets">CIT2002</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 rendered separately and differently from footnotes.</p> </dd> -<dt class="label" id="du2015"><span class="brackets"><a class="fn-backref" href="#id6">DU2015</a></span></dt> +<dt class="label" id="du2015"><span class="brackets"><a class="fn-backref" href="#citation-reference-2">DU2015</a></span></dt> <dd><p><cite>Example document</cite>, Hometown: 2015.</p> </dd> </dl> -<p>Here's a reference to the above, <a class="citation-reference" href="#cit2002" id="id17">[CIT2002]</a>.</p> +<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="id18"><span class="superscript"><a class="fn-backref" href="#id16">5</a></span></dt> +<dt class="label" id="footnote-6"><span class="superscript"><a class="fn-backref" href="#footnote-reference-8">5</a></span></dt> <dd><p>this footnote is missing in the standard example document.</p> </dd> </dl> diff --git a/docutils/test/functional/expected/latex_literal_block.tex b/docutils/test/functional/expected/latex_literal_block.tex index e7934bcbe..ecab4a343 100644 --- a/docutils/test/functional/expected/latex_literal_block.tex +++ b/docutils/test/functional/expected/latex_literal_block.tex @@ -189,7 +189,7 @@ standalone~hyperlinks~(\url{http://www.python.org}),\\ % \phantomsection\label{internal}internal~hyperlink~targets,\\ images~via~substitution~references~(\includegraphics{../../../docs/user/rst/images/biohazard.png}),\\ -footnote~references\DUfootnotemark{id1}{id3}{*},\\ +footnote~references\DUfootnotemark{footnote-reference-1}{footnote-1}{*},\\ citation~references~(\hyperlink{cit2002}{[CIT2002]}),~and~more.\\ ~\\ ~~~Here~are~some~explicit~interpreted~text~roles:\\ @@ -203,7 +203,7 @@ maths~$\sin^2(x)$,\\ \DUroletitlereference{Docutils}'~\emph{standard}~\textbf{inline}~\texttt{markup}. \end{quote} % -\DUfootnotetext{id3}{id1}{*}{% +\DUfootnotetext{footnote-1}{footnote-reference-1}{*}{% This footnote is referenced in a \DUroletitlereference{parsed literal} block. It contains a literal block: diff --git a/docutils/test/functional/expected/latex_literal_block_fancyvrb.tex b/docutils/test/functional/expected/latex_literal_block_fancyvrb.tex index becfeb351..72ba00260 100644 --- a/docutils/test/functional/expected/latex_literal_block_fancyvrb.tex +++ b/docutils/test/functional/expected/latex_literal_block_fancyvrb.tex @@ -189,7 +189,7 @@ standalone~hyperlinks~(\url{http://www.python.org}),\\ % \phantomsection\label{internal}internal~hyperlink~targets,\\ images~via~substitution~references~(\includegraphics{../../../docs/user/rst/images/biohazard.png}),\\ -footnote~references\DUfootnotemark{id1}{id3}{*},\\ +footnote~references\DUfootnotemark{footnote-reference-1}{footnote-1}{*},\\ citation~references~(\hyperlink{cit2002}{[CIT2002]}),~and~more.\\ ~\\ ~~~Here~are~some~explicit~interpreted~text~roles:\\ @@ -203,7 +203,7 @@ maths~$\sin^2(x)$,\\ \DUroletitlereference{Docutils}'~\emph{standard}~\textbf{inline}~\texttt{markup}. \end{quote} % -\DUfootnotetext{id3}{id1}{*}{% +\DUfootnotetext{footnote-1}{footnote-reference-1}{*}{% This footnote is referenced in a \DUroletitlereference{parsed literal} block. It contains a literal block: diff --git a/docutils/test/functional/expected/latex_literal_block_listings.tex b/docutils/test/functional/expected/latex_literal_block_listings.tex index f461089d4..2d8fa28ab 100644 --- a/docutils/test/functional/expected/latex_literal_block_listings.tex +++ b/docutils/test/functional/expected/latex_literal_block_listings.tex @@ -194,7 +194,7 @@ standalone~hyperlinks~(\url{http://www.python.org}),\\ % \phantomsection\label{internal}internal~hyperlink~targets,\\ images~via~substitution~references~(\includegraphics{../../../docs/user/rst/images/biohazard.png}),\\ -footnote~references\DUfootnotemark{id1}{id3}{*},\\ +footnote~references\DUfootnotemark{footnote-reference-1}{footnote-1}{*},\\ citation~references~(\hyperlink{cit2002}{[CIT2002]}),~and~more.\\ ~\\ ~~~Here~are~some~explicit~interpreted~text~roles:\\ @@ -208,7 +208,7 @@ maths~$\sin^2(x)$,\\ \DUroletitlereference{Docutils}'~\emph{standard}~\textbf{inline}~\texttt{markup}. \end{quote} % -\DUfootnotetext{id3}{id1}{*}{% +\DUfootnotetext{footnote-1}{footnote-reference-1}{*}{% This footnote is referenced in a \DUroletitlereference{parsed literal} block. It contains a literal block: diff --git a/docutils/test/functional/expected/latex_literal_block_verbatim.tex b/docutils/test/functional/expected/latex_literal_block_verbatim.tex index 124da0cc4..94e50507d 100644 --- a/docutils/test/functional/expected/latex_literal_block_verbatim.tex +++ b/docutils/test/functional/expected/latex_literal_block_verbatim.tex @@ -188,7 +188,7 @@ standalone~hyperlinks~(\url{http://www.python.org}),\\ % \phantomsection\label{internal}internal~hyperlink~targets,\\ images~via~substitution~references~(\includegraphics{../../../docs/user/rst/images/biohazard.png}),\\ -footnote~references\DUfootnotemark{id1}{id3}{*},\\ +footnote~references\DUfootnotemark{footnote-reference-1}{footnote-1}{*},\\ citation~references~(\hyperlink{cit2002}{[CIT2002]}),~and~more.\\ ~\\ ~~~Here~are~some~explicit~interpreted~text~roles:\\ @@ -202,7 +202,7 @@ maths~$\sin^2(x)$,\\ \DUroletitlereference{Docutils}'~\emph{standard}~\textbf{inline}~\texttt{markup}. \end{quote} % -\DUfootnotetext{id3}{id1}{*}{% +\DUfootnotetext{footnote-1}{footnote-reference-1}{*}{% This footnote is referenced in a \DUroletitlereference{parsed literal} block. It contains a literal block: diff --git a/docutils/test/functional/expected/latex_literal_block_verbatimtab.tex b/docutils/test/functional/expected/latex_literal_block_verbatimtab.tex index e66236452..0235d3b13 100644 --- a/docutils/test/functional/expected/latex_literal_block_verbatimtab.tex +++ b/docutils/test/functional/expected/latex_literal_block_verbatimtab.tex @@ -189,7 +189,7 @@ standalone~hyperlinks~(\url{http://www.python.org}),\\ % \phantomsection\label{internal}internal~hyperlink~targets,\\ images~via~substitution~references~(\includegraphics{../../../docs/user/rst/images/biohazard.png}),\\ -footnote~references\DUfootnotemark{id1}{id3}{*},\\ +footnote~references\DUfootnotemark{footnote-reference-1}{footnote-1}{*},\\ citation~references~(\hyperlink{cit2002}{[CIT2002]}),~and~more.\\ ~\\ ~~~Here~are~some~explicit~interpreted~text~roles:\\ @@ -203,7 +203,7 @@ maths~$\sin^2(x)$,\\ \DUroletitlereference{Docutils}'~\emph{standard}~\textbf{inline}~\texttt{markup}. \end{quote} % -\DUfootnotetext{id3}{id1}{*}{% +\DUfootnotetext{footnote-1}{footnote-reference-1}{*}{% This footnote is referenced in a \DUroletitlereference{parsed literal} block. It contains a literal block: diff --git a/docutils/test/functional/expected/pep_html.html b/docutils/test/functional/expected/pep_html.html index 62767c26b..bdbb30a7f 100644 --- a/docutils/test/functional/expected/pep_html.html +++ b/docutils/test/functional/expected/pep_html.html @@ -57,32 +57,32 @@ to templates. DO NOT USE THIS HTML FILE AS YOUR TEMPLATE! <div class="contents topic" id="contents"> <p class="topic-title">Contents</p> <ul class="simple"> -<li><a class="reference internal" href="#abstract" id="id5">Abstract</a></li> -<li><a class="reference internal" href="#copyright" id="id6">Copyright</a></li> -<li><a class="reference internal" href="#references-and-footnotes" id="id7">References and Footnotes</a></li> +<li><a class="reference internal" href="#abstract" id="toc-entry-1">Abstract</a></li> +<li><a class="reference internal" href="#copyright" id="toc-entry-2">Copyright</a></li> +<li><a class="reference internal" href="#references-and-footnotes" id="toc-entry-3">References and Footnotes</a></li> </ul> </div> <div class="section" id="abstract"> -<h1><a class="toc-backref" href="#id5">Abstract</a></h1> -<p>This is just a test <a class="footnote-reference" href="#id2" id="id1">[1]</a>. See the <a class="reference external" href="http://www.python.org/peps/">PEP repository</a> <a class="footnote-reference" href="#id3" id="id4">[2]</a> for the real +<h1><a class="toc-backref" href="#toc-entry-1">Abstract</a></h1> +<p>This is just a test <a class="footnote-reference" href="#footnote-1" id="footnote-reference-1">[1]</a>. See the <a class="reference external" href="http://www.python.org/peps/">PEP repository</a> <a class="footnote-reference" href="#footnote-2" id="footnote-reference-2">[2]</a> for the real thing.</p> </div> <div class="section" id="copyright"> -<h1><a class="toc-backref" href="#id6">Copyright</a></h1> +<h1><a class="toc-backref" href="#toc-entry-2">Copyright</a></h1> <p>This document has been placed in the public domain.</p> </div> <div class="section" id="references-and-footnotes"> -<h1><a class="toc-backref" href="#id7">References and Footnotes</a></h1> -<table class="docutils footnote" frame="void" id="id2" rules="none"> +<h1><a class="toc-backref" href="#toc-entry-3">References and Footnotes</a></h1> +<table class="docutils footnote" frame="void" id="footnote-1" rules="none"> <colgroup><col class="label" /><col /></colgroup> <tbody valign="top"> -<tr><td class="label"><a class="fn-backref" href="#id1">[1]</a></td><td>PEP editors: <a class="reference external" href="mailto:peps%40python.org">peps<span>@</span>python<span>.</span>org</a></td></tr> +<tr><td class="label"><a class="fn-backref" href="#footnote-reference-1">[1]</a></td><td>PEP editors: <a class="reference external" href="mailto:peps%40python.org">peps<span>@</span>python<span>.</span>org</a></td></tr> </tbody> </table> -<table class="docutils footnote" frame="void" id="id3" rules="none"> +<table class="docutils footnote" frame="void" id="footnote-2" rules="none"> <colgroup><col class="label" /><col /></colgroup> <tbody valign="top"> -<tr><td class="label"><a class="fn-backref" href="#id4">[2]</a></td><td><a class="reference external" href="http://www.python.org/peps/">http://www.python.org/peps/</a></td></tr> +<tr><td class="label"><a class="fn-backref" href="#footnote-reference-2">[2]</a></td><td><a class="reference external" href="http://www.python.org/peps/">http://www.python.org/peps/</a></td></tr> </tbody> </table> </div> diff --git a/docutils/test/functional/expected/standalone_rst_docutils_xml.xml b/docutils/test/functional/expected/standalone_rst_docutils_xml.xml index e51866ff6..45a957565 100644 --- a/docutils/test/functional/expected/standalone_rst_docutils_xml.xml +++ b/docutils/test/functional/expected/standalone_rst_docutils_xml.xml @@ -70,151 +70,151 @@ They are transformed from section titles after parsing.</comment> <title>Table of Contents</title> <bullet_list classes="auto-toc"> <list_item> - <paragraph><reference ids="id34" refid="structural-elements"><generated classes="sectnum">1 </generated>Structural Elements</reference></paragraph> + <paragraph><reference ids="toc-entry-1" refid="structural-elements"><generated classes="sectnum">1 </generated>Structural Elements</reference></paragraph> <bullet_list classes="auto-toc"> <list_item> - <paragraph><reference ids="id35" refid="section-title"><generated classes="sectnum">1.1 </generated>Section Title</reference></paragraph> + <paragraph><reference ids="toc-entry-2" refid="section-title"><generated classes="sectnum">1.1 </generated>Section Title</reference></paragraph> </list_item> <list_item> - <paragraph><reference ids="id36" refid="empty-section"><generated classes="sectnum">1.2 </generated>Empty Section</reference></paragraph> + <paragraph><reference ids="toc-entry-3" refid="empty-section"><generated classes="sectnum">1.2 </generated>Empty Section</reference></paragraph> </list_item> <list_item> - <paragraph><reference ids="id37" refid="transitions"><generated classes="sectnum">1.3 </generated>Transitions</reference></paragraph> + <paragraph><reference ids="toc-entry-4" refid="transitions"><generated classes="sectnum">1.3 </generated>Transitions</reference></paragraph> </list_item> </bullet_list> </list_item> <list_item> - <paragraph><reference ids="id38" refid="body-elements"><generated classes="sectnum">2 </generated>Body Elements</reference></paragraph> + <paragraph><reference ids="toc-entry-5" refid="body-elements"><generated classes="sectnum">2 </generated>Body Elements</reference></paragraph> <bullet_list classes="auto-toc"> <list_item> - <paragraph><reference ids="id39" refid="paragraphs"><generated classes="sectnum">2.1 </generated>Paragraphs</reference></paragraph> + <paragraph><reference ids="toc-entry-6" refid="paragraphs"><generated classes="sectnum">2.1 </generated>Paragraphs</reference></paragraph> <bullet_list classes="auto-toc"> <list_item> - <paragraph><reference ids="id40" refid="inline-markup"><generated classes="sectnum">2.1.1 </generated>Inline Markup</reference></paragraph> + <paragraph><reference ids="toc-entry-7" refid="inline-markup"><generated classes="sectnum">2.1.1 </generated>Inline Markup</reference></paragraph> </list_item> </bullet_list> </list_item> <list_item> - <paragraph><reference ids="id41" refid="bullet-lists"><generated classes="sectnum">2.2 </generated>Bullet Lists</reference></paragraph> + <paragraph><reference ids="toc-entry-8" refid="bullet-lists"><generated classes="sectnum">2.2 </generated>Bullet Lists</reference></paragraph> </list_item> <list_item> - <paragraph><reference ids="id42" refid="enumerated-lists"><generated classes="sectnum">2.3 </generated>Enumerated Lists</reference></paragraph> + <paragraph><reference ids="toc-entry-9" refid="enumerated-lists"><generated classes="sectnum">2.3 </generated>Enumerated Lists</reference></paragraph> </list_item> <list_item> - <paragraph><reference ids="id43" refid="definition-lists"><generated classes="sectnum">2.4 </generated>Definition Lists</reference></paragraph> + <paragraph><reference ids="toc-entry-10" refid="definition-lists"><generated classes="sectnum">2.4 </generated>Definition Lists</reference></paragraph> </list_item> <list_item> - <paragraph><reference ids="id44" refid="field-lists"><generated classes="sectnum">2.5 </generated>Field Lists</reference></paragraph> + <paragraph><reference ids="toc-entry-11" refid="field-lists"><generated classes="sectnum">2.5 </generated>Field Lists</reference></paragraph> </list_item> <list_item> - <paragraph><reference ids="id45" refid="option-lists"><generated classes="sectnum">2.6 </generated>Option Lists</reference></paragraph> + <paragraph><reference ids="toc-entry-12" refid="option-lists"><generated classes="sectnum">2.6 </generated>Option Lists</reference></paragraph> </list_item> <list_item> - <paragraph><reference ids="id46" refid="literal-blocks"><generated classes="sectnum">2.7 </generated>Literal Blocks</reference></paragraph> + <paragraph><reference ids="toc-entry-13" refid="literal-blocks"><generated classes="sectnum">2.7 </generated>Literal Blocks</reference></paragraph> </list_item> <list_item> - <paragraph><reference ids="id47" refid="line-blocks"><generated classes="sectnum">2.8 </generated>Line Blocks</reference></paragraph> + <paragraph><reference ids="toc-entry-14" refid="line-blocks"><generated classes="sectnum">2.8 </generated>Line Blocks</reference></paragraph> </list_item> <list_item> - <paragraph><reference ids="id48" refid="block-quotes"><generated classes="sectnum">2.9 </generated>Block Quotes</reference></paragraph> + <paragraph><reference ids="toc-entry-15" refid="block-quotes"><generated classes="sectnum">2.9 </generated>Block Quotes</reference></paragraph> </list_item> <list_item> - <paragraph><reference ids="id49" refid="doctest-blocks"><generated classes="sectnum">2.10 </generated>Doctest Blocks</reference></paragraph> + <paragraph><reference ids="toc-entry-16" refid="doctest-blocks"><generated classes="sectnum">2.10 </generated>Doctest Blocks</reference></paragraph> </list_item> <list_item> - <paragraph><reference ids="id50" refid="footnotes"><generated classes="sectnum">2.11 </generated>Footnotes</reference></paragraph> + <paragraph><reference ids="toc-entry-17" refid="footnotes"><generated classes="sectnum">2.11 </generated>Footnotes</reference></paragraph> </list_item> <list_item> - <paragraph><reference ids="id51" refid="citations"><generated classes="sectnum">2.12 </generated>Citations</reference></paragraph> + <paragraph><reference ids="toc-entry-18" refid="citations"><generated classes="sectnum">2.12 </generated>Citations</reference></paragraph> </list_item> <list_item> - <paragraph><reference ids="id52" refid="targets"><generated classes="sectnum">2.13 </generated>Targets</reference></paragraph> + <paragraph><reference ids="toc-entry-19" refid="targets"><generated classes="sectnum">2.13 </generated>Targets</reference></paragraph> <bullet_list classes="auto-toc"> <list_item> - <paragraph><reference ids="id53" refid="duplicate-target-names"><generated classes="sectnum">2.13.1 </generated>Duplicate Target Names</reference></paragraph> + <paragraph><reference ids="toc-entry-20" refid="duplicate-target-names"><generated classes="sectnum">2.13.1 </generated>Duplicate Target Names</reference></paragraph> </list_item> <list_item> - <paragraph><reference ids="id54" refid="id21"><generated classes="sectnum">2.13.2 </generated>Duplicate Target Names</reference></paragraph> + <paragraph><reference ids="toc-entry-21" refid="duplicate-target-names-1"><generated classes="sectnum">2.13.2 </generated>Duplicate Target Names</reference></paragraph> </list_item> </bullet_list> </list_item> <list_item> - <paragraph><reference ids="id55" refid="directives"><generated classes="sectnum">2.14 </generated>Directives</reference></paragraph> + <paragraph><reference ids="toc-entry-22" refid="directives"><generated classes="sectnum">2.14 </generated>Directives</reference></paragraph> <bullet_list classes="auto-toc"> <list_item> - <paragraph><reference ids="id56" refid="document-parts"><generated classes="sectnum">2.14.1 </generated>Document Parts</reference></paragraph> + <paragraph><reference ids="toc-entry-23" refid="document-parts"><generated classes="sectnum">2.14.1 </generated>Document Parts</reference></paragraph> </list_item> <list_item> - <paragraph><reference ids="id57" refid="images-and-figures"><generated classes="sectnum">2.14.2 </generated>Images and Figures</reference></paragraph> + <paragraph><reference ids="toc-entry-24" refid="images-and-figures"><generated classes="sectnum">2.14.2 </generated>Images and Figures</reference></paragraph> </list_item> <list_item> - <paragraph><reference ids="id58" refid="admonitions"><generated classes="sectnum">2.14.3 </generated>Admonitions</reference></paragraph> + <paragraph><reference ids="toc-entry-25" refid="admonitions"><generated classes="sectnum">2.14.3 </generated>Admonitions</reference></paragraph> </list_item> <list_item> - <paragraph><reference ids="id59" refid="topics-sidebars-and-rubrics"><generated classes="sectnum">2.14.4 </generated>Topics, Sidebars, and Rubrics</reference></paragraph> + <paragraph><reference ids="toc-entry-26" refid="topics-sidebars-and-rubrics"><generated classes="sectnum">2.14.4 </generated>Topics, Sidebars, and Rubrics</reference></paragraph> </list_item> <list_item> - <paragraph><reference ids="id60" refid="target-footnotes"><generated classes="sectnum">2.14.5 </generated>Target Footnotes</reference></paragraph> + <paragraph><reference ids="toc-entry-27" refid="target-footnotes"><generated classes="sectnum">2.14.5 </generated>Target Footnotes</reference></paragraph> </list_item> <list_item> - <paragraph><reference ids="id61" refid="replacement-text"><generated classes="sectnum">2.14.6 </generated>Replacement Text</reference></paragraph> + <paragraph><reference ids="toc-entry-28" refid="replacement-text"><generated classes="sectnum">2.14.6 </generated>Replacement Text</reference></paragraph> </list_item> <list_item> - <paragraph><reference ids="id62" refid="compound-paragraph"><generated classes="sectnum">2.14.7 </generated>Compound Paragraph</reference></paragraph> + <paragraph><reference ids="toc-entry-29" refid="compound-paragraph"><generated classes="sectnum">2.14.7 </generated>Compound Paragraph</reference></paragraph> </list_item> <list_item> - <paragraph><reference ids="id63" refid="parsed-literal-blocks"><generated classes="sectnum">2.14.8 </generated>Parsed Literal Blocks</reference></paragraph> + <paragraph><reference ids="toc-entry-30" refid="parsed-literal-blocks"><generated classes="sectnum">2.14.8 </generated>Parsed Literal Blocks</reference></paragraph> </list_item> <list_item> - <paragraph><reference ids="id64" refid="code"><generated classes="sectnum">2.14.9 </generated>Code</reference></paragraph> + <paragraph><reference ids="toc-entry-31" refid="code"><generated classes="sectnum">2.14.9 </generated>Code</reference></paragraph> </list_item> </bullet_list> </list_item> <list_item> - <paragraph><reference ids="id65" refid="substitution-definitions"><generated classes="sectnum">2.15 </generated>Substitution Definitions</reference></paragraph> + <paragraph><reference ids="toc-entry-32" refid="substitution-definitions"><generated classes="sectnum">2.15 </generated>Substitution Definitions</reference></paragraph> </list_item> <list_item> - <paragraph><reference ids="id66" refid="comments"><generated classes="sectnum">2.16 </generated>Comments</reference></paragraph> + <paragraph><reference ids="toc-entry-33" refid="comments"><generated classes="sectnum">2.16 </generated>Comments</reference></paragraph> </list_item> <list_item> - <paragraph><reference ids="id67" refid="raw-text"><generated classes="sectnum">2.17 </generated>Raw text</reference></paragraph> + <paragraph><reference ids="toc-entry-34" refid="raw-text"><generated classes="sectnum">2.17 </generated>Raw text</reference></paragraph> </list_item> <list_item> - <paragraph><reference ids="id68" refid="container"><generated classes="sectnum">2.18 </generated>Container</reference></paragraph> + <paragraph><reference ids="toc-entry-35" refid="container"><generated classes="sectnum">2.18 </generated>Container</reference></paragraph> </list_item> <list_item> - <paragraph><reference ids="id69" refid="colspanning-tables"><generated classes="sectnum">2.19 </generated>Colspanning tables</reference></paragraph> + <paragraph><reference ids="toc-entry-36" refid="colspanning-tables"><generated classes="sectnum">2.19 </generated>Colspanning tables</reference></paragraph> </list_item> <list_item> - <paragraph><reference ids="id70" refid="rowspanning-tables"><generated classes="sectnum">2.20 </generated>Rowspanning tables</reference></paragraph> + <paragraph><reference ids="toc-entry-37" refid="rowspanning-tables"><generated classes="sectnum">2.20 </generated>Rowspanning tables</reference></paragraph> </list_item> <list_item> - <paragraph><reference ids="id71" refid="complex-tables"><generated classes="sectnum">2.21 </generated>Complex tables</reference></paragraph> + <paragraph><reference ids="toc-entry-38" refid="complex-tables"><generated classes="sectnum">2.21 </generated>Complex tables</reference></paragraph> </list_item> <list_item> - <paragraph><reference ids="id72" refid="list-tables"><generated classes="sectnum">2.22 </generated>List Tables</reference></paragraph> + <paragraph><reference ids="toc-entry-39" refid="list-tables"><generated classes="sectnum">2.22 </generated>List Tables</reference></paragraph> </list_item> </bullet_list> </list_item> <list_item> - <paragraph><reference ids="id73" refid="error-handling"><generated classes="sectnum">3 </generated>Error Handling</reference></paragraph> + <paragraph><reference ids="toc-entry-40" refid="error-handling"><generated classes="sectnum">3 </generated>Error Handling</reference></paragraph> </list_item> </bullet_list> </topic> <section ids="structural-elements" names="structural\ elements"> - <title auto="1" refid="id34"><generated classes="sectnum">1 </generated>Structural Elements</title> + <title auto="1" refid="toc-entry-1"><generated classes="sectnum">1 </generated>Structural Elements</title> <section ids="section-title" names="section\ title"> - <title auto="1" refid="id35"><generated classes="sectnum">1.1 </generated>Section Title</title> + <title auto="1" refid="toc-entry-2"><generated classes="sectnum">1.1 </generated>Section Title</title> <subtitle ids="section-subtitle" names="section\ subtitle">Section Subtitle</subtitle> <paragraph>Lone subsections are converted to a section subtitle by a transform activated with the <literal>--section-subtitles</literal> command line option or the <literal>sectsubtitle-xform</literal> configuration value.</paragraph> </section> <section ids="empty-section" names="empty\ section"> - <title auto="1" refid="id36"><generated classes="sectnum">1.2 </generated>Empty Section</title> + <title auto="1" refid="toc-entry-3"><generated classes="sectnum">1.2 </generated>Empty Section</title> </section> <section ids="transitions" names="transitions"> - <title auto="1" refid="id37"><generated classes="sectnum">1.3 </generated>Transitions</title> + <title auto="1" refid="toc-entry-4"><generated classes="sectnum">1.3 </generated>Transitions</title> <paragraph>Here's a transition:</paragraph> <transition></transition> <paragraph>It divides the section. Transitions may also occur between sections:</paragraph> @@ -222,28 +222,28 @@ They are transformed from section titles after parsing.</comment> </section> <transition></transition> <section ids="body-elements" names="body\ elements"> - <title auto="1" refid="id38"><generated classes="sectnum">2 </generated>Body Elements</title> + <title auto="1" refid="toc-entry-5"><generated classes="sectnum">2 </generated>Body Elements</title> <section ids="paragraphs" names="paragraphs"> - <title auto="1" refid="id39"><generated classes="sectnum">2.1 </generated>Paragraphs</title> + <title auto="1" refid="toc-entry-6"><generated classes="sectnum">2.1 </generated>Paragraphs</title> <paragraph>A paragraph.</paragraph> <section ids="inline-markup" names="inline\ markup"> - <title auto="1" refid="id40"><generated classes="sectnum">2.1.1 </generated>Inline Markup</title> + <title auto="1" refid="toc-entry-7"><generated classes="sectnum">2.1.1 </generated>Inline Markup</title> <paragraph>Paragraphs contain text and may contain inline markup: <emphasis>emphasis</emphasis>, <strong>strong emphasis</strong>, <literal>inline literals</literal>, standalone hyperlinks - (<reference refuri="http://www.python.org">http://www.python.org</reference>), external hyperlinks (<reference name="Python" refuri="http://www.python.org/">Python</reference> <footnote_reference auto="1" ids="id26" refid="id25">5</footnote_reference>), internal + (<reference refuri="http://www.python.org">http://www.python.org</reference>), external hyperlinks (<reference name="Python" refuri="http://www.python.org/">Python</reference> <footnote_reference auto="1" ids="footnote-reference-10" refid="footnote-6">5</footnote_reference>), internal cross-references (<reference name="example" refid="example">example</reference>), external hyperlinks with embedded URIs (<reference name="Python web site" refuri="http://www.python.org">Python web site</reference>), <reference anonymous="1" name="anonymous hyperlink references" refuri="http://www.python.org/">anonymous hyperlink - references</reference> <footnote_reference auto="1" ids="id31" refid="id25">5</footnote_reference> (<reference anonymous="1" name="a second reference" refuri="http://docutils.sourceforge.net/">a second reference</reference> <footnote_reference auto="1" ids="id33" refid="id32">7</footnote_reference>), footnote references (manually - numbered <footnote_reference ids="id1" refid="id8">1</footnote_reference>, anonymous auto-numbered <footnote_reference auto="1" ids="id2" refid="id12">3</footnote_reference>, labeled auto-numbered - <footnote_reference auto="1" ids="id3" refid="label">2</footnote_reference>, or symbolic <footnote_reference auto="*" ids="id4" refid="id13">*</footnote_reference>), citation references (<citation_reference ids="id5" refid="cit2002">CIT2002</citation_reference>), + references</reference> <footnote_reference auto="1" ids="footnote-reference-14" refid="footnote-6">5</footnote_reference> (<reference anonymous="1" name="a second reference" refuri="http://docutils.sourceforge.net/">a second reference</reference> <footnote_reference auto="1" ids="footnote-reference-15" refid="footnote-8">7</footnote_reference>), footnote references (manually + numbered <footnote_reference ids="footnote-reference-1" refid="footnote-1">1</footnote_reference>, anonymous auto-numbered <footnote_reference auto="1" ids="footnote-reference-2" refid="footnote-2">3</footnote_reference>, labeled auto-numbered + <footnote_reference auto="1" ids="footnote-reference-3" refid="label">2</footnote_reference>, or symbolic <footnote_reference auto="*" ids="footnote-reference-4" refid="footnote-3">*</footnote_reference>), citation references (<citation_reference ids="citation-reference-1" refid="cit2002">CIT2002</citation_reference>), substitution references (<image alt="EXAMPLE" uri="../../../docs/user/rst/images/biohazard.png"></image> & a <emphasis>trimmed heart</emphasis> <literal>(U+2665):</literal>♥), and <target ids="inline-hyperlink-targets" names="inline\ hyperlink\ targets">inline hyperlink targets</target> (see <reference name="Targets" refid="targets">Targets</reference> below for a reference back to here). Character-level - inline markup is also possible (although exceedingly ugly!) in <emphasis>re</emphasis><literal>Structured</literal><emphasis>Text</emphasis>. Problems are indicated by <problematic ids="id24" refid="id23">|problematic|</problematic> text + inline markup is also possible (although exceedingly ugly!) in <emphasis>re</emphasis><literal>Structured</literal><emphasis>Text</emphasis>. Problems are indicated by <problematic ids="problematic-1" refid="system-message-1">|problematic|</problematic> text (generated by processing errors; this one is intentional). Here is a reference to the <reference name="doctitle" refid="doctitle">doctitle</reference> and the <reference name="subtitle" refid="subtitle">subtitle</reference>.</paragraph> - <target anonymous="1" ids="id6" refuri="http://www.python.org/"></target> - <target anonymous="1" ids="id7" refuri="http://docutils.sourceforge.net/"></target> + <target anonymous="1" ids="target-1" refuri="http://www.python.org/"></target> + <target anonymous="1" ids="target-2" refuri="http://docutils.sourceforge.net/"></target> <paragraph>The default role for interpreted text is <title_reference>Title Reference</title_reference>. Here are some explicit interpreted text roles: a PEP reference (<reference refuri="http://www.python.org/dev/peps/pep-0287">PEP 287</reference>); an RFC reference (<reference refuri="http://tools.ietf.org/html/rfc2822.html">RFC 2822</reference>); an abbreviation (<abbreviation>abb.</abbreviation>), an acronym @@ -262,7 +262,7 @@ should be grouped in pairs).</literal></paragraph> </section> </section> <section ids="bullet-lists" names="bullet\ lists"> - <title auto="1" refid="id41"><generated classes="sectnum">2.2 </generated>Bullet Lists</title> + <title auto="1" refid="toc-entry-8"><generated classes="sectnum">2.2 </generated>Bullet Lists</title> <bullet_list bullet="-"> <list_item> <paragraph>A bullet list</paragraph> @@ -306,7 +306,7 @@ should be grouped in pairs).</literal></paragraph> </bullet_list> </section> <section ids="enumerated-lists" names="enumerated\ lists"> - <title auto="1" refid="id42"><generated classes="sectnum">2.3 </generated>Enumerated Lists</title> + <title auto="1" refid="toc-entry-9"><generated classes="sectnum">2.3 </generated>Enumerated Lists</title> <enumerated_list enumtype="arabic" prefix="" suffix="."> <list_item> <paragraph>Arabic numerals.</paragraph> @@ -370,7 +370,7 @@ should be grouped in pairs).</literal></paragraph> </enumerated_list> </section> <section ids="definition-lists" names="definition\ lists"> - <title auto="1" refid="id43"><generated classes="sectnum">2.4 </generated>Definition Lists</title> + <title auto="1" refid="toc-entry-10"><generated classes="sectnum">2.4 </generated>Definition Lists</title> <definition_list> <definition_list_item> <term>Term</term> @@ -403,7 +403,7 @@ should be grouped in pairs).</literal></paragraph> </definition_list> </section> <section ids="field-lists" names="field\ lists"> - <title auto="1" refid="id44"><generated classes="sectnum">2.5 </generated>Field Lists</title> + <title auto="1" refid="toc-entry-11"><generated classes="sectnum">2.5 </generated>Field Lists</title> <field_list> <field> <field_name>what</field_name> @@ -432,7 +432,7 @@ should be grouped in pairs).</literal></paragraph> </field_list> </section> <section ids="option-lists" names="option\ lists"> - <title auto="1" refid="id45"><generated classes="sectnum">2.6 </generated>Option Lists</title> + <title auto="1" refid="toc-entry-12"><generated classes="sectnum">2.6 </generated>Option Lists</title> <paragraph>For listing command-line options:</paragraph> <option_list> <option_list_item> @@ -554,7 +554,7 @@ should be grouped in pairs).</literal></paragraph> description.</paragraph> </section> <section ids="literal-blocks" names="literal\ blocks"> - <title auto="1" refid="id46"><generated classes="sectnum">2.7 </generated>Literal Blocks</title> + <title auto="1" refid="toc-entry-13"><generated classes="sectnum">2.7 </generated>Literal Blocks</title> <paragraph>Literal blocks are indicated with a double-colon ("::") at the end of the preceding paragraph (over there <literal>--></literal>). They can be indented:</paragraph> <literal_block xml:space="preserve">if literal_block: @@ -567,7 +567,7 @@ should be grouped in pairs).</literal></paragraph> > Why didn't I think of that?</literal_block> </section> <section ids="line-blocks" names="line\ blocks"> - <title auto="1" refid="id47"><generated classes="sectnum">2.8 </generated>Line Blocks</title> + <title auto="1" refid="toc-entry-14"><generated classes="sectnum">2.8 </generated>Line Blocks</title> <paragraph>This section tests line blocks. Line blocks are body elements which consist of lines and other line blocks. Nested line blocks cause indentation.</paragraph> @@ -641,7 +641,7 @@ should be grouped in pairs).</literal></paragraph> </line_block> </section> <section ids="block-quotes" names="block\ quotes"> - <title auto="1" refid="id48"><generated classes="sectnum">2.9 </generated>Block Quotes</title> + <title auto="1" refid="toc-entry-15"><generated classes="sectnum">2.9 </generated>Block Quotes</title> <paragraph>Block quotes consist of indented body elements:</paragraph> <block_quote> <paragraph>My theory by A. Elk. Brackets Miss, brackets. This theory goes @@ -660,63 +660,63 @@ should be grouped in pairs).</literal></paragraph> </block_quote> </section> <section ids="doctest-blocks" names="doctest\ blocks"> - <title auto="1" refid="id49"><generated classes="sectnum">2.10 </generated>Doctest Blocks</title> + <title auto="1" refid="toc-entry-16"><generated classes="sectnum">2.10 </generated>Doctest Blocks</title> <doctest_block xml:space="preserve">>>> print 'Python-specific usage examples; begun with ">>>"' Python-specific usage examples; begun with ">>>" >>> print '(cut and pasted from interactive Python sessions)' (cut and pasted from interactive Python sessions)</doctest_block> </section> <section ids="footnotes" names="footnotes"> - <title auto="1" refid="id50"><generated classes="sectnum">2.11 </generated>Footnotes</title> - <footnote backrefs="id1 id9 id22" ids="id8" names="1"> + <title auto="1" refid="toc-entry-17"><generated classes="sectnum">2.11 </generated>Footnotes</title> + <footnote backrefs="footnote-reference-1 footnote-reference-5 footnote-reference-9" ids="footnote-1" names="1"> <label>1</label> <paragraph>A footnote contains body elements, consistently indented by at least 3 spaces.</paragraph> <paragraph>This is the footnote's second paragraph.</paragraph> </footnote> - <footnote auto="1" backrefs="id3 id10" ids="label" names="label"> + <footnote auto="1" backrefs="footnote-reference-3 footnote-reference-6" ids="label" names="label"> <label>2</label> - <paragraph>Footnotes may be numbered, either manually (as in <footnote_reference ids="id9" refid="id8">1</footnote_reference>) or + <paragraph>Footnotes may be numbered, either manually (as in <footnote_reference ids="footnote-reference-5" refid="footnote-1">1</footnote_reference>) 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 (<footnote_reference auto="1" ids="id10" refid="label">2</footnote_reference>) and as a <reference anonymous="1" name="hyperlink reference" refid="label">hyperlink reference</reference>.</paragraph> - <target anonymous="1" ids="id11" refid="label"></target> + footnote reference (<footnote_reference auto="1" ids="footnote-reference-6" refid="label">2</footnote_reference>) and as a <reference anonymous="1" name="hyperlink reference" refid="label">hyperlink reference</reference>.</paragraph> + <target anonymous="1" ids="target-3" refid="label"></target> </footnote> - <footnote auto="1" backrefs="id2" ids="id12" names="3"> + <footnote auto="1" backrefs="footnote-reference-2" ids="footnote-2" names="3"> <label>3</label> <paragraph>This footnote is numbered automatically and anonymously using a label of "#" only.</paragraph> <paragraph>This is the second paragraph.</paragraph> <paragraph>And this is the third paragraph.</paragraph> </footnote> - <footnote auto="*" backrefs="id4" ids="id13"> + <footnote auto="*" backrefs="footnote-reference-4" ids="footnote-3"> <label>*</label> <paragraph>Footnotes may also use symbols, specified with a "*" label. - Here's a reference to the next footnote: <footnote_reference auto="*" ids="id14" refid="id15">†</footnote_reference>.</paragraph> + Here's a reference to the next footnote: <footnote_reference auto="*" ids="footnote-reference-7" refid="footnote-4">†</footnote_reference>.</paragraph> </footnote> - <footnote auto="*" backrefs="id14" ids="id15"> + <footnote auto="*" backrefs="footnote-reference-7" ids="footnote-4"> <label>†</label> <paragraph>This footnote shows the next symbol in the sequence.</paragraph> </footnote> - <footnote ids="id16" names="4"> + <footnote ids="footnote-5" names="4"> <label>4</label> <paragraph>Here's an unreferenced footnote, with a reference to a - nonexistent footnote: <problematic ids="id17" refid="id83">[5]_</problematic>.</paragraph> + nonexistent footnote: <problematic ids="footnote-reference-8" refid="system-message-2">[5]_</problematic>.</paragraph> </footnote> </section> <section ids="citations" names="citations"> - <title auto="1" refid="id51"><generated classes="sectnum">2.12 </generated>Citations</title> - <citation backrefs="id5 id18" ids="cit2002" names="cit2002"> + <title auto="1" refid="toc-entry-18"><generated classes="sectnum">2.12 </generated>Citations</title> + <citation backrefs="citation-reference-1 citation-reference-2" ids="cit2002" names="cit2002"> <label>CIT2002</label> <paragraph>Citations are text-labeled footnotes. They may be rendered separately and differently from footnotes.</paragraph> </citation> - <paragraph>Here's a reference to the above, <citation_reference ids="id18" refid="cit2002">CIT2002</citation_reference>, and a <problematic ids="id19" refid="id84">[nonexistent]_</problematic> + <paragraph>Here's a reference to the above, <citation_reference ids="citation-reference-2" refid="cit2002">CIT2002</citation_reference>, and a <problematic ids="citation-reference-3" refid="system-message-3">[nonexistent]_</problematic> citation.</paragraph> <target refid="another-target"></target> </section> <section ids="targets another-target" names="targets another\ target"> - <title auto="1" refid="id52"><generated classes="sectnum">2.13 </generated>Targets</title> + <title auto="1" refid="toc-entry-19"><generated classes="sectnum">2.13 </generated>Targets</title> <target refid="example"></target> <paragraph ids="example" names="example">This paragraph is pointed to by the explicit "example" target. A reference can be found under <reference name="Inline Markup" refid="inline-markup">Inline Markup</reference>, above. <reference name="Inline hyperlink targets" refid="inline-hyperlink-targets">Inline @@ -724,59 +724,59 @@ Python-specific usage examples; begun with ">>>" <paragraph>Section headers are implicit targets, referred to by name. See <reference name="Targets" refid="targets">Targets</reference>, which is a subsection of <reference name="Body Elements" refid="body-elements">Body Elements</reference>.</paragraph> <paragraph>Explicit external targets are interpolated into references such as - "<reference name="Python" refuri="http://www.python.org/">Python</reference> <footnote_reference auto="1" ids="id27" refid="id25">5</footnote_reference>".</paragraph> + "<reference name="Python" refuri="http://www.python.org/">Python</reference> <footnote_reference auto="1" ids="footnote-reference-11" refid="footnote-6">5</footnote_reference>".</paragraph> <target ids="python" names="python" refuri="http://www.python.org/"></target> <paragraph>Targets may be indirect and anonymous. Thus <reference anonymous="1" name="this phrase" refid="targets">this phrase</reference> may also refer to the <reference name="Targets" refid="targets">Targets</reference> section.</paragraph> - <target anonymous="1" ids="id20" refid="targets"></target> - <paragraph>Here's a <problematic ids="id86" refid="id85">`hyperlink reference without a target`_</problematic>, which generates an + <target anonymous="1" ids="target-4" refid="targets"></target> + <paragraph>Here's a <problematic ids="problematic-2" refid="system-message-4">`hyperlink reference without a target`_</problematic>, which generates an error.</paragraph> <section dupnames="duplicate\ target\ names" ids="duplicate-target-names"> - <title auto="1" refid="id53"><generated classes="sectnum">2.13.1 </generated>Duplicate Target Names</title> + <title auto="1" refid="toc-entry-20"><generated classes="sectnum">2.13.1 </generated>Duplicate Target Names</title> <paragraph>Duplicate names in section headers or other implicit targets will generate "info" (level-1) system messages. Duplicate names in explicit targets will generate "warning" (level-2) system messages.</paragraph> </section> - <section dupnames="duplicate\ target\ names" ids="id21"> - <title auto="1" refid="id54"><generated classes="sectnum">2.13.2 </generated>Duplicate Target Names</title> - <system_message backrefs="id21" level="1" line="439" source="functional/input/data/standard.txt" type="INFO"> + <section dupnames="duplicate\ target\ names" ids="duplicate-target-names-1"> + <title auto="1" refid="toc-entry-21"><generated classes="sectnum">2.13.2 </generated>Duplicate Target Names</title> + <system_message backrefs="duplicate-target-names-1" level="1" line="439" source="functional/input/data/standard.txt" type="INFO"> <paragraph>Duplicate implicit target name: "duplicate target names".</paragraph> </system_message> <paragraph>Since there are two "Duplicate Target Names" section headers, we cannot uniquely refer to either of them by name. If we try to (like - this: <problematic ids="id88" refid="id87">`Duplicate Target Names`_</problematic>), an error is generated.</paragraph> + this: <problematic ids="problematic-3" refid="system-message-5">`Duplicate Target Names`_</problematic>), an error is generated.</paragraph> </section> </section> <section ids="directives" names="directives"> - <title auto="1" refid="id55"><generated classes="sectnum">2.14 </generated>Directives</title> + <title auto="1" refid="toc-entry-22"><generated classes="sectnum">2.14 </generated>Directives</title> <topic classes="contents local" ids="contents" names="contents"> <bullet_list classes="auto-toc"> <list_item> - <paragraph><reference ids="id74" refid="document-parts"><generated classes="sectnum">2.14.1 </generated>Document Parts</reference></paragraph> + <paragraph><reference ids="toc-entry-41" refid="document-parts"><generated classes="sectnum">2.14.1 </generated>Document Parts</reference></paragraph> </list_item> <list_item> - <paragraph><reference ids="id75" refid="images-and-figures"><generated classes="sectnum">2.14.2 </generated>Images and Figures</reference></paragraph> + <paragraph><reference ids="toc-entry-42" refid="images-and-figures"><generated classes="sectnum">2.14.2 </generated>Images and Figures</reference></paragraph> </list_item> <list_item> - <paragraph><reference ids="id76" refid="admonitions"><generated classes="sectnum">2.14.3 </generated>Admonitions</reference></paragraph> + <paragraph><reference ids="toc-entry-43" refid="admonitions"><generated classes="sectnum">2.14.3 </generated>Admonitions</reference></paragraph> </list_item> <list_item> - <paragraph><reference ids="id77" refid="topics-sidebars-and-rubrics"><generated classes="sectnum">2.14.4 </generated>Topics, Sidebars, and Rubrics</reference></paragraph> + <paragraph><reference ids="toc-entry-44" refid="topics-sidebars-and-rubrics"><generated classes="sectnum">2.14.4 </generated>Topics, Sidebars, and Rubrics</reference></paragraph> </list_item> <list_item> - <paragraph><reference ids="id78" refid="target-footnotes"><generated classes="sectnum">2.14.5 </generated>Target Footnotes</reference></paragraph> + <paragraph><reference ids="toc-entry-45" refid="target-footnotes"><generated classes="sectnum">2.14.5 </generated>Target Footnotes</reference></paragraph> </list_item> <list_item> - <paragraph><reference ids="id79" refid="replacement-text"><generated classes="sectnum">2.14.6 </generated>Replacement Text</reference></paragraph> + <paragraph><reference ids="toc-entry-46" refid="replacement-text"><generated classes="sectnum">2.14.6 </generated>Replacement Text</reference></paragraph> </list_item> <list_item> - <paragraph><reference ids="id80" refid="compound-paragraph"><generated classes="sectnum">2.14.7 </generated>Compound Paragraph</reference></paragraph> + <paragraph><reference ids="toc-entry-47" refid="compound-paragraph"><generated classes="sectnum">2.14.7 </generated>Compound Paragraph</reference></paragraph> </list_item> <list_item> - <paragraph><reference ids="id81" refid="parsed-literal-blocks"><generated classes="sectnum">2.14.8 </generated>Parsed Literal Blocks</reference></paragraph> + <paragraph><reference ids="toc-entry-48" refid="parsed-literal-blocks"><generated classes="sectnum">2.14.8 </generated>Parsed Literal Blocks</reference></paragraph> </list_item> <list_item> - <paragraph><reference ids="id82" refid="code"><generated classes="sectnum">2.14.9 </generated>Code</reference></paragraph> + <paragraph><reference ids="toc-entry-49" refid="code"><generated classes="sectnum">2.14.9 </generated>Code</reference></paragraph> </list_item> </bullet_list> </topic> @@ -784,13 +784,13 @@ Python-specific usage examples; begun with ">>>" others, please see <reference refuri="http://docutils.sourceforge.net/docs/ref/rst/directives.html">http://docutils.sourceforge.net/docs/ref/rst/directives.html</reference>.</paragraph> <section ids="document-parts" names="document\ parts"> - <title auto="1" refid="id74"><generated classes="sectnum">2.14.1 </generated>Document Parts</title> + <title auto="1" refid="toc-entry-41"><generated classes="sectnum">2.14.1 </generated>Document Parts</title> <paragraph>An example of the "contents" directive can be seen above this section (a local, untitled table of <reference name="contents" refid="contents">contents</reference>) and at the beginning of the document (a document-wide <reference name="table of contents" refid="table-of-contents">table of contents</reference>).</paragraph> </section> <section ids="images-and-figures" names="images\ and\ figures"> - <title auto="1" refid="id75"><generated classes="sectnum">2.14.2 </generated>Images and Figures</title> + <title auto="1" refid="toc-entry-42"><generated classes="sectnum">2.14.2 </generated>Images and Figures</title> <paragraph>An image directive (also clickable -- a hyperlink reference):</paragraph> <reference name="directives" refid="directives"><image classes="class1 class2" uri="../../../docs/user/rst/images/title.png"></image></reference> <paragraph>Image with multiple IDs:</paragraph> @@ -1077,7 +1077,7 @@ Python-specific usage examples; begun with ">>>" </table> </section> <section ids="admonitions" names="admonitions"> - <title auto="1" refid="id76"><generated classes="sectnum">2.14.3 </generated>Admonitions</title> + <title auto="1" refid="toc-entry-43"><generated classes="sectnum">2.14.3 </generated>Admonitions</title> <attention> <paragraph>Directives at large.</paragraph> </attention> @@ -1126,7 +1126,7 @@ Python-specific usage examples; begun with ">>>" </admonition> </section> <section ids="topics-sidebars-and-rubrics" names="topics,\ sidebars,\ and\ rubrics"> - <title auto="1" refid="id77"><generated classes="sectnum">2.14.4 </generated>Topics, Sidebars, and Rubrics</title> + <title auto="1" refid="toc-entry-44"><generated classes="sectnum">2.14.4 </generated>Topics, Sidebars, and Rubrics</title> <paragraph><emphasis>Sidebars</emphasis> are like miniature, parallel documents.</paragraph> <sidebar> <title>Sidebar Title</title> @@ -1150,27 +1150,27 @@ Python-specific usage examples; begun with ">>>" allowed (e.g. inside a directive).</paragraph> </section> <section ids="target-footnotes" names="target\ footnotes"> - <title auto="1" refid="id78"><generated classes="sectnum">2.14.5 </generated>Target Footnotes</title> - <footnote auto="1" backrefs="id26 id27 id28 id31" ids="id25" names="TARGET_NOTE:\ id25"> + <title auto="1" refid="toc-entry-45"><generated classes="sectnum">2.14.5 </generated>Target Footnotes</title> + <footnote auto="1" backrefs="footnote-reference-10 footnote-reference-11 footnote-reference-12 footnote-reference-14" ids="footnote-6" names="TARGET_NOTE:\ footnote-6"> <label>5</label> <paragraph><reference refuri="http://www.python.org/">http://www.python.org/</reference></paragraph> </footnote> - <footnote auto="1" backrefs="id30" ids="id29" names="TARGET_NOTE:\ id29"> + <footnote auto="1" backrefs="footnote-reference-13" ids="footnote-7" names="TARGET_NOTE:\ footnote-7"> <label>6</label> <paragraph><reference refuri="http://pygments.org/">http://pygments.org/</reference></paragraph> </footnote> - <footnote auto="1" backrefs="id33" ids="id32" names="TARGET_NOTE:\ id32"> + <footnote auto="1" backrefs="footnote-reference-15" ids="footnote-8" names="TARGET_NOTE:\ footnote-8"> <label>7</label> <paragraph><reference refuri="http://docutils.sourceforge.net/">http://docutils.sourceforge.net/</reference></paragraph> </footnote> </section> <section ids="replacement-text" names="replacement\ text"> - <title auto="1" refid="id79"><generated classes="sectnum">2.14.6 </generated>Replacement Text</title> - <paragraph>I recommend you try <reference refuri="http://www.python.org/">Python, <emphasis>the</emphasis> best language around</reference> <footnote_reference auto="1" ids="id28" refid="id25">5</footnote_reference>.</paragraph> + <title auto="1" refid="toc-entry-46"><generated classes="sectnum">2.14.6 </generated>Replacement Text</title> + <paragraph>I recommend you try <reference refuri="http://www.python.org/">Python, <emphasis>the</emphasis> best language around</reference> <footnote_reference auto="1" ids="footnote-reference-12" refid="footnote-6">5</footnote_reference>.</paragraph> <substitution_definition names="Python">Python, <emphasis>the</emphasis> best language around</substitution_definition> </section> <section ids="compound-paragraph" names="compound\ paragraph"> - <title auto="1" refid="id80"><generated classes="sectnum">2.14.7 </generated>Compound Paragraph</title> + <title auto="1" refid="toc-entry-47"><generated classes="sectnum">2.14.7 </generated>Compound Paragraph</title> <paragraph>The <emphasis>compound</emphasis> directive is used to create a "compound paragraph", which is a single logical paragraph containing multiple physical body elements. For example:</paragraph> @@ -1304,19 +1304,19 @@ This one starts with a literal block.</literal_block> </compound> </section> <section ids="parsed-literal-blocks" names="parsed\ literal\ blocks"> - <title auto="1" refid="id81"><generated classes="sectnum">2.14.8 </generated>Parsed Literal Blocks</title> + <title auto="1" refid="toc-entry-48"><generated classes="sectnum">2.14.8 </generated>Parsed Literal Blocks</title> <literal_block xml:space="preserve">This is a parsed literal block. This line is indented. The next line is blank. Inline markup is supported, e.g. <emphasis>emphasis</emphasis>, <strong>strong</strong>, <literal>literal text</literal>, <subscript>sub-</subscript> and <superscript>super</superscript>scripts, inline formulas: <math>A = 2 \pi r^2</math>, -footnotes <footnote_reference ids="id22" refid="id8">1</footnote_reference>, <target ids="hyperlink-targets" names="hyperlink\ targets">hyperlink targets</target>, and <reference name="references" refuri="http://www.python.org/">references</reference><target ids="references" names="references" refuri="http://www.python.org/"></target>.</literal_block> +footnotes <footnote_reference ids="footnote-reference-9" refid="footnote-1">1</footnote_reference>, <target ids="hyperlink-targets" names="hyperlink\ targets">hyperlink targets</target>, and <reference name="references" refuri="http://www.python.org/">references</reference><target ids="references" names="references" refuri="http://www.python.org/"></target>.</literal_block> </section> <section ids="code" names="code"> - <title auto="1" refid="id82"><generated classes="sectnum">2.14.9 </generated>Code</title> + <title auto="1" refid="toc-entry-49"><generated classes="sectnum">2.14.9 </generated>Code</title> <paragraph>Blocks of source code can be set with the <title_reference>code</title_reference> directive. If the code - language is specified, the content is parsed and tagged by the <reference name="Pygments" refuri="http://pygments.org/">Pygments</reference> <footnote_reference auto="1" ids="id30" refid="id29">6</footnote_reference> + language is specified, the content is parsed and tagged by the <reference name="Pygments" refuri="http://pygments.org/">Pygments</reference> <footnote_reference auto="1" ids="footnote-reference-13" refid="footnote-7">6</footnote_reference> syntax highlighter and can be formatted with a style sheet. (Code parsing is turned off using the <literal>syntax-highlight</literal> config setting in the test conversions in order to get identical results with/without installed @@ -1341,7 +1341,7 @@ footnotes <footnote_reference ids="id22" refid="id8">1</footnote_reference>, <ta </section> </section> <section ids="substitution-definitions" names="substitution\ definitions"> - <title auto="1" refid="id65"><generated classes="sectnum">2.15 </generated>Substitution Definitions</title> + <title auto="1" refid="toc-entry-32"><generated classes="sectnum">2.15 </generated>Substitution Definitions</title> <paragraph>An inline image (<image alt="EXAMPLE" uri="../../../docs/user/rst/images/biohazard.png"></image>) example:</paragraph> <substitution_definition names="EXAMPLE"><image alt="EXAMPLE" uri="../../../docs/user/rst/images/biohazard.png"></image></substitution_definition> <paragraph>A Unicode example:</paragraph> @@ -1349,7 +1349,7 @@ footnotes <footnote_reference ids="id22" refid="id8">1</footnote_reference>, <ta <paragraph>(Substitution definitions are not visible in the HTML source.)</paragraph> </section> <section ids="comments" names="comments"> - <title auto="1" refid="id66"><generated classes="sectnum">2.16 </generated>Comments</title> + <title auto="1" refid="toc-entry-33"><generated classes="sectnum">2.16 </generated>Comments</title> <paragraph>Here's one:</paragraph> <comment xml:space="preserve">Comments begin with two dots and a space. Anything may follow, except for the syntax of footnotes, hyperlink @@ -1361,7 +1361,7 @@ Comments may contain non-ASCII characters: ä ö ü æ ø å</comment> <paragraph>(View the HTML source to see the comment.)</paragraph> </section> <section ids="raw-text" names="raw\ text"> - <title auto="1" refid="id67"><generated classes="sectnum">2.17 </generated>Raw text</title> + <title auto="1" refid="toc-entry-34"><generated classes="sectnum">2.17 </generated>Raw text</title> <paragraph>This does not necessarily look nice, because there may be missing white space.</paragraph> <paragraph>It's just there to freeze the behavior.</paragraph> <raw format="html latex" xml:space="preserve">A test.</raw> @@ -1372,14 +1372,14 @@ Comments may contain non-ASCII characters: ä ö ü æ ø å</comment> <raw format="latex" xml:space="preserve">Fifth test in LaTeX.\\Line two.</raw> </section> <section ids="container" names="container"> - <title auto="1" refid="id68"><generated classes="sectnum">2.18 </generated>Container</title> + <title auto="1" refid="toc-entry-35"><generated classes="sectnum">2.18 </generated>Container</title> <container classes="custom"> <paragraph>paragraph 1</paragraph> <paragraph>paragraph 2</paragraph> </container> </section> <section ids="colspanning-tables" names="colspanning\ tables"> - <title auto="1" refid="id69"><generated classes="sectnum">2.19 </generated>Colspanning tables</title> + <title auto="1" refid="toc-entry-36"><generated classes="sectnum">2.19 </generated>Colspanning tables</title> <paragraph>This table has a cell spanning two columns:</paragraph> <table> <tgroup cols="3"> @@ -1457,7 +1457,7 @@ Comments may contain non-ASCII characters: ä ö ü æ ø å</comment> </table> </section> <section ids="rowspanning-tables" names="rowspanning\ tables"> - <title auto="1" refid="id70"><generated classes="sectnum">2.20 </generated>Rowspanning tables</title> + <title auto="1" refid="toc-entry-37"><generated classes="sectnum">2.20 </generated>Rowspanning tables</title> <paragraph>Here's a table with cells spanning several rows:</paragraph> <table> <tgroup cols="3"> @@ -1514,7 +1514,7 @@ Comments may contain non-ASCII characters: ä ö ü æ ø å</comment> </table> </section> <section ids="complex-tables" names="complex\ tables"> - <title auto="1" refid="id71"><generated classes="sectnum">2.21 </generated>Complex tables</title> + <title auto="1" refid="toc-entry-38"><generated classes="sectnum">2.21 </generated>Complex tables</title> <paragraph>Here's a complex table, which should test all features.</paragraph> <table> <tgroup cols="4"> @@ -1606,7 +1606,7 @@ Comments may contain non-ASCII characters: ä ö ü æ ø å</comment> </table> </section> <section ids="list-tables" names="list\ tables"> - <title auto="1" refid="id72"><generated classes="sectnum">2.22 </generated>List Tables</title> + <title auto="1" refid="toc-entry-39"><generated classes="sectnum">2.22 </generated>List Tables</title> <paragraph>Here's a list table exercising all features:</paragraph> <table classes="colwidths-given test" width="40em"> <title>list table with integral header</title> @@ -1701,7 +1701,7 @@ Comments may contain non-ASCII characters: ä ö ü æ ø å</comment> </section> </section> <section ids="error-handling" names="error\ handling"> - <title auto="1" refid="id73"><generated classes="sectnum">3 </generated>Error Handling</title> + <title auto="1" refid="toc-entry-40"><generated classes="sectnum">3 </generated>Error Handling</title> <paragraph>Any errors caught during processing will generate system messages.</paragraph> <paragraph>There should be five messages in the following, auto-generated section, "Docutils System Messages":</paragraph> @@ -1709,19 +1709,19 @@ Comments may contain non-ASCII characters: ä ö ü æ ø å</comment> </section> <section classes="system-messages"> <title>Docutils System Messages</title> - <system_message backrefs="id24" ids="id23" level="3" line="104" source="functional/input/data/standard.txt" type="ERROR"> + <system_message backrefs="problematic-1" ids="system-message-1" level="3" line="104" source="functional/input/data/standard.txt" type="ERROR"> <paragraph>Undefined substitution referenced: "problematic".</paragraph> </system_message> - <system_message backrefs="id17" ids="id83" level="3" line="392" source="functional/input/data/standard.txt" type="ERROR"> + <system_message backrefs="footnote-reference-8" ids="system-message-2" level="3" line="392" source="functional/input/data/standard.txt" type="ERROR"> <paragraph>Unknown target name: "5".</paragraph> </system_message> - <system_message backrefs="id19" ids="id84" level="3" line="401" source="functional/input/data/standard.txt" type="ERROR"> + <system_message backrefs="citation-reference-3" ids="system-message-3" level="3" line="401" source="functional/input/data/standard.txt" type="ERROR"> <paragraph>Unknown target name: "nonexistent".</paragraph> </system_message> - <system_message backrefs="id86" ids="id85" level="3" line="428" source="functional/input/data/standard.txt" type="ERROR"> + <system_message backrefs="problematic-2" ids="system-message-4" level="3" line="428" source="functional/input/data/standard.txt" type="ERROR"> <paragraph>Unknown target name: "hyperlink reference without a target".</paragraph> </system_message> - <system_message backrefs="id88" ids="id87" level="3" line="441" source="functional/input/data/standard.txt" type="ERROR"> + <system_message backrefs="problematic-3" ids="system-message-5" level="3" line="441" source="functional/input/data/standard.txt" type="ERROR"> <paragraph>Duplicate target name, cannot be used as a unique reference: "duplicate target names".</paragraph> </system_message> <system_message level="1" line="164" source="functional/input/data/standard.txt" type="INFO"> diff --git a/docutils/test/functional/expected/standalone_rst_html4css1.html b/docutils/test/functional/expected/standalone_rst_html4css1.html index 36861cd0f..5a2ed3a4e 100644 --- a/docutils/test/functional/expected/standalone_rst_html4css1.html +++ b/docutils/test/functional/expected/standalone_rst_html4css1.html @@ -86,75 +86,75 @@ They are transformed from section titles after parsing. --> <div class="contents topic" id="table-of-contents"> <p class="topic-title">Table of Contents</p> <ul class="auto-toc simple"> -<li><a class="reference internal" href="#structural-elements" id="id34">1 Structural Elements</a><ul class="auto-toc"> -<li><a class="reference internal" href="#section-title" id="id35">1.1 Section Title</a></li> -<li><a class="reference internal" href="#empty-section" id="id36">1.2 Empty Section</a></li> -<li><a class="reference internal" href="#transitions" id="id37">1.3 Transitions</a></li> +<li><a class="reference internal" href="#structural-elements" id="toc-entry-1">1 Structural Elements</a><ul class="auto-toc"> +<li><a class="reference internal" href="#section-title" id="toc-entry-2">1.1 Section Title</a></li> +<li><a class="reference internal" href="#empty-section" id="toc-entry-3">1.2 Empty Section</a></li> +<li><a class="reference internal" href="#transitions" id="toc-entry-4">1.3 Transitions</a></li> </ul> </li> -<li><a class="reference internal" href="#body-elements" id="id38">2 Body Elements</a><ul class="auto-toc"> -<li><a class="reference internal" href="#paragraphs" id="id39">2.1 Paragraphs</a><ul class="auto-toc"> -<li><a class="reference internal" href="#inline-markup" id="id40">2.1.1 Inline Markup</a></li> +<li><a class="reference internal" href="#body-elements" id="toc-entry-5">2 Body Elements</a><ul class="auto-toc"> +<li><a class="reference internal" href="#paragraphs" id="toc-entry-6">2.1 Paragraphs</a><ul class="auto-toc"> +<li><a class="reference internal" href="#inline-markup" id="toc-entry-7">2.1.1 Inline Markup</a></li> </ul> </li> -<li><a class="reference internal" href="#bullet-lists" id="id41">2.2 Bullet Lists</a></li> -<li><a class="reference internal" href="#enumerated-lists" id="id42">2.3 Enumerated Lists</a></li> -<li><a class="reference internal" href="#definition-lists" id="id43">2.4 Definition Lists</a></li> -<li><a class="reference internal" href="#field-lists" id="id44">2.5 Field Lists</a></li> -<li><a class="reference internal" href="#option-lists" id="id45">2.6 Option Lists</a></li> -<li><a class="reference internal" href="#literal-blocks" id="id46">2.7 Literal Blocks</a></li> -<li><a class="reference internal" href="#line-blocks" id="id47">2.8 Line Blocks</a></li> -<li><a class="reference internal" href="#block-quotes" id="id48">2.9 Block Quotes</a></li> -<li><a class="reference internal" href="#doctest-blocks" id="id49">2.10 Doctest Blocks</a></li> -<li><a class="reference internal" href="#footnotes" id="id50">2.11 Footnotes</a></li> -<li><a class="reference internal" href="#citations" id="id51">2.12 Citations</a></li> -<li><a class="reference internal" href="#targets" id="id52">2.13 Targets</a><ul class="auto-toc"> -<li><a class="reference internal" href="#duplicate-target-names" id="id53">2.13.1 Duplicate Target Names</a></li> -<li><a class="reference internal" href="#id21" id="id54">2.13.2 Duplicate Target Names</a></li> +<li><a class="reference internal" href="#bullet-lists" id="toc-entry-8">2.2 Bullet Lists</a></li> +<li><a class="reference internal" href="#enumerated-lists" id="toc-entry-9">2.3 Enumerated Lists</a></li> +<li><a class="reference internal" href="#definition-lists" id="toc-entry-10">2.4 Definition Lists</a></li> +<li><a class="reference internal" href="#field-lists" id="toc-entry-11">2.5 Field Lists</a></li> +<li><a class="reference internal" href="#option-lists" id="toc-entry-12">2.6 Option Lists</a></li> +<li><a class="reference internal" href="#literal-blocks" id="toc-entry-13">2.7 Literal Blocks</a></li> +<li><a class="reference internal" href="#line-blocks" id="toc-entry-14">2.8 Line Blocks</a></li> +<li><a class="reference internal" href="#block-quotes" id="toc-entry-15">2.9 Block Quotes</a></li> +<li><a class="reference internal" href="#doctest-blocks" id="toc-entry-16">2.10 Doctest Blocks</a></li> +<li><a class="reference internal" href="#footnotes" id="toc-entry-17">2.11 Footnotes</a></li> +<li><a class="reference internal" href="#citations" id="toc-entry-18">2.12 Citations</a></li> +<li><a class="reference internal" href="#targets" id="toc-entry-19">2.13 Targets</a><ul class="auto-toc"> +<li><a class="reference internal" href="#duplicate-target-names" id="toc-entry-20">2.13.1 Duplicate Target Names</a></li> +<li><a class="reference internal" href="#duplicate-target-names-1" id="toc-entry-21">2.13.2 Duplicate Target Names</a></li> </ul> </li> -<li><a class="reference internal" href="#directives" id="id55">2.14 Directives</a><ul class="auto-toc"> -<li><a class="reference internal" href="#document-parts" id="id56">2.14.1 Document Parts</a></li> -<li><a class="reference internal" href="#images-and-figures" id="id57">2.14.2 Images and Figures</a></li> -<li><a class="reference internal" href="#admonitions" id="id58">2.14.3 Admonitions</a></li> -<li><a class="reference internal" href="#topics-sidebars-and-rubrics" id="id59">2.14.4 Topics, Sidebars, and Rubrics</a></li> -<li><a class="reference internal" href="#target-footnotes" id="id60">2.14.5 Target Footnotes</a></li> -<li><a class="reference internal" href="#replacement-text" id="id61">2.14.6 Replacement Text</a></li> -<li><a class="reference internal" href="#compound-paragraph" id="id62">2.14.7 Compound Paragraph</a></li> -<li><a class="reference internal" href="#parsed-literal-blocks" id="id63">2.14.8 Parsed Literal Blocks</a></li> -<li><a class="reference internal" href="#code" id="id64">2.14.9 Code</a></li> +<li><a class="reference internal" href="#directives" id="toc-entry-22">2.14 Directives</a><ul class="auto-toc"> +<li><a class="reference internal" href="#document-parts" id="toc-entry-23">2.14.1 Document Parts</a></li> +<li><a class="reference internal" href="#images-and-figures" id="toc-entry-24">2.14.2 Images and Figures</a></li> +<li><a class="reference internal" href="#admonitions" id="toc-entry-25">2.14.3 Admonitions</a></li> +<li><a class="reference internal" href="#topics-sidebars-and-rubrics" id="toc-entry-26">2.14.4 Topics, Sidebars, and Rubrics</a></li> +<li><a class="reference internal" href="#target-footnotes" id="toc-entry-27">2.14.5 Target Footnotes</a></li> +<li><a class="reference internal" href="#replacement-text" id="toc-entry-28">2.14.6 Replacement Text</a></li> +<li><a class="reference internal" href="#compound-paragraph" id="toc-entry-29">2.14.7 Compound Paragraph</a></li> +<li><a class="reference internal" href="#parsed-literal-blocks" id="toc-entry-30">2.14.8 Parsed Literal Blocks</a></li> +<li><a class="reference internal" href="#code" id="toc-entry-31">2.14.9 Code</a></li> </ul> </li> -<li><a class="reference internal" href="#substitution-definitions" id="id65">2.15 Substitution Definitions</a></li> -<li><a class="reference internal" href="#comments" id="id66">2.16 Comments</a></li> -<li><a class="reference internal" href="#raw-text" id="id67">2.17 Raw text</a></li> -<li><a class="reference internal" href="#container" id="id68">2.18 Container</a></li> -<li><a class="reference internal" href="#colspanning-tables" id="id69">2.19 Colspanning tables</a></li> -<li><a class="reference internal" href="#rowspanning-tables" id="id70">2.20 Rowspanning tables</a></li> -<li><a class="reference internal" href="#complex-tables" id="id71">2.21 Complex tables</a></li> -<li><a class="reference internal" href="#list-tables" id="id72">2.22 List Tables</a></li> -<li><a class="reference internal" href="#custom-roles" id="id73">2.23 Custom Roles</a></li> -<li><a class="reference internal" href="#svg-images" id="id74">2.24 SVG Images</a></li> -<li><a class="reference internal" href="#swf-images" id="id75">2.25 SWF Images</a></li> +<li><a class="reference internal" href="#substitution-definitions" id="toc-entry-32">2.15 Substitution Definitions</a></li> +<li><a class="reference internal" href="#comments" id="toc-entry-33">2.16 Comments</a></li> +<li><a class="reference internal" href="#raw-text" id="toc-entry-34">2.17 Raw text</a></li> +<li><a class="reference internal" href="#container" id="toc-entry-35">2.18 Container</a></li> +<li><a class="reference internal" href="#colspanning-tables" id="toc-entry-36">2.19 Colspanning tables</a></li> +<li><a class="reference internal" href="#rowspanning-tables" id="toc-entry-37">2.20 Rowspanning tables</a></li> +<li><a class="reference internal" href="#complex-tables" id="toc-entry-38">2.21 Complex tables</a></li> +<li><a class="reference internal" href="#list-tables" id="toc-entry-39">2.22 List Tables</a></li> +<li><a class="reference internal" href="#custom-roles" id="toc-entry-40">2.23 Custom Roles</a></li> +<li><a class="reference internal" href="#svg-images" id="toc-entry-41">2.24 SVG Images</a></li> +<li><a class="reference internal" href="#swf-images" id="toc-entry-42">2.25 SWF Images</a></li> </ul> </li> -<li><a class="reference internal" href="#error-handling" id="id76">3 Error Handling</a></li> +<li><a class="reference internal" href="#error-handling" id="toc-entry-43">3 Error Handling</a></li> </ul> </div> <div class="section" id="structural-elements"> -<h1><a class="toc-backref" href="#id34">1 Structural Elements</a></h1> +<h1><a class="toc-backref" href="#toc-entry-1">1 Structural Elements</a></h1> <div class="section" id="section-title"> -<h2 class="with-subtitle"><a class="toc-backref" href="#id35">1.1 Section Title</a></h2> +<h2 class="with-subtitle"><a class="toc-backref" href="#toc-entry-2">1.1 Section Title</a></h2> <h2 class="section-subtitle" id="section-subtitle"><span class="section-subtitle">Section Subtitle</span></h2> <p>Lone subsections are converted to a section subtitle by a transform activated with the <tt class="docutils literal"><span class="pre">--section-subtitles</span></tt> command line option or the <tt class="docutils literal"><span class="pre">sectsubtitle-xform</span></tt> configuration value.</p> </div> <div class="section" id="empty-section"> -<h2><a class="toc-backref" href="#id36">1.2 Empty Section</a></h2> +<h2><a class="toc-backref" href="#toc-entry-3">1.2 Empty Section</a></h2> </div> <div class="section" id="transitions"> -<h2><a class="toc-backref" href="#id37">1.3 Transitions</a></h2> +<h2><a class="toc-backref" href="#toc-entry-4">1.3 Transitions</a></h2> <p>Here's a transition:</p> <hr class="docutils" /> <p>It divides the section. Transitions may also occur between sections:</p> @@ -162,24 +162,24 @@ activated with the <tt class="docutils literal"><span class="pre">--section-subt </div> <hr class="docutils" /> <div class="section" id="body-elements"> -<h1><a class="toc-backref" href="#id38">2 Body Elements</a></h1> +<h1><a class="toc-backref" href="#toc-entry-5">2 Body Elements</a></h1> <div class="section" id="paragraphs"> -<h2><a class="toc-backref" href="#id39">2.1 Paragraphs</a></h2> +<h2><a class="toc-backref" href="#toc-entry-6">2.1 Paragraphs</a></h2> <p>A paragraph.</p> <div class="section" id="inline-markup"> -<h3><a class="toc-backref" href="#id40">2.1.1 Inline Markup</a></h3> +<h3><a class="toc-backref" href="#toc-entry-7">2.1.1 Inline Markup</a></h3> <p>Paragraphs contain text and may contain inline markup: <em>emphasis</em>, <strong>strong emphasis</strong>, <tt class="docutils literal">inline literals</tt>, standalone hyperlinks -(<a class="reference external" href="http://www.python.org">http://www.python.org</a>), external hyperlinks (<a class="reference external" href="http://www.python.org/">Python</a> <a class="footnote-reference" href="#id25" id="id26">[5]</a>), internal +(<a class="reference external" href="http://www.python.org">http://www.python.org</a>), external hyperlinks (<a class="reference external" href="http://www.python.org/">Python</a> <a class="footnote-reference" href="#footnote-6" id="footnote-reference-10">[5]</a>), internal cross-references (<a class="reference internal" href="#example">example</a>), external hyperlinks with embedded URIs (<a class="reference external" href="http://www.python.org">Python web site</a>), <a class="reference external" href="http://www.python.org/">anonymous hyperlink -references</a> <a class="footnote-reference" href="#id25" id="id31">[5]</a> (<a class="reference external" href="http://docutils.sourceforge.net/">a second reference</a> <a class="footnote-reference" href="#id32" id="id33">[7]</a>), footnote references (manually -numbered <a class="footnote-reference" href="#id8" id="id1">[1]</a>, anonymous auto-numbered <a class="footnote-reference" href="#id12" id="id2">[3]</a>, labeled auto-numbered -<a class="footnote-reference" href="#label" id="id3">[2]</a>, or symbolic <a class="footnote-reference" href="#id13" id="id4">[*]</a>), citation references (<a class="citation-reference" href="#cit2002" id="id5">[CIT2002]</a>), +references</a> <a class="footnote-reference" href="#footnote-6" id="footnote-reference-14">[5]</a> (<a class="reference external" href="http://docutils.sourceforge.net/">a second reference</a> <a class="footnote-reference" href="#footnote-8" id="footnote-reference-15">[7]</a>), footnote references (manually +numbered <a class="footnote-reference" href="#footnote-1" id="footnote-reference-1">[1]</a>, anonymous auto-numbered <a class="footnote-reference" href="#footnote-2" id="footnote-reference-2">[3]</a>, labeled auto-numbered +<a class="footnote-reference" href="#label" id="footnote-reference-3">[2]</a>, or symbolic <a class="footnote-reference" href="#footnote-3" id="footnote-reference-4">[*]</a>), citation references (<a class="citation-reference" href="#cit2002" id="citation-reference-1">[CIT2002]</a>), substitution references (<img alt="EXAMPLE" src="../../../docs/user/rst/images/biohazard.png" /> & a <em>trimmed heart</em> <tt class="docutils literal">(U+2665):</tt>♥), and <span class="target" id="inline-hyperlink-targets">inline hyperlink targets</span> (see <a class="reference internal" href="#targets">Targets</a> below for a reference back to here). Character-level -inline markup is also possible (although exceedingly ugly!) in <em>re</em><tt class="docutils literal">Structured</tt><em>Text</em>. Problems are indicated by <a href="#id23"><span class="problematic" id="id24">|problematic|</span></a> text +inline markup is also possible (although exceedingly ugly!) in <em>re</em><tt class="docutils literal">Structured</tt><em>Text</em>. Problems are indicated by <a href="#system-message-1"><span class="problematic" id="problematic-1">|problematic|</span></a> text (generated by processing errors; this one is intentional). Here is a reference to the <a class="reference internal" href="#doctitle">doctitle</a> and the <a class="reference internal" href="#subtitle">subtitle</a>.</p> <p>The default role for interpreted text is <cite>Title Reference</cite>. Here are @@ -200,7 +200,7 @@ live link to PEP 258 here.</p> </div> </div> <div class="section" id="bullet-lists"> -<h2><a class="toc-backref" href="#id41">2.2 Bullet Lists</a></h2> +<h2><a class="toc-backref" href="#toc-entry-8">2.2 Bullet Lists</a></h2> <ul> <li><p class="first">A bullet list</p> <ul class="simple"> @@ -225,7 +225,7 @@ live link to PEP 258 here.</p> </ul> </div> <div class="section" id="enumerated-lists"> -<h2><a class="toc-backref" href="#id42">2.3 Enumerated Lists</a></h2> +<h2><a class="toc-backref" href="#toc-entry-9">2.3 Enumerated Lists</a></h2> <ol class="arabic"> <li><p class="first">Arabic numerals.</p> <ol class="loweralpha simple"> @@ -258,7 +258,7 @@ live link to PEP 258 here.</p> </ol> </div> <div class="section" id="definition-lists"> -<h2><a class="toc-backref" href="#id43">2.4 Definition Lists</a></h2> +<h2><a class="toc-backref" href="#toc-entry-10">2.4 Definition Lists</a></h2> <dl class="docutils"> <dt>Term</dt> <dd>Definition</dd> @@ -273,7 +273,7 @@ live link to PEP 258 here.</p> </dl> </div> <div class="section" id="field-lists"> -<h2><a class="toc-backref" href="#id44">2.5 Field Lists</a></h2> +<h2><a class="toc-backref" href="#toc-entry-11">2.5 Field Lists</a></h2> <table class="docutils field-list" frame="void" rules="none"> <col class="field-name" /> <col class="field-body" /> @@ -297,7 +297,7 @@ doesn't get stripped away.)</p> </table> </div> <div class="section" id="option-lists"> -<h2><a class="toc-backref" href="#id45">2.6 Option Lists</a></h2> +<h2><a class="toc-backref" href="#toc-entry-12">2.6 Option Lists</a></h2> <p>For listing command-line options:</p> <table class="docutils option-list" frame="void" rules="none"> <col class="option" /> @@ -343,7 +343,7 @@ regardless of where it starts.</p> description.</p> </div> <div class="section" id="literal-blocks"> -<h2><a class="toc-backref" href="#id46">2.7 Literal Blocks</a></h2> +<h2><a class="toc-backref" href="#toc-entry-13">2.7 Literal Blocks</a></h2> <p>Literal blocks are indicated with a double-colon ("::") at the end of the preceding paragraph (over there <tt class="docutils literal"><span class="pre">--></span></tt>). They can be indented:</p> <pre class="literal-block"> @@ -360,7 +360,7 @@ if literal_block: </pre> </div> <div class="section" id="line-blocks"> -<h2><a class="toc-backref" href="#id47">2.8 Line Blocks</a></h2> +<h2><a class="toc-backref" href="#toc-entry-14">2.8 Line Blocks</a></h2> <p>This section tests line blocks. Line blocks are body elements which consist of lines and other line blocks. Nested line blocks cause indentation.</p> @@ -434,7 +434,7 @@ also be centre-aligned:</p> </div> </div> <div class="section" id="block-quotes"> -<h2><a class="toc-backref" href="#id48">2.9 Block Quotes</a></h2> +<h2><a class="toc-backref" href="#toc-entry-15">2.9 Block Quotes</a></h2> <p>Block quotes consist of indented body elements:</p> <blockquote> <p>My theory by A. Elk. Brackets Miss, brackets. This theory goes @@ -452,7 +452,7 @@ ReStructuredText est un langage de balisage léger utilisé notamment dans la documentation du langage Python.</blockquote> </div> <div class="section" id="doctest-blocks"> -<h2><a class="toc-backref" href="#id49">2.10 Doctest Blocks</a></h2> +<h2><a class="toc-backref" href="#toc-entry-16">2.10 Doctest Blocks</a></h2> <pre class="doctest-block"> >>> print 'Python-specific usage examples; begun with ">>>"' Python-specific usage examples; begun with ">>>" @@ -461,11 +461,11 @@ Python-specific usage examples; begun with ">>>" </pre> </div> <div class="section" id="footnotes"> -<h2><a class="toc-backref" href="#id50">2.11 Footnotes</a></h2> -<table class="docutils footnote" frame="void" id="id8" rules="none"> +<h2><a class="toc-backref" href="#toc-entry-17">2.11 Footnotes</a></h2> +<table class="docutils footnote" frame="void" id="footnote-1" rules="none"> <colgroup><col class="label" /><col /></colgroup> <tbody valign="top"> -<tr><td class="label">[1]</td><td><em>(<a class="fn-backref" href="#id1">1</a>, <a class="fn-backref" href="#id9">2</a>, <a class="fn-backref" href="#id22">3</a>)</em> <p>A footnote contains body elements, consistently indented by at +<tr><td class="label">[1]</td><td><em>(<a class="fn-backref" href="#footnote-reference-1">1</a>, <a class="fn-backref" href="#footnote-reference-5">2</a>, <a class="fn-backref" href="#footnote-reference-9">3</a>)</em> <p>A footnote contains body elements, consistently indented by at least 3 spaces.</p> <p class="last">This is the footnote's second paragraph.</p> </td></tr> @@ -474,107 +474,107 @@ least 3 spaces.</p> <table class="docutils footnote" frame="void" id="label" rules="none"> <colgroup><col class="label" /><col /></colgroup> <tbody valign="top"> -<tr><td class="label">[2]</td><td><em>(<a class="fn-backref" href="#id3">1</a>, <a class="fn-backref" href="#id10">2</a>)</em> Footnotes may be numbered, either manually (as in <a class="footnote-reference" href="#id8" id="id9">[1]</a>) or +<tr><td class="label">[2]</td><td><em>(<a class="fn-backref" href="#footnote-reference-3">1</a>, <a class="fn-backref" href="#footnote-reference-6">2</a>)</em> Footnotes may be numbered, either manually (as in <a class="footnote-reference" href="#footnote-1" id="footnote-reference-5">[1]</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" href="#label" id="id10">[2]</a>) and as a <a class="reference internal" href="#label">hyperlink reference</a>.</td></tr> +footnote reference (<a class="footnote-reference" href="#label" id="footnote-reference-6">[2]</a>) and as a <a class="reference internal" href="#label">hyperlink reference</a>.</td></tr> </tbody> </table> -<table class="docutils footnote" frame="void" id="id12" rules="none"> +<table class="docutils footnote" frame="void" id="footnote-2" rules="none"> <colgroup><col class="label" /><col /></colgroup> <tbody valign="top"> -<tr><td class="label"><a class="fn-backref" href="#id2">[3]</a></td><td><p class="first">This footnote is numbered automatically and anonymously using a +<tr><td class="label"><a class="fn-backref" href="#footnote-reference-2">[3]</a></td><td><p class="first">This footnote is numbered automatically and anonymously using a label of "#" only.</p> <p>This is the second paragraph.</p> <p class="last">And this is the third paragraph.</p> </td></tr> </tbody> </table> -<table class="docutils footnote" frame="void" id="id13" rules="none"> +<table class="docutils footnote" frame="void" id="footnote-3" rules="none"> <colgroup><col class="label" /><col /></colgroup> <tbody valign="top"> -<tr><td class="label"><a class="fn-backref" href="#id4">[*]</a></td><td>Footnotes may also use symbols, specified with a "*" label. -Here's a reference to the next footnote: <a class="footnote-reference" href="#id15" id="id14">[†]</a>.</td></tr> +<tr><td class="label"><a class="fn-backref" href="#footnote-reference-4">[*]</a></td><td>Footnotes may also use symbols, specified with a "*" label. +Here's a reference to the next footnote: <a class="footnote-reference" href="#footnote-4" id="footnote-reference-7">[†]</a>.</td></tr> </tbody> </table> -<table class="docutils footnote" frame="void" id="id15" rules="none"> +<table class="docutils footnote" frame="void" id="footnote-4" rules="none"> <colgroup><col class="label" /><col /></colgroup> <tbody valign="top"> -<tr><td class="label"><a class="fn-backref" href="#id14">[†]</a></td><td>This footnote shows the next symbol in the sequence.</td></tr> +<tr><td class="label"><a class="fn-backref" href="#footnote-reference-7">[†]</a></td><td>This footnote shows the next symbol in the sequence.</td></tr> </tbody> </table> -<table class="docutils footnote" frame="void" id="id16" rules="none"> +<table class="docutils footnote" frame="void" id="footnote-5" rules="none"> <colgroup><col class="label" /><col /></colgroup> <tbody valign="top"> <tr><td class="label">[4]</td><td>Here's an unreferenced footnote, with a reference to a -nonexistent footnote: <a href="#id86"><span class="problematic" id="id17">[5]_</span></a>.</td></tr> +nonexistent footnote: <a href="#system-message-2"><span class="problematic" id="footnote-reference-8">[5]_</span></a>.</td></tr> </tbody> </table> </div> <div class="section" id="citations"> -<h2><a class="toc-backref" href="#id51">2.12 Citations</a></h2> +<h2><a class="toc-backref" href="#toc-entry-18">2.12 Citations</a></h2> <table class="docutils citation" frame="void" id="cit2002" rules="none"> <colgroup><col class="label" /><col /></colgroup> <tbody valign="top"> -<tr><td class="label">[CIT2002]</td><td><em>(<a class="fn-backref" href="#id5">1</a>, <a class="fn-backref" href="#id18">2</a>)</em> Citations are text-labeled footnotes. They may be +<tr><td class="label">[CIT2002]</td><td><em>(<a class="fn-backref" href="#citation-reference-1">1</a>, <a class="fn-backref" href="#citation-reference-2">2</a>)</em> Citations are text-labeled footnotes. They may be rendered separately and differently from footnotes.</td></tr> </tbody> </table> -<p>Here's a reference to the above, <a class="citation-reference" href="#cit2002" id="id18">[CIT2002]</a>, and a <a href="#id87"><span class="problematic" id="id19">[nonexistent]_</span></a> +<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> </div> <div class="section" id="targets"> -<span id="another-target"></span><h2><a class="toc-backref" href="#id52">2.13 Targets</a></h2> +<span id="another-target"></span><h2><a class="toc-backref" href="#toc-entry-19">2.13 Targets</a></h2> <p id="example">This paragraph is pointed to by the explicit "example" target. A reference can be found under <a class="reference internal" href="#inline-markup">Inline Markup</a>, above. <a class="reference internal" href="#inline-hyperlink-targets">Inline hyperlink targets</a> are also possible.</p> <p>Section headers are implicit targets, referred to by name. See <a class="reference internal" href="#targets">Targets</a>, which is a subsection of <a class="reference internal" href="#body-elements">Body Elements</a>.</p> <p>Explicit external targets are interpolated into references such as -"<a class="reference external" href="http://www.python.org/">Python</a> <a class="footnote-reference" href="#id25" id="id27">[5]</a>".</p> +"<a class="reference external" href="http://www.python.org/">Python</a> <a class="footnote-reference" href="#footnote-6" id="footnote-reference-11">[5]</a>".</p> <p>Targets may be indirect and anonymous. Thus <a class="reference internal" href="#targets">this phrase</a> may also refer to the <a class="reference internal" href="#targets">Targets</a> section.</p> -<p>Here's a <a href="#id88"><span class="problematic" id="id89">`hyperlink reference without a target`_</span></a>, which generates an +<p>Here's a <a href="#system-message-4"><span class="problematic" id="problematic-2">`hyperlink reference without a target`_</span></a>, which generates an error.</p> <div class="section" id="duplicate-target-names"> -<h3><a class="toc-backref" href="#id53">2.13.1 Duplicate Target Names</a></h3> +<h3><a class="toc-backref" href="#toc-entry-20">2.13.1 Duplicate Target Names</a></h3> <p>Duplicate names in section headers or other implicit targets will generate "info" (level-1) system messages. Duplicate names in explicit targets will generate "warning" (level-2) system messages.</p> </div> -<div class="section" id="id21"> -<h3><a class="toc-backref" href="#id54">2.13.2 Duplicate Target Names</a></h3> +<div class="section" id="duplicate-target-names-1"> +<h3><a class="toc-backref" href="#toc-entry-21">2.13.2 Duplicate Target Names</a></h3> <p>Since there are two "Duplicate Target Names" section headers, we cannot uniquely refer to either of them by name. If we try to (like -this: <a href="#id90"><span class="problematic" id="id91">`Duplicate Target Names`_</span></a>), an error is generated.</p> +this: <a href="#system-message-5"><span class="problematic" id="problematic-3">`Duplicate Target Names`_</span></a>), an error is generated.</p> </div> </div> <div class="section" id="directives"> -<h2><a class="toc-backref" href="#id55">2.14 Directives</a></h2> +<h2><a class="toc-backref" href="#toc-entry-22">2.14 Directives</a></h2> <div class="contents local topic" id="contents"> <ul class="auto-toc simple"> -<li><a class="reference internal" href="#document-parts" id="id77">2.14.1 Document Parts</a></li> -<li><a class="reference internal" href="#images-and-figures" id="id78">2.14.2 Images and Figures</a></li> -<li><a class="reference internal" href="#admonitions" id="id79">2.14.3 Admonitions</a></li> -<li><a class="reference internal" href="#topics-sidebars-and-rubrics" id="id80">2.14.4 Topics, Sidebars, and Rubrics</a></li> -<li><a class="reference internal" href="#target-footnotes" id="id81">2.14.5 Target Footnotes</a></li> -<li><a class="reference internal" href="#replacement-text" id="id82">2.14.6 Replacement Text</a></li> -<li><a class="reference internal" href="#compound-paragraph" id="id83">2.14.7 Compound Paragraph</a></li> -<li><a class="reference internal" href="#parsed-literal-blocks" id="id84">2.14.8 Parsed Literal Blocks</a></li> -<li><a class="reference internal" href="#code" id="id85">2.14.9 Code</a></li> +<li><a class="reference internal" href="#document-parts" id="toc-entry-44">2.14.1 Document Parts</a></li> +<li><a class="reference internal" href="#images-and-figures" id="toc-entry-45">2.14.2 Images and Figures</a></li> +<li><a class="reference internal" href="#admonitions" id="toc-entry-46">2.14.3 Admonitions</a></li> +<li><a class="reference internal" href="#topics-sidebars-and-rubrics" id="toc-entry-47">2.14.4 Topics, Sidebars, and Rubrics</a></li> +<li><a class="reference internal" href="#target-footnotes" id="toc-entry-48">2.14.5 Target Footnotes</a></li> +<li><a class="reference internal" href="#replacement-text" id="toc-entry-49">2.14.6 Replacement Text</a></li> +<li><a class="reference internal" href="#compound-paragraph" id="toc-entry-50">2.14.7 Compound Paragraph</a></li> +<li><a class="reference internal" href="#parsed-literal-blocks" id="toc-entry-51">2.14.8 Parsed Literal Blocks</a></li> +<li><a class="reference internal" href="#code" id="toc-entry-52">2.14.9 Code</a></li> </ul> </div> <p>These are just a sample of the many reStructuredText Directives. For others, please see <a class="reference external" href="http://docutils.sourceforge.net/docs/ref/rst/directives.html">http://docutils.sourceforge.net/docs/ref/rst/directives.html</a>.</p> <div class="section" id="document-parts"> -<h3><a class="toc-backref" href="#id77">2.14.1 Document Parts</a></h3> +<h3><a class="toc-backref" href="#toc-entry-44">2.14.1 Document Parts</a></h3> <p>An example of the "contents" directive can be seen above this section (a local, untitled table of <a class="reference internal" href="#contents">contents</a>) and at the beginning of the document (a document-wide <a class="reference internal" href="#table-of-contents">table of contents</a>).</p> </div> <div class="section" id="images-and-figures"> -<h3><a class="toc-backref" href="#id78">2.14.2 Images and Figures</a></h3> +<h3><a class="toc-backref" href="#toc-entry-45">2.14.2 Images and Figures</a></h3> <p>An image directive (also clickable -- a hyperlink reference):</p> <a class="reference internal image-reference" href="#directives"><img alt="../../../docs/user/rst/images/title.png" class="class1 class2" src="../../../docs/user/rst/images/title.png" /></a> <p>Image with multiple IDs:</p> @@ -756,7 +756,7 @@ writer/backend).</p> </table> </div> <div class="section" id="admonitions"> -<h3><a class="toc-backref" href="#id79">2.14.3 Admonitions</a></h3> +<h3><a class="toc-backref" href="#toc-entry-46">2.14.3 Admonitions</a></h3> <div class="admonition attention"> <p class="first admonition-title">Attention!</p> <p class="last">Directives at large.</p> @@ -805,7 +805,7 @@ Reader discretion is strongly advised.</p> </div> </div> <div class="section" id="topics-sidebars-and-rubrics"> -<h3><a class="toc-backref" href="#id80">2.14.4 Topics, Sidebars, and Rubrics</a></h3> +<h3><a class="toc-backref" href="#toc-entry-47">2.14.4 Topics, Sidebars, and Rubrics</a></h3> <p><em>Sidebars</em> are like miniature, parallel documents.</p> <div class="sidebar"> <p class="first sidebar-title">Sidebar Title</p> @@ -829,32 +829,32 @@ document's structure. It is typically highlighted in red (hence the name).</p> allowed (e.g. inside a directive).</p> </div> <div class="section" id="target-footnotes"> -<h3><a class="toc-backref" href="#id81">2.14.5 Target Footnotes</a></h3> -<table class="docutils footnote" frame="void" id="id25" rules="none"> +<h3><a class="toc-backref" href="#toc-entry-48">2.14.5 Target Footnotes</a></h3> +<table class="docutils footnote" frame="void" id="footnote-6" rules="none"> <colgroup><col class="label" /><col /></colgroup> <tbody valign="top"> -<tr><td class="label">[5]</td><td><em>(<a class="fn-backref" href="#id26">1</a>, <a class="fn-backref" href="#id27">2</a>, <a class="fn-backref" href="#id28">3</a>, <a class="fn-backref" href="#id31">4</a>)</em> <a class="reference external" href="http://www.python.org/">http://www.python.org/</a></td></tr> +<tr><td class="label">[5]</td><td><em>(<a class="fn-backref" href="#footnote-reference-10">1</a>, <a class="fn-backref" href="#footnote-reference-11">2</a>, <a class="fn-backref" href="#footnote-reference-12">3</a>, <a class="fn-backref" href="#footnote-reference-14">4</a>)</em> <a class="reference external" href="http://www.python.org/">http://www.python.org/</a></td></tr> </tbody> </table> -<table class="docutils footnote" frame="void" id="id29" rules="none"> +<table class="docutils footnote" frame="void" id="footnote-7" rules="none"> <colgroup><col class="label" /><col /></colgroup> <tbody valign="top"> -<tr><td class="label"><a class="fn-backref" href="#id30">[6]</a></td><td><a class="reference external" href="http://pygments.org/">http://pygments.org/</a></td></tr> +<tr><td class="label"><a class="fn-backref" href="#footnote-reference-13">[6]</a></td><td><a class="reference external" href="http://pygments.org/">http://pygments.org/</a></td></tr> </tbody> </table> -<table class="docutils footnote" frame="void" id="id32" rules="none"> +<table class="docutils footnote" frame="void" id="footnote-8" rules="none"> <colgroup><col class="label" /><col /></colgroup> <tbody valign="top"> -<tr><td class="label"><a class="fn-backref" href="#id33">[7]</a></td><td><a class="reference external" href="http://docutils.sourceforge.net/">http://docutils.sourceforge.net/</a></td></tr> +<tr><td class="label"><a class="fn-backref" href="#footnote-reference-15">[7]</a></td><td><a class="reference external" href="http://docutils.sourceforge.net/">http://docutils.sourceforge.net/</a></td></tr> </tbody> </table> </div> <div class="section" id="replacement-text"> -<h3><a class="toc-backref" href="#id82">2.14.6 Replacement Text</a></h3> -<p>I recommend you try <a class="reference external" href="http://www.python.org/">Python, <em>the</em> best language around</a> <a class="footnote-reference" href="#id25" id="id28">[5]</a>.</p> +<h3><a class="toc-backref" href="#toc-entry-49">2.14.6 Replacement Text</a></h3> +<p>I recommend you try <a class="reference external" href="http://www.python.org/">Python, <em>the</em> best language around</a> <a class="footnote-reference" href="#footnote-6" id="footnote-reference-12">[5]</a>.</p> </div> <div class="section" id="compound-paragraph"> -<h3><a class="toc-backref" href="#id83">2.14.7 Compound Paragraph</a></h3> +<h3><a class="toc-backref" href="#toc-entry-50">2.14.7 Compound Paragraph</a></h3> <p>The <em>compound</em> directive is used to create a "compound paragraph", which is a single logical paragraph containing multiple physical body elements. For example:</p> @@ -974,7 +974,7 @@ a quote and</blockquote> </div> </div> <div class="section" id="parsed-literal-blocks"> -<h3><a class="toc-backref" href="#id84">2.14.8 Parsed Literal Blocks</a></h3> +<h3><a class="toc-backref" href="#toc-entry-51">2.14.8 Parsed Literal Blocks</a></h3> <pre class="literal-block"> This is a parsed literal block. This line is indented. The next line is blank. @@ -982,13 +982,13 @@ This is a parsed literal block. Inline markup is supported, e.g. <em>emphasis</em>, <strong>strong</strong>, <tt class="docutils literal">literal text</tt>, <span class="subscript">sub-</span> and <span class="superscript">super</span>scripts, inline formulas: <span class="formula"><i>A</i> = 2<i>π</i><i>r</i><sup>2</sup></span>, -footnotes <a class="footnote-reference" href="#id8" id="id22">[1]</a>, <span class="target" id="hyperlink-targets">hyperlink targets</span>, and <a class="reference external" href="http://www.python.org/">references</a>. +footnotes <a class="footnote-reference" href="#footnote-1" id="footnote-reference-9">[1]</a>, <span class="target" id="hyperlink-targets">hyperlink targets</span>, and <a class="reference external" href="http://www.python.org/">references</a>. </pre> </div> <div class="section" id="code"> -<h3><a class="toc-backref" href="#id85">2.14.9 Code</a></h3> +<h3><a class="toc-backref" href="#toc-entry-52">2.14.9 Code</a></h3> <p>Blocks of source code can be set with the <cite>code</cite> directive. If the code -language is specified, the content is parsed and tagged by the <a class="reference external" href="http://pygments.org/">Pygments</a> <a class="footnote-reference" href="#id29" id="id30">[6]</a> +language is specified, the content is parsed and tagged by the <a class="reference external" href="http://pygments.org/">Pygments</a> <a class="footnote-reference" href="#footnote-7" id="footnote-reference-13">[6]</a> syntax highlighter and can be formatted with a style sheet. (Code parsing is turned off using the <tt class="docutils literal"><span class="pre">syntax-highlight</span></tt> config setting in the test conversions in order to get identical results with/without installed @@ -1018,13 +1018,13 @@ as a code block, here the rst file <tt class="docutils literal">header_footer.tx </div> </div> <div class="section" id="substitution-definitions"> -<h2><a class="toc-backref" href="#id65">2.15 Substitution Definitions</a></h2> +<h2><a class="toc-backref" href="#toc-entry-32">2.15 Substitution Definitions</a></h2> <p>An inline image (<img alt="EXAMPLE" src="../../../docs/user/rst/images/biohazard.png" />) example:</p> <p>A Unicode example:</p> <p>(Substitution definitions are not visible in the HTML source.)</p> </div> <div class="section" id="comments"> -<h2><a class="toc-backref" href="#id66">2.16 Comments</a></h2> +<h2><a class="toc-backref" href="#toc-entry-33">2.16 Comments</a></h2> <p>Here's one:</p> <!-- Comments begin with two dots and a space. Anything may follow, except for the syntax of footnotes, hyperlink @@ -1036,20 +1036,20 @@ Comments may contain non-ASCII characters: ä ö ü æ ø å --> <p>(View the HTML source to see the comment.)</p> </div> <div class="section" id="raw-text"> -<h2><a class="toc-backref" href="#id67">2.17 Raw text</a></h2> +<h2><a class="toc-backref" href="#toc-entry-34">2.17 Raw text</a></h2> <p>This does not necessarily look nice, because there may be missing white space.</p> <p>It's just there to freeze the behavior.</p> A test.Second test.<div class="myclass">Another test with myclass set.</div><p>This is the <span class="myrawroleclass">fourth test</span> with myrawroleclass set.</p> Fifth test in HTML.<br />Line two.</div> <div class="section" id="container"> -<h2><a class="toc-backref" href="#id68">2.18 Container</a></h2> +<h2><a class="toc-backref" href="#toc-entry-35">2.18 Container</a></h2> <div class="custom docutils container"> <p>paragraph 1</p> <p>paragraph 2</p> </div> </div> <div class="section" id="colspanning-tables"> -<h2><a class="toc-backref" href="#id69">2.19 Colspanning tables</a></h2> +<h2><a class="toc-backref" href="#toc-entry-36">2.19 Colspanning tables</a></h2> <p>This table has a cell spanning two columns:</p> <table border="1" class="docutils"> <colgroup> @@ -1087,7 +1087,7 @@ Fifth test in HTML.<br />Line two.</div> </table> </div> <div class="section" id="rowspanning-tables"> -<h2><a class="toc-backref" href="#id70">2.20 Rowspanning tables</a></h2> +<h2><a class="toc-backref" href="#toc-entry-37">2.20 Rowspanning tables</a></h2> <p>Here's a table with cells spanning several rows:</p> <table border="1" class="docutils"> <colgroup> @@ -1120,7 +1120,7 @@ cell.</td> </table> </div> <div class="section" id="complex-tables"> -<h2><a class="toc-backref" href="#id71">2.21 Complex tables</a></h2> +<h2><a class="toc-backref" href="#toc-entry-38">2.21 Complex tables</a></h2> <p>Here's a complex table, which should test all features.</p> <table border="1" class="docutils"> <colgroup> @@ -1169,7 +1169,7 @@ empty: <tt class="docutils literal"><span class="pre">--></span></tt></td> </table> </div> <div class="section" id="list-tables"> -<h2><a class="toc-backref" href="#id72">2.22 List Tables</a></h2> +<h2><a class="toc-backref" href="#toc-entry-39">2.22 List Tables</a></h2> <p>Here's a list table exercising all features:</p> <table border="1" class="colwidths-given test docutils" style="width: 40em"> <caption>list table with integral header</caption> @@ -1216,7 +1216,7 @@ crunchy, now would it?</td> </table> </div> <div class="section" id="custom-roles"> -<h2><a class="toc-backref" href="#id73">2.23 Custom Roles</a></h2> +<h2><a class="toc-backref" href="#toc-entry-40">2.23 Custom Roles</a></h2> <ul> <li><p class="first">A role based on an existing role.</p> <p><tt class="custom docutils literal">one</tt> <tt class="custom docutils literal">two</tt> <tt class="custom docutils literal">three</tt></p> @@ -1246,7 +1246,7 @@ crunchy, now would it?</td> </ul> </div> <div class="section" id="svg-images"> -<h2><a class="toc-backref" href="#id74">2.24 SVG Images</a></h2> +<h2><a class="toc-backref" href="#toc-entry-41">2.24 SVG Images</a></h2> <object class="align-left" data="../../../docs/user/rst/images/biohazard.svg" style="width: 48px; height: 48px;" type="image/svg+xml"> ../../../docs/user/rst/images/biohazard.svg</object> <p>Scalable vector graphics (SVG) images are the only standards-compliable way @@ -1342,7 +1342,7 @@ reStructuredText, the markup syntax</object> </blockquote> </div> <div class="section" id="swf-images"> -<h2><a class="toc-backref" href="#id75">2.25 SWF Images</a></h2> +<h2><a class="toc-backref" href="#toc-entry-42">2.25 SWF Images</a></h2> <p>Shockwave Flash is an image/movie format that most modern web browsers support via a plugin. It is sometimes blocked due to privacy/security concerns.</p> @@ -1355,7 +1355,7 @@ For complete control over display options use raw HTML.</p> </div> </div> <div class="section" id="error-handling"> -<h1><a class="toc-backref" href="#id76">3 Error Handling</a></h1> +<h1><a class="toc-backref" href="#toc-entry-43">3 Error Handling</a></h1> <p>Any errors caught during processing will generate system messages.</p> <p>There should be five messages in the following, auto-generated section, "Docutils System Messages":</p> @@ -1363,20 +1363,20 @@ section, "Docutils System Messages":</p> </div> <div class="system-messages section"> <h1>Docutils System Messages</h1> -<div class="system-message" id="id23"> -<p class="system-message-title">System Message: ERROR/3 (<tt class="docutils">functional/input/data/standard.txt</tt>, line 104); <em><a href="#id24">backlink</a></em></p> +<div class="system-message" id="system-message-1"> +<p class="system-message-title">System Message: ERROR/3 (<tt class="docutils">functional/input/data/standard.txt</tt>, line 104); <em><a href="#problematic-1">backlink</a></em></p> Undefined substitution referenced: "problematic".</div> -<div class="system-message" id="id86"> -<p class="system-message-title">System Message: ERROR/3 (<tt class="docutils">functional/input/data/standard.txt</tt>, line 392); <em><a href="#id17">backlink</a></em></p> +<div class="system-message" id="system-message-2"> +<p class="system-message-title">System Message: ERROR/3 (<tt class="docutils">functional/input/data/standard.txt</tt>, line 392); <em><a href="#footnote-reference-8">backlink</a></em></p> Unknown target name: "5".</div> -<div class="system-message" id="id87"> -<p class="system-message-title">System Message: ERROR/3 (<tt class="docutils">functional/input/data/standard.txt</tt>, line 401); <em><a href="#id19">backlink</a></em></p> +<div class="system-message" id="system-message-3"> +<p class="system-message-title">System Message: ERROR/3 (<tt class="docutils">functional/input/data/standard.txt</tt>, line 401); <em><a href="#citation-reference-3">backlink</a></em></p> Unknown target name: "nonexistent".</div> -<div class="system-message" id="id88"> -<p class="system-message-title">System Message: ERROR/3 (<tt class="docutils">functional/input/data/standard.txt</tt>, line 428); <em><a href="#id89">backlink</a></em></p> +<div class="system-message" id="system-message-4"> +<p class="system-message-title">System Message: ERROR/3 (<tt class="docutils">functional/input/data/standard.txt</tt>, line 428); <em><a href="#problematic-2">backlink</a></em></p> Unknown target name: "hyperlink reference without a target".</div> -<div class="system-message" id="id90"> -<p class="system-message-title">System Message: ERROR/3 (<tt class="docutils">functional/input/data/standard.txt</tt>, line 441); <em><a href="#id91">backlink</a></em></p> +<div class="system-message" id="system-message-5"> +<p class="system-message-title">System Message: ERROR/3 (<tt class="docutils">functional/input/data/standard.txt</tt>, line 441); <em><a href="#problematic-3">backlink</a></em></p> Duplicate target name, cannot be used as a unique reference: "duplicate target names".</div> </div> </div> diff --git a/docutils/test/functional/expected/standalone_rst_html5.html b/docutils/test/functional/expected/standalone_rst_html5.html index e13f02ba0..d89734dce 100644 --- a/docutils/test/functional/expected/standalone_rst_html5.html +++ b/docutils/test/functional/expected/standalone_rst_html5.html @@ -86,98 +86,98 @@ They are transformed from section titles after parsing. --> <div class="contents topic" id="table-of-contents"> <p class="topic-title">Table of Contents</p> <ul class="auto-toc simple"> -<li><p><a class="reference internal" href="#structural-elements" id="id55"><span class="sectnum">1</span> Structural Elements</a></p> +<li><p><a class="reference internal" href="#structural-elements" id="toc-entry-1"><span class="sectnum">1</span> Structural Elements</a></p> <ul class="auto-toc"> -<li><p><a class="reference internal" href="#section-title" id="id56"><span class="sectnum">1.1</span> Section Title</a></p></li> -<li><p><a class="reference internal" href="#empty-section" id="id57"><span class="sectnum">1.2</span> Empty Section</a></p></li> -<li><p><a class="reference internal" href="#transitions" id="id58"><span class="sectnum">1.3</span> Transitions</a></p></li> +<li><p><a class="reference internal" href="#section-title" id="toc-entry-2"><span class="sectnum">1.1</span> Section Title</a></p></li> +<li><p><a class="reference internal" href="#empty-section" id="toc-entry-3"><span class="sectnum">1.2</span> Empty Section</a></p></li> +<li><p><a class="reference internal" href="#transitions" id="toc-entry-4"><span class="sectnum">1.3</span> Transitions</a></p></li> </ul> </li> -<li><p><a class="reference internal" href="#body-elements" id="id59"><span class="sectnum">2</span> Body Elements</a></p> +<li><p><a class="reference internal" href="#body-elements" id="toc-entry-5"><span class="sectnum">2</span> Body Elements</a></p> <ul class="auto-toc"> -<li><p><a class="reference internal" href="#paragraphs" id="id60"><span class="sectnum">2.1</span> Paragraphs</a></p> +<li><p><a class="reference internal" href="#paragraphs" id="toc-entry-6"><span class="sectnum">2.1</span> Paragraphs</a></p> <ul class="auto-toc"> -<li><p><a class="reference internal" href="#inline-markup" id="id61"><span class="sectnum">2.1.1</span> Inline Markup</a></p></li> +<li><p><a class="reference internal" href="#inline-markup" id="toc-entry-7"><span class="sectnum">2.1.1</span> Inline Markup</a></p></li> </ul> </li> -<li><p><a class="reference internal" href="#bullet-lists" id="id62"><span class="sectnum">2.2</span> Bullet Lists</a></p></li> -<li><p><a class="reference internal" href="#enumerated-lists" id="id63"><span class="sectnum">2.3</span> Enumerated Lists</a></p></li> -<li><p><a class="reference internal" href="#definition-lists" id="id64"><span class="sectnum">2.4</span> Definition Lists</a></p></li> -<li><p><a class="reference internal" href="#field-lists" id="id65"><span class="sectnum">2.5</span> Field Lists</a></p></li> -<li><p><a class="reference internal" href="#option-lists" id="id66"><span class="sectnum">2.6</span> Option Lists</a></p></li> -<li><p><a class="reference internal" href="#literal-blocks" id="id67"><span class="sectnum">2.7</span> Literal Blocks</a></p></li> -<li><p><a class="reference internal" href="#line-blocks" id="id68"><span class="sectnum">2.8</span> Line Blocks</a></p></li> -<li><p><a class="reference internal" href="#block-quotes" id="id69"><span class="sectnum">2.9</span> Block Quotes</a></p></li> -<li><p><a class="reference internal" href="#doctest-blocks" id="id70"><span class="sectnum">2.10</span> Doctest Blocks</a></p></li> -<li><p><a class="reference internal" href="#footnotes" id="id71"><span class="sectnum">2.11</span> Footnotes</a></p></li> -<li><p><a class="reference internal" href="#citations" id="id72"><span class="sectnum">2.12</span> Citations</a></p></li> -<li><p><a class="reference internal" href="#targets" id="id73"><span class="sectnum">2.13</span> Targets</a></p> +<li><p><a class="reference internal" href="#bullet-lists" id="toc-entry-8"><span class="sectnum">2.2</span> Bullet Lists</a></p></li> +<li><p><a class="reference internal" href="#enumerated-lists" id="toc-entry-9"><span class="sectnum">2.3</span> Enumerated Lists</a></p></li> +<li><p><a class="reference internal" href="#definition-lists" id="toc-entry-10"><span class="sectnum">2.4</span> Definition Lists</a></p></li> +<li><p><a class="reference internal" href="#field-lists" id="toc-entry-11"><span class="sectnum">2.5</span> Field Lists</a></p></li> +<li><p><a class="reference internal" href="#option-lists" id="toc-entry-12"><span class="sectnum">2.6</span> Option Lists</a></p></li> +<li><p><a class="reference internal" href="#literal-blocks" id="toc-entry-13"><span class="sectnum">2.7</span> Literal Blocks</a></p></li> +<li><p><a class="reference internal" href="#line-blocks" id="toc-entry-14"><span class="sectnum">2.8</span> Line Blocks</a></p></li> +<li><p><a class="reference internal" href="#block-quotes" id="toc-entry-15"><span class="sectnum">2.9</span> Block Quotes</a></p></li> +<li><p><a class="reference internal" href="#doctest-blocks" id="toc-entry-16"><span class="sectnum">2.10</span> Doctest Blocks</a></p></li> +<li><p><a class="reference internal" href="#footnotes" id="toc-entry-17"><span class="sectnum">2.11</span> Footnotes</a></p></li> +<li><p><a class="reference internal" href="#citations" id="toc-entry-18"><span class="sectnum">2.12</span> Citations</a></p></li> +<li><p><a class="reference internal" href="#targets" id="toc-entry-19"><span class="sectnum">2.13</span> Targets</a></p> <ul class="auto-toc"> -<li><p><a class="reference internal" href="#duplicate-target-names" id="id74"><span class="sectnum">2.13.1</span> Duplicate Target Names</a></p></li> -<li><p><a class="reference internal" href="#id21" id="id75"><span class="sectnum">2.13.2</span> Duplicate Target Names</a></p></li> +<li><p><a class="reference internal" href="#duplicate-target-names" id="toc-entry-20"><span class="sectnum">2.13.1</span> Duplicate Target Names</a></p></li> +<li><p><a class="reference internal" href="#duplicate-target-names-1" id="toc-entry-21"><span class="sectnum">2.13.2</span> Duplicate Target Names</a></p></li> </ul> </li> -<li><p><a class="reference internal" href="#directives" id="id76"><span class="sectnum">2.14</span> Directives</a></p> +<li><p><a class="reference internal" href="#directives" id="toc-entry-22"><span class="sectnum">2.14</span> Directives</a></p> <ul class="auto-toc"> -<li><p><a class="reference internal" href="#document-parts" id="id77"><span class="sectnum">2.14.1</span> Document Parts</a></p></li> -<li><p><a class="reference internal" href="#images-and-figures" id="id78"><span class="sectnum">2.14.2</span> Images and Figures</a></p></li> -<li><p><a class="reference internal" href="#admonitions" id="id79"><span class="sectnum">2.14.3</span> Admonitions</a></p></li> -<li><p><a class="reference internal" href="#topics-sidebars-and-rubrics" id="id80"><span class="sectnum">2.14.4</span> Topics, Sidebars, and Rubrics</a></p></li> -<li><p><a class="reference internal" href="#target-footnotes" id="id81"><span class="sectnum">2.14.5</span> Target Footnotes</a></p></li> -<li><p><a class="reference internal" href="#replacement-text" id="id82"><span class="sectnum">2.14.6</span> Replacement Text</a></p></li> -<li><p><a class="reference internal" href="#compound-paragraph" id="id83"><span class="sectnum">2.14.7</span> Compound Paragraph</a></p></li> -<li><p><a class="reference internal" href="#parsed-literal-blocks" id="id84"><span class="sectnum">2.14.8</span> Parsed Literal Blocks</a></p></li> -<li><p><a class="reference internal" href="#code" id="id85"><span class="sectnum">2.14.9</span> Code</a></p></li> +<li><p><a class="reference internal" href="#document-parts" id="toc-entry-23"><span class="sectnum">2.14.1</span> Document Parts</a></p></li> +<li><p><a class="reference internal" href="#images-and-figures" id="toc-entry-24"><span class="sectnum">2.14.2</span> Images and Figures</a></p></li> +<li><p><a class="reference internal" href="#admonitions" id="toc-entry-25"><span class="sectnum">2.14.3</span> Admonitions</a></p></li> +<li><p><a class="reference internal" href="#topics-sidebars-and-rubrics" id="toc-entry-26"><span class="sectnum">2.14.4</span> Topics, Sidebars, and Rubrics</a></p></li> +<li><p><a class="reference internal" href="#target-footnotes" id="toc-entry-27"><span class="sectnum">2.14.5</span> Target Footnotes</a></p></li> +<li><p><a class="reference internal" href="#replacement-text" id="toc-entry-28"><span class="sectnum">2.14.6</span> Replacement Text</a></p></li> +<li><p><a class="reference internal" href="#compound-paragraph" id="toc-entry-29"><span class="sectnum">2.14.7</span> Compound Paragraph</a></p></li> +<li><p><a class="reference internal" href="#parsed-literal-blocks" id="toc-entry-30"><span class="sectnum">2.14.8</span> Parsed Literal Blocks</a></p></li> +<li><p><a class="reference internal" href="#code" id="toc-entry-31"><span class="sectnum">2.14.9</span> Code</a></p></li> </ul> </li> -<li><p><a class="reference internal" href="#substitution-definitions" id="id86"><span class="sectnum">2.15</span> Substitution Definitions</a></p></li> -<li><p><a class="reference internal" href="#comments" id="id87"><span class="sectnum">2.16</span> Comments</a></p></li> -<li><p><a class="reference internal" href="#raw-text" id="id88"><span class="sectnum">2.17</span> Raw text</a></p></li> -<li><p><a class="reference internal" href="#container" id="id89"><span class="sectnum">2.18</span> Container</a></p></li> -<li><p><a class="reference internal" href="#colspanning-tables" id="id90"><span class="sectnum">2.19</span> Colspanning tables</a></p></li> -<li><p><a class="reference internal" href="#rowspanning-tables" id="id91"><span class="sectnum">2.20</span> Rowspanning tables</a></p></li> -<li><p><a class="reference internal" href="#complex-tables" id="id92"><span class="sectnum">2.21</span> Complex tables</a></p></li> -<li><p><a class="reference internal" href="#list-tables" id="id93"><span class="sectnum">2.22</span> List Tables</a></p></li> -<li><p><a class="reference internal" href="#custom-roles" id="id94"><span class="sectnum">2.23</span> Custom Roles</a></p></li> +<li><p><a class="reference internal" href="#substitution-definitions" id="toc-entry-32"><span class="sectnum">2.15</span> Substitution Definitions</a></p></li> +<li><p><a class="reference internal" href="#comments" id="toc-entry-33"><span class="sectnum">2.16</span> Comments</a></p></li> +<li><p><a class="reference internal" href="#raw-text" id="toc-entry-34"><span class="sectnum">2.17</span> Raw text</a></p></li> +<li><p><a class="reference internal" href="#container" id="toc-entry-35"><span class="sectnum">2.18</span> Container</a></p></li> +<li><p><a class="reference internal" href="#colspanning-tables" id="toc-entry-36"><span class="sectnum">2.19</span> Colspanning tables</a></p></li> +<li><p><a class="reference internal" href="#rowspanning-tables" id="toc-entry-37"><span class="sectnum">2.20</span> Rowspanning tables</a></p></li> +<li><p><a class="reference internal" href="#complex-tables" id="toc-entry-38"><span class="sectnum">2.21</span> Complex tables</a></p></li> +<li><p><a class="reference internal" href="#list-tables" id="toc-entry-39"><span class="sectnum">2.22</span> List Tables</a></p></li> +<li><p><a class="reference internal" href="#custom-roles" id="toc-entry-40"><span class="sectnum">2.23</span> Custom Roles</a></p></li> </ul> </li> -<li><p><a class="reference internal" href="#html-specific" id="id95"><span class="sectnum">3</span> HTML specific</a></p> +<li><p><a class="reference internal" href="#html-specific" id="toc-entry-41"><span class="sectnum">3</span> HTML specific</a></p> <ul class="auto-toc"> -<li><p><a class="reference internal" href="#svg-images" id="id96"><span class="sectnum">3.1</span> SVG Images</a></p></li> -<li><p><a class="reference internal" href="#swf-images" id="id97"><span class="sectnum">3.2</span> SWF Images</a></p></li> -<li><p><a class="reference internal" href="#text-level-semantics" id="id98"><span class="sectnum">3.3</span> Text-level semantics</a></p></li> -<li><p><a class="reference internal" href="#indicating-edits" id="id99"><span class="sectnum">3.4</span> Indicating Edits</a></p></li> +<li><p><a class="reference internal" href="#svg-images" id="toc-entry-42"><span class="sectnum">3.1</span> SVG Images</a></p></li> +<li><p><a class="reference internal" href="#swf-images" id="toc-entry-43"><span class="sectnum">3.2</span> SWF Images</a></p></li> +<li><p><a class="reference internal" href="#text-level-semantics" id="toc-entry-44"><span class="sectnum">3.3</span> Text-level semantics</a></p></li> +<li><p><a class="reference internal" href="#indicating-edits" id="toc-entry-45"><span class="sectnum">3.4</span> Indicating Edits</a></p></li> </ul> </li> -<li><p><a class="reference internal" href="#changes-to-the-html4css1-writer" id="id100"><span class="sectnum">4</span> Changes to the html4css1 writer</a></p> +<li><p><a class="reference internal" href="#changes-to-the-html4css1-writer" id="toc-entry-46"><span class="sectnum">4</span> Changes to the html4css1 writer</a></p> <ul class="auto-toc"> -<li><p><a class="reference internal" href="#field-list-handling" id="id101"><span class="sectnum">4.1</span> Field list handling</a></p></li> -<li><p><a class="reference internal" href="#styling-with-class-arguments" id="id102"><span class="sectnum">4.2</span> Styling with class arguments</a></p> +<li><p><a class="reference internal" href="#field-list-handling" id="toc-entry-47"><span class="sectnum">4.1</span> Field list handling</a></p></li> +<li><p><a class="reference internal" href="#styling-with-class-arguments" id="toc-entry-48"><span class="sectnum">4.2</span> Styling with class arguments</a></p> <ul class="auto-toc"> -<li><p><a class="reference internal" href="#description-lists" id="id103"><span class="sectnum">4.2.1</span> Description lists</a></p></li> -<li><p><a class="reference internal" href="#field-list-variants" id="id104"><span class="sectnum">4.2.2</span> Field list variants</a></p></li> -<li><p><a class="reference internal" href="#table-variants" id="id105"><span class="sectnum">4.2.3</span> Table variants</a></p></li> +<li><p><a class="reference internal" href="#description-lists" id="toc-entry-49"><span class="sectnum">4.2.1</span> Description lists</a></p></li> +<li><p><a class="reference internal" href="#field-list-variants" id="toc-entry-50"><span class="sectnum">4.2.2</span> Field list variants</a></p></li> +<li><p><a class="reference internal" href="#table-variants" id="toc-entry-51"><span class="sectnum">4.2.3</span> Table variants</a></p></li> </ul> </li> </ul> </li> -<li><p><a class="reference internal" href="#error-handling" id="id106"><span class="sectnum">5</span> Error Handling</a></p></li> +<li><p><a class="reference internal" href="#error-handling" id="toc-entry-52"><span class="sectnum">5</span> Error Handling</a></p></li> </ul> </div> <div class="section" id="structural-elements"> -<h1><a class="toc-backref" href="#id55"><span class="sectnum">1</span> Structural Elements</a></h1> +<h1><a class="toc-backref" href="#toc-entry-1"><span class="sectnum">1</span> Structural Elements</a></h1> <div class="section" id="section-title"> -<h2 class="with-subtitle"><a class="toc-backref" href="#id56"><span class="sectnum">1.1</span> Section Title</a></h2> +<h2 class="with-subtitle"><a class="toc-backref" href="#toc-entry-2"><span class="sectnum">1.1</span> Section Title</a></h2> <p class="section-subtitle" id="section-subtitle">Section Subtitle</p> <p>Lone subsections are converted to a section subtitle by a transform activated with the <span class="docutils literal"><span class="pre">--section-subtitles</span></span> command line option or the <span class="docutils literal"><span class="pre">sectsubtitle-xform</span></span> configuration value.</p> </div> <div class="section" id="empty-section"> -<h2><a class="toc-backref" href="#id57"><span class="sectnum">1.2</span> Empty Section</a></h2> +<h2><a class="toc-backref" href="#toc-entry-3"><span class="sectnum">1.2</span> Empty Section</a></h2> </div> <div class="section" id="transitions"> -<h2><a class="toc-backref" href="#id58"><span class="sectnum">1.3</span> Transitions</a></h2> +<h2><a class="toc-backref" href="#toc-entry-4"><span class="sectnum">1.3</span> Transitions</a></h2> <p>Here's a transition:</p> <hr class="docutils" /> <p>It divides the section. Transitions may also occur between sections:</p> @@ -185,24 +185,24 @@ activated with the <span class="docutils literal"><span class="pre">--section-su </div> <hr class="docutils" /> <div class="section" id="body-elements"> -<h1><a class="toc-backref" href="#id59"><span class="sectnum">2</span> Body Elements</a></h1> +<h1><a class="toc-backref" href="#toc-entry-5"><span class="sectnum">2</span> Body Elements</a></h1> <div class="section" id="paragraphs"> -<h2><a class="toc-backref" href="#id60"><span class="sectnum">2.1</span> Paragraphs</a></h2> +<h2><a class="toc-backref" href="#toc-entry-6"><span class="sectnum">2.1</span> Paragraphs</a></h2> <p>A paragraph.</p> <div class="section" id="inline-markup"> -<h3><a class="toc-backref" href="#id61"><span class="sectnum">2.1.1</span> Inline Markup</a></h3> +<h3><a class="toc-backref" href="#toc-entry-7"><span class="sectnum">2.1.1</span> Inline Markup</a></h3> <p>Paragraphs contain text and may contain inline markup: <em>emphasis</em>, <strong>strong emphasis</strong>, <span class="docutils literal">inline literals</span>, standalone hyperlinks -(<a class="reference external" href="http://www.python.org">http://www.python.org</a>), external hyperlinks (<a class="reference external" href="http://www.python.org/">Python</a> <a class="footnote-reference brackets" href="#id36" id="id37">7</a>), internal +(<a class="reference external" href="http://www.python.org">http://www.python.org</a>), external hyperlinks (<a class="reference external" href="http://www.python.org/">Python</a> <a class="footnote-reference brackets" href="#footnote-7" id="footnote-reference-18">7</a>), internal cross-references (<a class="reference internal" href="#example">example</a>), external hyperlinks with embedded URIs (<a class="reference external" href="http://www.python.org">Python web site</a>), <a class="reference external" href="http://www.python.org/">anonymous hyperlink -references</a> <a class="footnote-reference brackets" href="#id36" id="id48">7</a> (<a class="reference external" href="http://docutils.sourceforge.net/">a second reference</a> <a class="footnote-reference brackets" href="#id49" id="id50">12</a>), footnote references (manually -numbered <a class="footnote-reference brackets" href="#id8" id="id1">1</a>, anonymous auto-numbered <a class="footnote-reference brackets" href="#id12" id="id2">3</a>, labeled auto-numbered -<a class="footnote-reference brackets" href="#label" id="id3">2</a>, or symbolic <a class="footnote-reference brackets" href="#id13" id="id4">*</a>), citation references (<a class="citation-reference" href="#cit2002" id="id5">[CIT2002]</a>), +references</a> <a class="footnote-reference brackets" href="#footnote-7" id="footnote-reference-25">7</a> (<a class="reference external" href="http://docutils.sourceforge.net/">a second reference</a> <a class="footnote-reference brackets" href="#footnote-12" id="footnote-reference-26">12</a>), footnote references (manually +numbered <a class="footnote-reference brackets" href="#footnote-1" id="footnote-reference-1">1</a>, anonymous auto-numbered <a class="footnote-reference brackets" href="#footnote-2" id="footnote-reference-2">3</a>, labeled auto-numbered +<a class="footnote-reference brackets" href="#label" id="footnote-reference-3">2</a>, or symbolic <a class="footnote-reference brackets" href="#footnote-3" id="footnote-reference-4">*</a>), citation references (<a class="citation-reference" href="#cit2002" id="citation-reference-1">[CIT2002]</a>), substitution references (<img alt="EXAMPLE" src="../../../docs/user/rst/images/biohazard.png" /> & a <em>trimmed heart</em> <span class="docutils literal">(U+2665):</span>♥), and <span class="target" id="inline-hyperlink-targets">inline hyperlink targets</span> (see <a class="reference internal" href="#targets">Targets</a> below for a reference back to here). Character-level -inline markup is also possible (although exceedingly ugly!) in <em>re</em><span class="docutils literal">Structured</span><em>Text</em>. Problems are indicated by <a href="#id34"><span class="problematic" id="id35">|problematic|</span></a> text +inline markup is also possible (although exceedingly ugly!) in <em>re</em><span class="docutils literal">Structured</span><em>Text</em>. Problems are indicated by <a href="#system-message-1"><span class="problematic" id="problematic-1">|problematic|</span></a> text (generated by processing errors; this one is intentional). Here is a reference to the <a class="reference internal" href="#doctitle">doctitle</a> and the <a class="reference internal" href="#subtitle">subtitle</a>.</p> <p>The default role for interpreted text is <cite>Title Reference</cite>. Here are @@ -219,7 +219,7 @@ live link to PEP 258 here.</p> </div> </div> <div class="section" id="bullet-lists"> -<h2><a class="toc-backref" href="#id62"><span class="sectnum">2.2</span> Bullet Lists</a></h2> +<h2><a class="toc-backref" href="#toc-entry-8"><span class="sectnum">2.2</span> Bullet Lists</a></h2> <ul> <li><p>A bullet list</p> <ul class="simple"> @@ -246,7 +246,7 @@ live link to PEP 258 here.</p> </ul> </div> <div class="section" id="enumerated-lists"> -<h2><a class="toc-backref" href="#id63"><span class="sectnum">2.3</span> Enumerated Lists</a></h2> +<h2><a class="toc-backref" href="#toc-entry-9"><span class="sectnum">2.3</span> Enumerated Lists</a></h2> <ol class="arabic"> <li><p>Arabic numerals.</p> <ol class="loweralpha simple"> @@ -282,7 +282,7 @@ live link to PEP 258 here.</p> </ol> </div> <div class="section" id="definition-lists"> -<h2><a class="toc-backref" href="#id64"><span class="sectnum">2.4</span> Definition Lists</a></h2> +<h2><a class="toc-backref" href="#toc-entry-10"><span class="sectnum">2.4</span> Definition Lists</a></h2> <dl> <dt>Term</dt> <dd><p>Definition</p> @@ -300,7 +300,7 @@ live link to PEP 258 here.</p> </dl> </div> <div class="section" id="field-lists"> -<h2><a class="toc-backref" href="#id65"><span class="sectnum">2.5</span> Field Lists</a></h2> +<h2><a class="toc-backref" href="#toc-entry-11"><span class="sectnum">2.5</span> Field Lists</a></h2> <dl class="field-list"> <dt>what</dt> <dd><p>Field lists map field names to field bodies, like database @@ -320,7 +320,7 @@ doesn't get stripped away.)</p> </dl> </div> <div class="section" id="option-lists"> -<h2><a class="toc-backref" href="#id66"><span class="sectnum">2.6</span> Option Lists</a></h2> +<h2><a class="toc-backref" href="#toc-entry-12"><span class="sectnum">2.6</span> Option Lists</a></h2> <p>For listing command-line options:</p> <dl class="option-list"> <dt><kbd><span class="option">-a</span></kbd></dt> @@ -359,7 +359,7 @@ regardless of where it starts.</p> description.</p> </div> <div class="section" id="literal-blocks"> -<h2><a class="toc-backref" href="#id67"><span class="sectnum">2.7</span> Literal Blocks</a></h2> +<h2><a class="toc-backref" href="#toc-entry-13"><span class="sectnum">2.7</span> Literal Blocks</a></h2> <p>Literal blocks are indicated with a double-colon ("::") at the end of the preceding paragraph (over there <span class="docutils literal"><span class="pre">--></span></span>). They can be indented:</p> <pre class="literal-block">if literal_block: @@ -372,7 +372,7 @@ the preceding paragraph (over there <span class="docutils literal"><span class=" > Why didn't I think of that?</pre> </div> <div class="section" id="line-blocks"> -<h2><a class="toc-backref" href="#id68"><span class="sectnum">2.8</span> Line Blocks</a></h2> +<h2><a class="toc-backref" href="#toc-entry-14"><span class="sectnum">2.8</span> Line Blocks</a></h2> <p>This section tests line blocks. Line blocks are body elements which consist of lines and other line blocks. Nested line blocks cause indentation.</p> @@ -446,7 +446,7 @@ also be centre-aligned:</p> </div> </div> <div class="section" id="block-quotes"> -<h2><a class="toc-backref" href="#id69"><span class="sectnum">2.9</span> Block Quotes</a></h2> +<h2><a class="toc-backref" href="#toc-entry-15"><span class="sectnum">2.9</span> Block Quotes</a></h2> <p>Block quotes consist of indented body elements:</p> <blockquote> <p>My theory by A. Elk. Brackets Miss, brackets. This theory goes @@ -465,7 +465,7 @@ notamment dans la documentation du langage Python.</p> </blockquote> </div> <div class="section" id="doctest-blocks"> -<h2><a class="toc-backref" href="#id70"><span class="sectnum">2.10</span> Doctest Blocks</a></h2> +<h2><a class="toc-backref" href="#toc-entry-16"><span class="sectnum">2.10</span> Doctest Blocks</a></h2> <pre class="code python doctest">>>> print 'Python-specific usage examples; begun with ">>>"' Python-specific usage examples; begun with ">>>" >>> print '(cut and pasted from interactive Python sessions)' @@ -473,101 +473,101 @@ Python-specific usage examples; begun with ">>>" </pre> </div> <div class="section" id="footnotes"> -<h2><a class="toc-backref" href="#id71"><span class="sectnum">2.11</span> Footnotes</a></h2> +<h2><a class="toc-backref" href="#toc-entry-17"><span class="sectnum">2.11</span> Footnotes</a></h2> <dl class="footnote brackets"> -<dt class="label" id="id8"><span class="brackets">1</span><span class="fn-backref">(<a href="#id1">1</a>,<a href="#id9">2</a>,<a href="#id22">3</a>)</span></dt> +<dt class="label" id="footnote-1"><span class="brackets">1</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 least 3 spaces.</p> <p>This is the footnote's second paragraph.</p> </dd> -<dt class="label" id="label"><span class="brackets">2</span><span class="fn-backref">(<a href="#id3">1</a>,<a href="#id10">2</a>)</span></dt> -<dd><p>Footnotes may be numbered, either manually (as in <a class="footnote-reference brackets" href="#id8" id="id9">1</a>) or +<dt class="label" id="label"><span class="brackets">2</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">1</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="id10">2</a>) and as a <a class="reference internal" href="#label">hyperlink reference</a>.</p> +footnote reference (<a class="footnote-reference brackets" href="#label" id="footnote-reference-6">2</a>) and as a <a class="reference internal" href="#label">hyperlink reference</a>.</p> </dd> -<dt class="label" id="id12"><span class="brackets"><a class="fn-backref" href="#id2">3</a></span></dt> +<dt class="label" id="footnote-2"><span class="brackets"><a class="fn-backref" href="#footnote-reference-2">3</a></span></dt> <dd><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="id13"><span class="brackets"><a class="fn-backref" href="#id4">*</a></span></dt> +<dt class="label" id="footnote-3"><span class="brackets"><a class="fn-backref" href="#footnote-reference-4">*</a></span></dt> <dd><p>Footnotes may also use symbols, specified with a "*" label. -Here's a reference to the next footnote: <a class="footnote-reference brackets" href="#id15" id="id14">†</a>.</p> +Here's a reference to the next footnote: <a class="footnote-reference brackets" href="#footnote-4" id="footnote-reference-7">†</a>.</p> </dd> -<dt class="label" id="id15"><span class="brackets"><a class="fn-backref" href="#id14">†</a></span></dt> +<dt class="label" id="footnote-4"><span class="brackets"><a class="fn-backref" href="#footnote-reference-7">†</a></span></dt> <dd><p>This footnote shows the next symbol in the sequence.</p> </dd> -<dt class="label" id="id16"><span class="brackets">4</span></dt> +<dt class="label" id="footnote-5"><span class="brackets">4</span></dt> <dd><p>Here's an unreferenced footnote, with a reference to a -nonexistent footnote: <a href="#id116"><span class="problematic" id="id17">[5]_</span></a>.</p> +nonexistent footnote: <a href="#system-message-2"><span class="problematic" id="footnote-reference-8">[5]_</span></a>.</p> </dd> </dl> </div> <div class="section" id="citations"> -<h2><a class="toc-backref" href="#id72"><span class="sectnum">2.12</span> Citations</a></h2> +<h2><a class="toc-backref" href="#toc-entry-18"><span class="sectnum">2.12</span> Citations</a></h2> <dl class="citation"> -<dt class="label" id="cit2002"><span class="brackets">CIT2002</span><span class="fn-backref">(<a href="#id5">1</a>,<a href="#id18">2</a>)</span></dt> +<dt class="label" id="cit2002"><span class="brackets">CIT2002</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 rendered separately and differently from footnotes.</p> </dd> </dl> -<p>Here's a reference to the above, <a class="citation-reference" href="#cit2002" id="id18">[CIT2002]</a>, and a <a href="#id117"><span class="problematic" id="id19">[nonexistent]_</span></a> +<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> </div> <div class="section" id="targets"> -<span id="another-target"></span><h2><a class="toc-backref" href="#id73"><span class="sectnum">2.13</span> Targets</a></h2> +<span id="another-target"></span><h2><a class="toc-backref" href="#toc-entry-19"><span class="sectnum">2.13</span> Targets</a></h2> <p id="example">This paragraph is pointed to by the explicit "example" target. A reference can be found under <a class="reference internal" href="#inline-markup">Inline Markup</a>, above. <a class="reference internal" href="#inline-hyperlink-targets">Inline hyperlink targets</a> are also possible.</p> <p>Section headers are implicit targets, referred to by name. See <a class="reference internal" href="#targets">Targets</a>, which is a subsection of <a class="reference internal" href="#body-elements">Body Elements</a>.</p> <p>Explicit external targets are interpolated into references such as -"<a class="reference external" href="http://www.python.org/">Python</a> <a class="footnote-reference brackets" href="#id36" id="id38">7</a>".</p> +"<a class="reference external" href="http://www.python.org/">Python</a> <a class="footnote-reference brackets" href="#footnote-7" id="footnote-reference-19">7</a>".</p> <p>Targets may be indirect and anonymous. Thus <a class="reference internal" href="#targets">this phrase</a> may also refer to the <a class="reference internal" href="#targets">Targets</a> section.</p> -<p>Here's a <a href="#id118"><span class="problematic" id="id119">`hyperlink reference without a target`_</span></a>, which generates an +<p>Here's a <a href="#system-message-4"><span class="problematic" id="problematic-2">`hyperlink reference without a target`_</span></a>, which generates an error.</p> <div class="section" id="duplicate-target-names"> -<h3><a class="toc-backref" href="#id74"><span class="sectnum">2.13.1</span> Duplicate Target Names</a></h3> +<h3><a class="toc-backref" href="#toc-entry-20"><span class="sectnum">2.13.1</span> Duplicate Target Names</a></h3> <p>Duplicate names in section headers or other implicit targets will generate "info" (level-1) system messages. Duplicate names in explicit targets will generate "warning" (level-2) system messages.</p> </div> -<div class="section" id="id21"> -<h3><a class="toc-backref" href="#id75"><span class="sectnum">2.13.2</span> Duplicate Target Names</a></h3> +<div class="section" id="duplicate-target-names-1"> +<h3><a class="toc-backref" href="#toc-entry-21"><span class="sectnum">2.13.2</span> Duplicate Target Names</a></h3> <p>Since there are two "Duplicate Target Names" section headers, we cannot uniquely refer to either of them by name. If we try to (like -this: <a href="#id120"><span class="problematic" id="id121">`Duplicate Target Names`_</span></a>), an error is generated.</p> +this: <a href="#system-message-5"><span class="problematic" id="problematic-3">`Duplicate Target Names`_</span></a>), an error is generated.</p> </div> </div> <div class="section" id="directives"> -<h2><a class="toc-backref" href="#id76"><span class="sectnum">2.14</span> Directives</a></h2> +<h2><a class="toc-backref" href="#toc-entry-22"><span class="sectnum">2.14</span> Directives</a></h2> <div class="contents local topic" id="contents"> <ul class="auto-toc simple"> -<li><p><a class="reference internal" href="#document-parts" id="id107"><span class="sectnum">2.14.1</span> Document Parts</a></p></li> -<li><p><a class="reference internal" href="#images-and-figures" id="id108"><span class="sectnum">2.14.2</span> Images and Figures</a></p></li> -<li><p><a class="reference internal" href="#admonitions" id="id109"><span class="sectnum">2.14.3</span> Admonitions</a></p></li> -<li><p><a class="reference internal" href="#topics-sidebars-and-rubrics" id="id110"><span class="sectnum">2.14.4</span> Topics, Sidebars, and Rubrics</a></p></li> -<li><p><a class="reference internal" href="#target-footnotes" id="id111"><span class="sectnum">2.14.5</span> Target Footnotes</a></p></li> -<li><p><a class="reference internal" href="#replacement-text" id="id112"><span class="sectnum">2.14.6</span> Replacement Text</a></p></li> -<li><p><a class="reference internal" href="#compound-paragraph" id="id113"><span class="sectnum">2.14.7</span> Compound Paragraph</a></p></li> -<li><p><a class="reference internal" href="#parsed-literal-blocks" id="id114"><span class="sectnum">2.14.8</span> Parsed Literal Blocks</a></p></li> -<li><p><a class="reference internal" href="#code" id="id115"><span class="sectnum">2.14.9</span> Code</a></p></li> +<li><p><a class="reference internal" href="#document-parts" id="toc-entry-53"><span class="sectnum">2.14.1</span> Document Parts</a></p></li> +<li><p><a class="reference internal" href="#images-and-figures" id="toc-entry-54"><span class="sectnum">2.14.2</span> Images and Figures</a></p></li> +<li><p><a class="reference internal" href="#admonitions" id="toc-entry-55"><span class="sectnum">2.14.3</span> Admonitions</a></p></li> +<li><p><a class="reference internal" href="#topics-sidebars-and-rubrics" id="toc-entry-56"><span class="sectnum">2.14.4</span> Topics, Sidebars, and Rubrics</a></p></li> +<li><p><a class="reference internal" href="#target-footnotes" id="toc-entry-57"><span class="sectnum">2.14.5</span> Target Footnotes</a></p></li> +<li><p><a class="reference internal" href="#replacement-text" id="toc-entry-58"><span class="sectnum">2.14.6</span> Replacement Text</a></p></li> +<li><p><a class="reference internal" href="#compound-paragraph" id="toc-entry-59"><span class="sectnum">2.14.7</span> Compound Paragraph</a></p></li> +<li><p><a class="reference internal" href="#parsed-literal-blocks" id="toc-entry-60"><span class="sectnum">2.14.8</span> Parsed Literal Blocks</a></p></li> +<li><p><a class="reference internal" href="#code" id="toc-entry-61"><span class="sectnum">2.14.9</span> Code</a></p></li> </ul> </div> <p>These are just a sample of the many reStructuredText Directives. For others, please see <a class="reference external" href="http://docutils.sourceforge.net/docs/ref/rst/directives.html">http://docutils.sourceforge.net/docs/ref/rst/directives.html</a>.</p> <div class="section" id="document-parts"> -<h3><a class="toc-backref" href="#id107"><span class="sectnum">2.14.1</span> Document Parts</a></h3> +<h3><a class="toc-backref" href="#toc-entry-53"><span class="sectnum">2.14.1</span> Document Parts</a></h3> <p>An example of the "contents" directive can be seen above this section (a local, untitled table of <a class="reference internal" href="#contents">contents</a>) and at the beginning of the document (a document-wide <a class="reference internal" href="#table-of-contents">table of contents</a>).</p> </div> <div class="section" id="images-and-figures"> -<h3><a class="toc-backref" href="#id108"><span class="sectnum">2.14.2</span> Images and Figures</a></h3> +<h3><a class="toc-backref" href="#toc-entry-54"><span class="sectnum">2.14.2</span> Images and Figures</a></h3> <p>An image directive (also clickable -- a hyperlink reference):</p> <a class="reference internal image-reference" href="#directives"><img alt="../../../docs/user/rst/images/title.png" class="class1 class2" src="../../../docs/user/rst/images/title.png" /></a> <p>Image with multiple IDs:</p> @@ -749,7 +749,7 @@ writer/backend).</p> </table> </div> <div class="section" id="admonitions"> -<h3><a class="toc-backref" href="#id109"><span class="sectnum">2.14.3</span> Admonitions</a></h3> +<h3><a class="toc-backref" href="#toc-entry-55"><span class="sectnum">2.14.3</span> Admonitions</a></h3> <div class="admonition attention"> <p class="admonition-title">Attention!</p> <p>Directives at large.</p> @@ -798,7 +798,7 @@ Reader discretion is strongly advised.</p> </div> </div> <div class="section" id="topics-sidebars-and-rubrics"> -<h3><a class="toc-backref" href="#id110"><span class="sectnum">2.14.4</span> Topics, Sidebars, and Rubrics</a></h3> +<h3><a class="toc-backref" href="#toc-entry-56"><span class="sectnum">2.14.4</span> Topics, Sidebars, and Rubrics</a></h3> <p><em>Sidebars</em> are like miniature, parallel documents.</p> <div class="sidebar"> <p class="sidebar-title">Sidebar Title</p> @@ -822,40 +822,40 @@ document's structure. It is typically highlighted in red (hence the name).</p> allowed (e.g. inside a directive).</p> </div> <div class="section" id="target-footnotes"> -<h3><a class="toc-backref" href="#id111"><span class="sectnum">2.14.5</span> Target Footnotes</a></h3> +<h3><a class="toc-backref" href="#toc-entry-57"><span class="sectnum">2.14.5</span> Target Footnotes</a></h3> <dl class="footnote brackets"> -<dt class="label" id="id36"><span class="brackets">7</span><span class="fn-backref">(<a href="#id37">1</a>,<a href="#id38">2</a>,<a href="#id39">3</a>,<a href="#id48">4</a>)</span></dt> +<dt class="label" id="footnote-7"><span class="brackets">7</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="id40"><span class="brackets"><a class="fn-backref" href="#id41">8</a></span></dt> +<dt class="label" id="footnote-8"><span class="brackets"><a class="fn-backref" href="#footnote-reference-21">8</a></span></dt> <dd><p><a class="reference external" href="http://pygments.org/">http://pygments.org/</a></p> </dd> -<dt class="label" id="id42"><span class="brackets"><a class="fn-backref" href="#id43">9</a></span></dt> +<dt class="label" id="footnote-9"><span class="brackets"><a class="fn-backref" href="#footnote-reference-22">9</a></span></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="id44"><span class="brackets"><a class="fn-backref" href="#id45">10</a></span></dt> +<dt class="label" id="footnote-10"><span class="brackets"><a class="fn-backref" href="#footnote-reference-23">10</a></span></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="id46"><span class="brackets"><a class="fn-backref" href="#id47">11</a></span></dt> +<dt class="label" id="footnote-11"><span class="brackets"><a class="fn-backref" href="#footnote-reference-24">11</a></span></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="id49"><span class="brackets"><a class="fn-backref" href="#id50">12</a></span></dt> +<dt class="label" id="footnote-12"><span class="brackets"><a class="fn-backref" href="#footnote-reference-26">12</a></span></dt> <dd><p><a class="reference external" href="http://docutils.sourceforge.net/">http://docutils.sourceforge.net/</a></p> </dd> -<dt class="label" id="id51"><span class="brackets"><a class="fn-backref" href="#id52">13</a></span></dt> +<dt class="label" id="footnote-13"><span class="brackets"><a class="fn-backref" href="#footnote-reference-27">13</a></span></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="id53"><span class="brackets"><a class="fn-backref" href="#id54">14</a></span></dt> +<dt class="label" id="footnote-14"><span class="brackets"><a class="fn-backref" href="#footnote-reference-28">14</a></span></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> </div> <div class="section" id="replacement-text"> -<h3><a class="toc-backref" href="#id112"><span class="sectnum">2.14.6</span> Replacement Text</a></h3> -<p>I recommend you try <a class="reference external" href="http://www.python.org/">Python, <em>the</em> best language around</a> <a class="footnote-reference brackets" href="#id36" id="id39">7</a>.</p> +<h3><a class="toc-backref" href="#toc-entry-58"><span class="sectnum">2.14.6</span> Replacement Text</a></h3> +<p>I recommend you try <a class="reference external" href="http://www.python.org/">Python, <em>the</em> best language around</a> <a class="footnote-reference brackets" href="#footnote-7" id="footnote-reference-20">7</a>.</p> </div> <div class="section" id="compound-paragraph"> -<h3><a class="toc-backref" href="#id113"><span class="sectnum">2.14.7</span> Compound Paragraph</a></h3> +<h3><a class="toc-backref" href="#toc-entry-59"><span class="sectnum">2.14.7</span> Compound Paragraph</a></h3> <p>The <em>compound</em> directive is used to create a "compound paragraph", which is a single logical paragraph containing multiple physical body elements. For example:</p> @@ -966,19 +966,19 @@ by</p> </div> </div> <div class="section" id="parsed-literal-blocks"> -<h3><a class="toc-backref" href="#id114"><span class="sectnum">2.14.8</span> Parsed Literal Blocks</a></h3> +<h3><a class="toc-backref" href="#toc-entry-60"><span class="sectnum">2.14.8</span> Parsed Literal Blocks</a></h3> <pre class="literal-block">This is a parsed literal block. This line is indented. The next line is blank. Inline markup is supported, e.g. <em>emphasis</em>, <strong>strong</strong>, <span class="docutils literal">literal text</span>, <sub>sub-</sub> and <sup>super</sup>scripts, inline formulas: <span class="formula"><i>A</i> = 2<i>π</i><i>r</i><sup>2</sup></span>, -footnotes <a class="footnote-reference brackets" href="#id8" id="id22">1</a>, <span class="target" id="hyperlink-targets">hyperlink targets</span>, and <a class="reference external" href="http://www.python.org/">references</a>.</pre> +footnotes <a class="footnote-reference brackets" href="#footnote-1" id="footnote-reference-9">1</a>, <span class="target" id="hyperlink-targets">hyperlink targets</span>, and <a class="reference external" href="http://www.python.org/">references</a>.</pre> </div> <div class="section" id="code"> -<h3><a class="toc-backref" href="#id115"><span class="sectnum">2.14.9</span> Code</a></h3> +<h3><a class="toc-backref" href="#toc-entry-61"><span class="sectnum">2.14.9</span> Code</a></h3> <p>Blocks of source code can be set with the <cite>code</cite> directive. If the code -language is specified, the content is parsed and tagged by the <a class="reference external" href="http://pygments.org/">Pygments</a> <a class="footnote-reference brackets" href="#id40" id="id41">8</a> +language is specified, the content is parsed and tagged by the <a class="reference external" href="http://pygments.org/">Pygments</a> <a class="footnote-reference brackets" href="#footnote-8" id="footnote-reference-21">8</a> syntax highlighter and can be formatted with a style sheet. (Code parsing is turned off using the <span class="docutils literal"><span class="pre">syntax-highlight</span></span> config setting in the test conversions in order to get identical results with/without installed @@ -1002,13 +1002,13 @@ as a code block, here the rst file <span class="docutils literal">header_footer. </div> </div> <div class="section" id="substitution-definitions"> -<h2><a class="toc-backref" href="#id86"><span class="sectnum">2.15</span> Substitution Definitions</a></h2> +<h2><a class="toc-backref" href="#toc-entry-32"><span class="sectnum">2.15</span> Substitution Definitions</a></h2> <p>An inline image (<img alt="EXAMPLE" src="../../../docs/user/rst/images/biohazard.png" />) example:</p> <p>A Unicode example:</p> <p>(Substitution definitions are not visible in the HTML source.)</p> </div> <div class="section" id="comments"> -<h2><a class="toc-backref" href="#id87"><span class="sectnum">2.16</span> Comments</a></h2> +<h2><a class="toc-backref" href="#toc-entry-33"><span class="sectnum">2.16</span> Comments</a></h2> <p>Here's one:</p> <!-- Comments begin with two dots and a space. Anything may follow, except for the syntax of footnotes, hyperlink @@ -1020,20 +1020,20 @@ Comments may contain non-ASCII characters: ä ö ü æ ø å --> <p>(View the HTML source to see the comment.)</p> </div> <div class="section" id="raw-text"> -<h2><a class="toc-backref" href="#id88"><span class="sectnum">2.17</span> Raw text</a></h2> +<h2><a class="toc-backref" href="#toc-entry-34"><span class="sectnum">2.17</span> Raw text</a></h2> <p>This does not necessarily look nice, because there may be missing white space.</p> <p>It's just there to freeze the behavior.</p> A test.Second test.<div class="myclass">Another test with myclass set.</div><p>This is the <span class="myrawroleclass">fourth test</span> with myrawroleclass set.</p> Fifth test in HTML.<br />Line two.</div> <div class="section" id="container"> -<h2><a class="toc-backref" href="#id89"><span class="sectnum">2.18</span> Container</a></h2> +<h2><a class="toc-backref" href="#toc-entry-35"><span class="sectnum">2.18</span> Container</a></h2> <div class="custom docutils container"> <p>paragraph 1</p> <p>paragraph 2</p> </div> </div> <div class="section" id="colspanning-tables"> -<h2><a class="toc-backref" href="#id90"><span class="sectnum">2.19</span> Colspanning tables</a></h2> +<h2><a class="toc-backref" href="#toc-entry-36"><span class="sectnum">2.19</span> Colspanning tables</a></h2> <p>This table has a cell spanning two columns:</p> <table> <colgroup> @@ -1071,7 +1071,7 @@ Fifth test in HTML.<br />Line two.</div> </table> </div> <div class="section" id="rowspanning-tables"> -<h2><a class="toc-backref" href="#id91"><span class="sectnum">2.20</span> Rowspanning tables</a></h2> +<h2><a class="toc-backref" href="#toc-entry-37"><span class="sectnum">2.20</span> Rowspanning tables</a></h2> <p>Here's a table with cells spanning several rows:</p> <table> <colgroup> @@ -1104,7 +1104,7 @@ cell.</p></td> </table> </div> <div class="section" id="complex-tables"> -<h2><a class="toc-backref" href="#id92"><span class="sectnum">2.21</span> Complex tables</a></h2> +<h2><a class="toc-backref" href="#toc-entry-38"><span class="sectnum">2.21</span> Complex tables</a></h2> <p>Here's a complex table, which should test all features.</p> <table> <colgroup> @@ -1153,7 +1153,7 @@ empty: <span class="docutils literal"><span class="pre">--></span></span></p> </table> </div> <div class="section" id="list-tables"> -<h2><a class="toc-backref" href="#id93"><span class="sectnum">2.22</span> List Tables</a></h2> +<h2><a class="toc-backref" href="#toc-entry-39"><span class="sectnum">2.22</span> List Tables</a></h2> <p>Here's a list table exercising all features:</p> <table class="colwidths-given test" style="width: 40em"> <caption>list table with integral header</caption> @@ -1200,7 +1200,7 @@ crunchy, now would it?</p></td> </table> </div> <div class="section" id="custom-roles"> -<h2><a class="toc-backref" href="#id94"><span class="sectnum">2.23</span> Custom Roles</a></h2> +<h2><a class="toc-backref" href="#toc-entry-40"><span class="sectnum">2.23</span> Custom Roles</a></h2> <ul> <li><p>A role based on an existing role.</p> <p><span class="custom docutils literal">one</span> <span class="custom docutils literal">two</span> <span class="custom docutils literal">three</span></p> @@ -1229,9 +1229,9 @@ crunchy, now would it?</p></td> </div> </div> <div class="section" id="html-specific"> -<h1><a class="toc-backref" href="#id95"><span class="sectnum">3</span> HTML specific</a></h1> +<h1><a class="toc-backref" href="#toc-entry-41"><span class="sectnum">3</span> HTML specific</a></h1> <div class="section" id="svg-images"> -<h2><a class="toc-backref" href="#id96"><span class="sectnum">3.1</span> SVG Images</a></h2> +<h2><a class="toc-backref" href="#toc-entry-42"><span class="sectnum">3.1</span> SVG Images</a></h2> <img alt="../../../docs/user/rst/images/biohazard.svg" class="align-left" src="../../../docs/user/rst/images/biohazard.svg" style="width: 48px; height: 48px;" /> <p>Scalable vector graphics (SVG) images are the only standards-compliable way to include vector graphics in HTML documents. However, they are not @@ -1316,7 +1316,7 @@ tags.</p> </blockquote> </div> <div class="section" id="swf-images"> -<h2><a class="toc-backref" href="#id97"><span class="sectnum">3.2</span> SWF Images</a></h2> +<h2><a class="toc-backref" href="#toc-entry-43"><span class="sectnum">3.2</span> SWF Images</a></h2> <p>Shockwave Flash is an image/movie format that most modern web browsers support via a plugin. It is sometimes blocked due to privacy/security concerns.</p> @@ -1328,8 +1328,8 @@ For complete control over display options use raw HTML.</p> <p>An inline SWF image <object data="../../../docs/user/rst/images/biohazard.swf" style="width: 0.8em; height: 0.8em;" type="application/x-shockwave-flash">inline-swf</object> scaled to 0.8 em x 0.8 em.</p> </div> <div class="section" id="text-level-semantics"> -<h2><a class="toc-backref" href="#id98"><span class="sectnum">3.3</span> Text-level semantics</a></h2> -<p><a class="reference external" href="https://html.spec.whatwg.org/#text-level-semantics">HTML 5 tags for representation of text-level semantics</a> <a class="footnote-reference brackets" href="#id51" id="id52">13</a> and their +<h2><a class="toc-backref" href="#toc-entry-44"><span class="sectnum">3.3</span> Text-level semantics</a></h2> +<p><a class="reference external" href="https://html.spec.whatwg.org/#text-level-semantics">HTML 5 tags for representation of text-level semantics</a> <a class="footnote-reference brackets" href="#footnote-13" id="footnote-reference-27">13</a> and their reStructuredText equivalents.</p> <dl class="narrow field-list"> <dt>a</dt> @@ -1385,16 +1385,16 @@ chemicals.</p> </blockquote> </dd> <dt>abbr</dt> -<dd><p>Abbreviations <a class="footnote-reference brackets" href="#attribute-optional" id="id24">5</a></p> +<dd><p>Abbreviations <a class="footnote-reference brackets" href="#attribute-optional" id="footnote-reference-10">5</a></p> <blockquote> -<p>Organic food in Ireland is certified by the <abbr>IOFGA</abbr> <a class="footnote-reference brackets" href="#id26" id="id25">‡</a></p> +<p>Organic food in Ireland is certified by the <abbr>IOFGA</abbr> <a class="footnote-reference brackets" href="#footnote-6" id="footnote-reference-11">‡</a></p> </blockquote> <p>In rST there are separate roles for <cite>abbreviations</cite> <abbr>rsp.</abbr> <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="id26"><span class="brackets"><a class="fn-backref" href="#id25">‡</a></span></dt> +<dt class="label" id="footnote-6"><span class="brackets"><a class="fn-backref" href="#footnote-reference-11">‡</a></span></dt> <dd><p>Irish Organic Farmers and Growers Association</p> </dd> </dl> @@ -1407,14 +1407,14 @@ advised to use <abbr> instead. The HTML5 writer uses <abbr> for Docu </blockquote> </dd> <dt>data</dt> -<dd><p>Machine-readable equivalent <a class="footnote-reference brackets" href="#attribute-required" id="id27">6</a></p> +<dd><p>Machine-readable equivalent <a class="footnote-reference brackets" href="#attribute-required" id="footnote-reference-12">6</a></p> <blockquote> <p>Available starting today! <data value="UPC:022014640201">North Coast Organic Apple Cider</data></p> </blockquote> </dd> <dt>time</dt> -<dd><p>Machine-readable equivalent of date- or time-related data <a class="footnote-reference brackets" href="#attribute-required" id="id28">6</a></p> +<dd><p>Machine-readable equivalent of date- or time-related data <a class="footnote-reference brackets" href="#attribute-required" id="footnote-reference-13">6</a></p> <blockquote> <p>Available starting on <time datetime="2011-11-18">November 18th</time>!</p> </blockquote> @@ -1483,7 +1483,7 @@ pleasant.</p> </blockquote> </dd> <dt>bdi</dt> -<dd><p>Text directionality isolation <a class="footnote-reference brackets" href="#attribute-optional" id="id29">5</a></p> +<dd><p>Text directionality isolation <a class="footnote-reference brackets" href="#attribute-optional" id="footnote-reference-14">5</a></p> <blockquote> <p>The recommended restaurant is <span class="bdi">My Juice Café (At The Beach)</span>.</p> </blockquote> @@ -1491,7 +1491,7 @@ pleasant.</p> element.</p> </dd> <dt>bdo</dt> -<dd><p>Text directionality formatting <a class="footnote-reference brackets" href="#attribute-required" id="id30">6</a></p> +<dd><p>Text directionality formatting <a class="footnote-reference brackets" href="#attribute-required" id="footnote-reference-15">6</a></p> <blockquote> <p>The proposal is to write English, but in reverse order. "Juice" would become "<bdo dir=rtl>Juice</bdo>"></p> @@ -1533,12 +1533,12 @@ a substitution.</p> </dl> </div> <div class="section" id="indicating-edits"> -<h2><a class="toc-backref" href="#id99"><span class="sectnum">3.4</span> Indicating Edits</a></h2> -<p><a class="reference external" href="https://html.spec.whatwg.org/multipage/edits.html">HTML tags for representation of edits to the document</a> <a class="footnote-reference brackets" href="#id53" id="id54">14</a> and their +<h2><a class="toc-backref" href="#toc-entry-45"><span class="sectnum">3.4</span> Indicating Edits</a></h2> +<p><a class="reference external" href="https://html.spec.whatwg.org/multipage/edits.html">HTML tags for representation of edits to the document</a> <a class="footnote-reference brackets" href="#footnote-14" id="footnote-reference-28">14</a> and their reStructuredText equivalents.</p> <dl class="field-list"> <dt>ins</dt> -<dd><p>Additions <a class="footnote-reference brackets" href="#attribute-optional" id="id32">5</a></p> +<dd><p>Additions <a class="footnote-reference brackets" href="#attribute-optional" id="footnote-reference-16">5</a></p> <blockquote> <p>This text has "always" been here. <span class="ins">This text has been inserted.</span></p> <div class="ins docutils container"> @@ -1547,7 +1547,7 @@ reStructuredText equivalents.</p> </blockquote> </dd> <dt>del</dt> -<dd><p>Removed content <a class="footnote-reference brackets" href="#attribute-optional" id="id33">5</a></p> +<dd><p>Removed content <a class="footnote-reference brackets" href="#attribute-optional" id="footnote-reference-17">5</a></p> <blockquote> <p><span class="del">This text has been deleted</span>, here is the rest of the paragraph.</p> <div class="del docutils container"> @@ -1557,11 +1557,11 @@ reStructuredText equivalents.</p> </dd> </dl> <dl class="footnote brackets"> -<dt class="label" id="attribute-optional"><span class="brackets">5</span><span class="fn-backref">(<a href="#id24">1</a>,<a href="#id29">2</a>,<a href="#id32">3</a>,<a href="#id33">4</a>)</span></dt> +<dt class="label" id="attribute-optional"><span class="brackets">5</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 -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="#id42" id="id43">9</a></p> +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-9" id="footnote-reference-22">9</a></p> </dd> -<dt class="label" id="attribute-required"><span class="brackets">6</span><span class="fn-backref">(<a href="#id27">1</a>,<a href="#id28">2</a>,<a href="#id30">3</a>)</span></dt> +<dt class="label" id="attribute-required"><span class="brackets">6</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 roles to make sense.</p> </dd> @@ -1569,7 +1569,7 @@ roles to make sense.</p> </div> </div> <div class="section" id="changes-to-the-html4css1-writer"> -<h1><a class="toc-backref" href="#id100"><span class="sectnum">4</span> Changes to the html4css1 writer</a></h1> +<h1><a class="toc-backref" href="#toc-entry-46"><span class="sectnum">4</span> Changes to the html4css1 writer</a></h1> <ul class="simple"> <li><p>Use only meta keywords recognized by HTML 5.</p></li> <li><p>Set table column widths with <style="width: ...">, not "width" argument.</p></li> @@ -1580,7 +1580,7 @@ space.</p></li> <li><p>Put subtitles in <p> elements.</p></li> </ul> <div class="section" id="field-list-handling"> -<h2><a class="toc-backref" href="#id101"><span class="sectnum">4.1</span> Field list handling</a></h2> +<h2><a class="toc-backref" href="#toc-entry-47"><span class="sectnum">4.1</span> Field list handling</a></h2> <p>The following list demonstrates the problems with the html4css1 approach: the <cite>field-name-limit</cite> setting is given in "number of characters" but the field name uses a proportional font.</p> @@ -1624,11 +1624,11 @@ example:</p> </dl> </div> <div class="section" id="styling-with-class-arguments"> -<h2><a class="toc-backref" href="#id102"><span class="sectnum">4.2</span> Styling with class arguments</a></h2> +<h2><a class="toc-backref" href="#toc-entry-48"><span class="sectnum">4.2</span> Styling with class arguments</a></h2> <p>The <span class="docutils literal">plain.css</span> style sheet comes with some pre-defined style variants that can be choosen via a class argument.</p> <div class="section" id="description-lists"> -<h3><a class="toc-backref" href="#id103"><span class="sectnum">4.2.1</span> Description lists</a></h3> +<h3><a class="toc-backref" href="#toc-entry-49"><span class="sectnum">4.2.1</span> Description lists</a></h3> <p>Definition lists with the "description" class argument:</p> <dl class="description simple"> <dt>description lists</dt> @@ -1644,7 +1644,7 @@ encyclopedias etc. (as well as the LaTeX <cite>description</cite> environment).< </dl> </div> <div class="section" id="field-list-variants"> -<h3><a class="toc-backref" href="#id104"><span class="sectnum">4.2.2</span> Field list variants</a></h3> +<h3><a class="toc-backref" href="#toc-entry-50"><span class="sectnum">4.2.2</span> Field list variants</a></h3> <p>For field lists, the "compact/open", "narrow" and "run-in" styles are defined in the style sheet <span class="docutils literal">plain.css</span>.</p> <dl class="simple"> @@ -1711,9 +1711,9 @@ body is wrapped and aligns with other fields.</p> </dl> </div> <div class="section" id="table-variants"> -<h3><a class="toc-backref" href="#id105"><span class="sectnum">4.2.3</span> Table variants</a></h3> +<h3><a class="toc-backref" href="#toc-entry-51"><span class="sectnum">4.2.3</span> Table variants</a></h3> <p>The following styles can be applied to individual tables via a class -argument or as document wide setting with the <a class="reference external" href="http://docutils.sourceforge.net/docs/user/config.html#table-style">table-style</a> <a class="footnote-reference brackets" href="#id44" id="id45">10</a> configuration +argument or as document wide setting with the <a class="reference external" href="http://docutils.sourceforge.net/docs/user/config.html#table-style">table-style</a> <a class="footnote-reference brackets" href="#footnote-10" id="footnote-reference-23">10</a> configuration setting (or command line argument).</p> <ul> <li><p>Numbered tables can be achieved with the "numbered" class option:</p> @@ -1753,7 +1753,7 @@ setting (or command line argument).</p> common request and already on the <cite>TODO list</cite>.</p> </li> <li><p>A table with "booktabs" class value, is rendered similar to the style -from the <a class="reference external" href="http://tug.ctan.org/tex-archive/macros/latex/contrib/booktabs/booktabs.pdf">booktabs</a> <a class="footnote-reference brackets" href="#id46" id="id47">11</a> LaTeX package.</p> +from the <a class="reference external" href="http://tug.ctan.org/tex-archive/macros/latex/contrib/booktabs/booktabs.pdf">booktabs</a> <a class="footnote-reference brackets" href="#footnote-11" id="footnote-reference-24">11</a> LaTeX package.</p> </li> </ul> <p>"Booktabs" style table, numbered, centre-aligned, with auto-sized columns:</p> @@ -1793,7 +1793,7 @@ from the <a class="reference external" href="http://tug.ctan.org/tex-archive/mac </div> </div> <div class="section" id="error-handling"> -<h1><a class="toc-backref" href="#id106"><span class="sectnum">5</span> Error Handling</a></h1> +<h1><a class="toc-backref" href="#toc-entry-52"><span class="sectnum">5</span> Error Handling</a></h1> <p>Any errors caught during processing will generate system messages.</p> <p>There should be five messages in the following, auto-generated section, "Docutils System Messages":</p> @@ -1801,24 +1801,24 @@ section, "Docutils System Messages":</p> </div> <div class="system-messages section"> <h1>Docutils System Messages</h1> -<div class="system-message" id="id34"> -<p class="system-message-title">System Message: ERROR/3 (<span class="docutils literal">functional/input/data/standard.txt</span>, line 104); <em><a href="#id35">backlink</a></em></p> +<div class="system-message" id="system-message-1"> +<p class="system-message-title">System Message: ERROR/3 (<span class="docutils literal">functional/input/data/standard.txt</span>, line 104); <em><a href="#problematic-1">backlink</a></em></p> <p>Undefined substitution referenced: "problematic".</p> </div> -<div class="system-message" id="id116"> -<p class="system-message-title">System Message: ERROR/3 (<span class="docutils literal">functional/input/data/standard.txt</span>, line 392); <em><a href="#id17">backlink</a></em></p> +<div class="system-message" id="system-message-2"> +<p class="system-message-title">System Message: ERROR/3 (<span class="docutils literal">functional/input/data/standard.txt</span>, line 392); <em><a href="#footnote-reference-8">backlink</a></em></p> <p>Unknown target name: "5".</p> </div> -<div class="system-message" id="id117"> -<p class="system-message-title">System Message: ERROR/3 (<span class="docutils literal">functional/input/data/standard.txt</span>, line 401); <em><a href="#id19">backlink</a></em></p> +<div class="system-message" id="system-message-3"> +<p class="system-message-title">System Message: ERROR/3 (<span class="docutils literal">functional/input/data/standard.txt</span>, line 401); <em><a href="#citation-reference-3">backlink</a></em></p> <p>Unknown target name: "nonexistent".</p> </div> -<div class="system-message" id="id118"> -<p class="system-message-title">System Message: ERROR/3 (<span class="docutils literal">functional/input/data/standard.txt</span>, line 428); <em><a href="#id119">backlink</a></em></p> +<div class="system-message" id="system-message-4"> +<p class="system-message-title">System Message: ERROR/3 (<span class="docutils literal">functional/input/data/standard.txt</span>, line 428); <em><a href="#problematic-2">backlink</a></em></p> <p>Unknown target name: "hyperlink reference without a target".</p> </div> -<div class="system-message" id="id120"> -<p class="system-message-title">System Message: ERROR/3 (<span class="docutils literal">functional/input/data/standard.txt</span>, line 441); <em><a href="#id121">backlink</a></em></p> +<div class="system-message" id="system-message-5"> +<p class="system-message-title">System Message: ERROR/3 (<span class="docutils literal">functional/input/data/standard.txt</span>, line 441); <em><a href="#problematic-3">backlink</a></em></p> <p>Duplicate target name, cannot be used as a unique reference: "duplicate target names".</p> </div> </div> diff --git a/docutils/test/functional/expected/standalone_rst_latex.tex b/docutils/test/functional/expected/standalone_rst_latex.tex index 026b75a7d..0654c772e 100644 --- a/docutils/test/functional/expected/standalone_rst_latex.tex +++ b/docutils/test/functional/expected/standalone_rst_latex.tex @@ -347,17 +347,17 @@ A paragraph. Paragraphs contain text and may contain inline markup: \emph{emphasis}, \textbf{strong emphasis}, \texttt{inline literals}, standalone hyperlinks -(\url{http://www.python.org}), external hyperlinks (\href{http://www.python.org/}{Python}\DUfootnotemark{id30}{id29}{5}), internal +(\url{http://www.python.org}), external hyperlinks (\href{http://www.python.org/}{Python}\DUfootnotemark{footnote-reference-10}{footnote-6}{5}), internal cross-references (\hyperref[example]{example}), external hyperlinks with embedded URIs (\href{http://www.python.org}{Python web site}), \href{http://www.python.org/}{anonymous hyperlink -references}\DUfootnotemark{id38}{id29}{5} (\href{http://docutils.sourceforge.net/}{a second reference}\DUfootnotemark{id40}{id39}{8}), footnote references (manually -numbered\DUfootnotemark{id1}{id8}{1}, anonymous auto-numbered\DUfootnotemark{id2}{id12}{3}, labeled auto-numbered\DUfootnotemark{id3}{label}{2}, or symbolic\DUfootnotemark{id4}{id13}{*}), citation references (\hyperlink{cit2002}{[CIT2002]}), +references}\DUfootnotemark{footnote-reference-16}{footnote-6}{5} (\href{http://docutils.sourceforge.net/}{a second reference}\DUfootnotemark{footnote-reference-17}{footnote-9}{8}), footnote references (manually +numbered\DUfootnotemark{footnote-reference-1}{footnote-1}{1}, anonymous auto-numbered\DUfootnotemark{footnote-reference-2}{footnote-2}{3}, labeled auto-numbered\DUfootnotemark{footnote-reference-3}{label}{2}, or symbolic\DUfootnotemark{footnote-reference-4}{footnote-3}{*}), citation references (\hyperlink{cit2002}{[CIT2002]}), substitution references (\includegraphics{../../../docs/user/rst/images/biohazard.png} \& a \emph{trimmed heart} \texttt{(U+2665):}\ding{170}), and % \phantomsection\label{inline-hyperlink-targets}inline hyperlink targets (see \hyperref[targets]{Targets} below for a reference back to here). Character-level inline markup is also possible (although exceedingly ugly!) in \emph{re}\texttt{Structured}\emph{Text}. Problems are indicated by % -\raisebox{1em}{\hypertarget{id28}{}}\hyperlink{id27}{\textbf{\color{red}|problematic|}} text +\raisebox{1em}{\hypertarget{problematic-1}{}}\hyperlink{system-message-1}{\textbf{\color{red}|problematic|}} text (generated by processing errors; this one is intentional). Here is a reference to the \hyperref[doctitle]{doctitle} and the \hyperref[subtitle]{subtitle}. @@ -722,21 +722,21 @@ Python-specific usage examples; begun with ">>>" \label{footnotes}% } % -\DUfootnotetext{id8}{id1}{1}{% +\DUfootnotetext{footnote-1}{footnote-reference-1}{1}{% A footnote contains body elements, consistently indented by at least 3 spaces. This is the footnote’s second paragraph. } % -\DUfootnotetext{label}{id3}{2}{\phantomsection\label{label}% -Footnotes may be numbered, either manually (as in\DUfootnotemark{id9}{id8}{1}) or +\DUfootnotetext{label}{footnote-reference-3}{2}{\phantomsection\label{label}% +Footnotes may be numbered, either manually (as in\DUfootnotemark{footnote-reference-5}{footnote-1}{1}) 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 (\DUfootnotemark{id10}{label}{2}) and as a \hyperref[label]{hyperlink reference}. +footnote reference (\DUfootnotemark{footnote-reference-6}{label}{2}) and as a \hyperref[label]{hyperlink reference}. } % -\DUfootnotetext{id12}{id2}{3}{% +\DUfootnotetext{footnote-2}{footnote-reference-2}{3}{% This footnote is numbered automatically and anonymously using a label of “\#” only. @@ -745,19 +745,19 @@ This is the second paragraph. And this is the third paragraph. } % -\DUfootnotetext{id13}{id4}{*}{% +\DUfootnotetext{footnote-3}{footnote-reference-4}{*}{% Footnotes may also use symbols, specified with a “*” label. -Here’s a reference to the next footnote:\DUfootnotemark{id14}{id15}{†}. +Here’s a reference to the next footnote:\DUfootnotemark{footnote-reference-7}{footnote-4}{†}. } % -\DUfootnotetext{id15}{id14}{†}{% +\DUfootnotetext{footnote-4}{footnote-reference-7}{†}{% This footnote shows the next symbol in the sequence. } % -\DUfootnotetext{id16}{id16}{4}{% +\DUfootnotetext{footnote-5}{footnote-5}{4}{% Here’s an unreferenced footnote, with a reference to a nonexistent footnote:% -\raisebox{1em}{\hypertarget{id17}{}}\hyperlink{id45}{\textbf{\color{red}{[}5{]}\_}}. +\raisebox{1em}{\hypertarget{footnote-reference-8}{}}\hyperlink{system-message-2}{\textbf{\color{red}{[}5{]}\_}}. } @@ -770,7 +770,7 @@ rendered separately and differently from footnotes. \end{figure} Here’s a reference to the above, \hyperlink{cit2002}{[CIT2002]}, and a % -\raisebox{1em}{\hypertarget{id19}{}}\hyperlink{id46}{\textbf{\color{red}{[}nonexistent{]}\_}} +\raisebox{1em}{\hypertarget{citation-reference-3}{}}\hyperlink{system-message-3}{\textbf{\color{red}{[}nonexistent{]}\_}} citation. @@ -788,13 +788,13 @@ Section headers are implicit targets, referred to by name. See \hyperref[targets]{Targets}, which is a subsection of \hyperref[body-elements]{Body Elements}. Explicit external targets are interpolated into references such as -“\href{http://www.python.org/}{Python}\DUfootnotemark{id31}{id29}{5}”. +“\href{http://www.python.org/}{Python}\DUfootnotemark{footnote-reference-11}{footnote-6}{5}”. Targets may be indirect and anonymous. Thus \hyperref[targets]{this phrase} may also refer to the \hyperref[targets]{Targets} section. Here’s a % -\raisebox{1em}{\hypertarget{id48}{}}\hyperlink{id47}{\textbf{\color{red}`hyperlink reference without a target`\_}}, which generates an +\raisebox{1em}{\hypertarget{problematic-2}{}}\hyperlink{system-message-4}{\textbf{\color{red}`hyperlink reference without a target`\_}}, which generates an error. @@ -808,13 +808,13 @@ explicit targets will generate “warning” (level-2) system messages. \subsubsection{2.13.2 Duplicate Target Names% - \label{id21}% + \label{duplicate-target-names-1}% } Since there are two “Duplicate Target Names” section headers, we cannot uniquely refer to either of them by name. If we try to (like this: % -\raisebox{1em}{\hypertarget{id50}{}}\hyperlink{id49}{\textbf{\color{red}`Duplicate Target Names`\_}}), an error is generated. +\raisebox{1em}{\hypertarget{problematic-3}{}}\hyperlink{system-message-5}{\textbf{\color{red}`Duplicate Target Names`\_}}), an error is generated. \subsection{2.14 Directives% @@ -1241,23 +1241,23 @@ allowed (e.g. inside a directive). \label{target-footnotes}% } % -\DUfootnotetext{id29}{id30}{5}{% +\DUfootnotetext{footnote-6}{footnote-reference-10}{5}{% \url{http://www.python.org/} } % -\DUfootnotetext{id33}{id34}{6}{% +\DUfootnotetext{footnote-7}{footnote-reference-13}{6}{% \url{http://pygments.org/} } % -\DUfootnotetext{id35}{id36}{7}{% +\DUfootnotetext{footnote-8}{footnote-reference-14}{7}{% \url{ftp://ftp.ams.org/ams/doc/amsmath/short-math-guide.pdf} } % -\DUfootnotetext{id39}{id40}{8}{% +\DUfootnotetext{footnote-9}{footnote-reference-17}{8}{% \url{http://docutils.sourceforge.net/} } % -\DUfootnotetext{id41}{id42}{9}{% +\DUfootnotetext{footnote-10}{footnote-reference-18}{9}{% \url{A:DOS\\path\\} } @@ -1266,7 +1266,7 @@ allowed (e.g. inside a directive). \label{replacement-text}% } -I recommend you try \href{http://www.python.org/}{Python, \emph{the} best language around}\DUfootnotemark{id32}{id29}{5}. +I recommend you try \href{http://www.python.org/}{Python, \emph{the} best language around}\DUfootnotemark{footnote-reference-12}{footnote-6}{5}. \subsubsection{2.14.7 Compound Paragraph% @@ -1418,7 +1418,7 @@ This~is~a~parsed~literal~block.\\ Inline~markup~is~supported,~e.g.~\emph{emphasis},~\textbf{strong},~\texttt{literal\\ text},~\textsubscript{sub-}~and~\textsuperscript{super}scripts,\\ inline~formulas:~$A = 2 \pi r^2$,\\ -footnotes\DUfootnotemark{id22}{id8}{1},~% +footnotes\DUfootnotemark{footnote-reference-9}{footnote-1}{1},~% \phantomsection\label{hyperlink-targets}hyperlink~targets,~and~\href{http://www.python.org/}{references}. \end{quote} @@ -1428,7 +1428,7 @@ footnotes\DUfootnotemark{id22}{id8}{1},~% } Blocks of source code can be set with the \DUroletitlereference{code} directive. If the code -language is specified, the content is parsed and tagged by the \href{http://pygments.org/}{Pygments}\DUfootnotemark{id34}{id33}{6} +language is specified, the content is parsed and tagged by the \href{http://pygments.org/}{Pygments}\DUfootnotemark{footnote-reference-13}{footnote-7}{6} syntax highlighter and can be formatted with a style sheet. (Code parsing is turned off using the \texttt{syntax-highlight} config setting in the test conversions in order to get identical results with/without installed @@ -1896,7 +1896,7 @@ Modulation Transfer Function: \right). \end{equation*} Math split over two lines: If a double backslash is detected outside a -\texttt{\textbackslash{}begin\{...\} \textbackslash{}end\{...\}} pair, the math code is wrapped in an \href{ftp://ftp.ams.org/ams/doc/amsmath/short-math-guide.pdf}{AMSmath}\DUfootnotemark{id36}{id35}{7} +\texttt{\textbackslash{}begin\{...\} \textbackslash{}end\{...\}} pair, the math code is wrapped in an \href{ftp://ftp.ams.org/ams/doc/amsmath/short-math-guide.pdf}{AMSmath}\DUfootnotemark{footnote-reference-14}{footnote-8}{7} \texttt{align} environment: % \begin{align*} @@ -1911,7 +1911,7 @@ Cases (“manually”, with \texttt{matrix} environment): 1 & x>0 \end{matrix}\right. \end{equation*} -Cases with the \href{ftp://ftp.ams.org/ams/doc/amsmath/short-math-guide.pdf}{AMSmath}\DUfootnotemark{id37}{id35}{7} \texttt{cases} environment (not (yet) supported by +Cases with the \href{ftp://ftp.ams.org/ams/doc/amsmath/short-math-guide.pdf}{AMSmath}\DUfootnotemark{footnote-reference-15}{footnote-8}{7} \texttt{cases} environment (not (yet) supported by HTML writers with \texttt{-{}-math-output=MathML}): % \begin{equation*} @@ -2177,7 +2177,7 @@ third paragraph \\ \subsection{3.4 Option lists% - \label{id23}% + \label{option-lists-1}% } The LaTeX-2e description environment is used for definition lists. @@ -2758,7 +2758,7 @@ Handling by the LaTeX writer: \url{http://www.w3.org/XML/Schema\#dev} \item[] \href{http://www.w3.org/XML/Schema\%dev}{URL with \%} \url{http://example.org/Schema\%dev} -\item[] \href{A:DOS\\path\\}{file with DOS path}\DUfootnotemark{id42}{id41}{9} \url{A:DOS\\path\\}\DUfootnotemark{id43}{id41}{9} +\item[] \href{A:DOS\\path\\}{file with DOS path}\DUfootnotemark{footnote-reference-18}{footnote-10}{9} \url{A:DOS\\path\\}\DUfootnotemark{footnote-reference-19}{footnote-10}{9} \end{DUlineblock} \DUadmonition[note]{ @@ -2769,7 +2769,7 @@ These URLs are typeset inside a LaTeX command without error. \begin{DUlineblock}{0em} \item[] \url{http://www.w3.org/XML/Schema\#dev} \item[] \url{http://example.org/Schema\%dev} -\item[] \url{A:DOS\\path\\}\DUfootnotemark{id44}{id41}{9} +\item[] \url{A:DOS\\path\\}\DUfootnotemark{footnote-reference-20}{footnote-10}{9} \end{DUlineblock} } \end{itemize} @@ -2872,51 +2872,51 @@ section, “Docutils System Messages”: \DUadmonition[system-message]{ \DUtitle[system-message]{system-message} -\raisebox{1em}{\hypertarget{id27}{}} +\raisebox{1em}{\hypertarget{system-message-1}{}} {\color{red}ERROR/3} in \texttt{functional/input/data/standard.txt}, line~104 -\hyperlink{id28}{ +\hyperlink{problematic-1}{ Undefined substitution referenced: \textquotedbl{}problematic\textquotedbl{}. }} \DUadmonition[system-message]{ \DUtitle[system-message]{system-message} -\raisebox{1em}{\hypertarget{id45}{}} +\raisebox{1em}{\hypertarget{system-message-2}{}} {\color{red}ERROR/3} in \texttt{functional/input/data/standard.txt}, line~392 -\hyperlink{id17}{ +\hyperlink{footnote-reference-8}{ Unknown target name: \textquotedbl{}5\textquotedbl{}. }} \DUadmonition[system-message]{ \DUtitle[system-message]{system-message} -\raisebox{1em}{\hypertarget{id46}{}} +\raisebox{1em}{\hypertarget{system-message-3}{}} {\color{red}ERROR/3} in \texttt{functional/input/data/standard.txt}, line~401 -\hyperlink{id19}{ +\hyperlink{citation-reference-3}{ Unknown target name: \textquotedbl{}nonexistent\textquotedbl{}. }} \DUadmonition[system-message]{ \DUtitle[system-message]{system-message} -\raisebox{1em}{\hypertarget{id47}{}} +\raisebox{1em}{\hypertarget{system-message-4}{}} {\color{red}ERROR/3} in \texttt{functional/input/data/standard.txt}, line~428 -\hyperlink{id48}{ +\hyperlink{problematic-2}{ Unknown target name: \textquotedbl{}hyperlink reference without a target\textquotedbl{}. }} \DUadmonition[system-message]{ \DUtitle[system-message]{system-message} -\raisebox{1em}{\hypertarget{id49}{}} +\raisebox{1em}{\hypertarget{system-message-5}{}} {\color{red}ERROR/3} in \texttt{functional/input/data/standard.txt}, line~441 -\hyperlink{id50}{ +\hyperlink{problematic-3}{ Duplicate target name, cannot be used as a unique reference: \textquotedbl{}duplicate target names\textquotedbl{}. }} diff --git a/docutils/test/functional/expected/standalone_rst_pseudoxml.txt b/docutils/test/functional/expected/standalone_rst_pseudoxml.txt index a6887ef4f..fcf23fedb 100644 --- a/docutils/test/functional/expected/standalone_rst_pseudoxml.txt +++ b/docutils/test/functional/expected/standalone_rst_pseudoxml.txt @@ -93,256 +93,256 @@ <bullet_list classes="auto-toc"> <list_item> <paragraph> - <reference ids="id34" refid="structural-elements"> + <reference ids="toc-entry-1" refid="structural-elements"> <generated classes="sectnum"> 1 Structural Elements <bullet_list classes="auto-toc"> <list_item> <paragraph> - <reference ids="id35" refid="section-title"> + <reference ids="toc-entry-2" refid="section-title"> <generated classes="sectnum"> 1.1 Section Title <list_item> <paragraph> - <reference ids="id36" refid="empty-section"> + <reference ids="toc-entry-3" refid="empty-section"> <generated classes="sectnum"> 1.2 Empty Section <list_item> <paragraph> - <reference ids="id37" refid="transitions"> + <reference ids="toc-entry-4" refid="transitions"> <generated classes="sectnum"> 1.3 Transitions <list_item> <paragraph> - <reference ids="id38" refid="body-elements"> + <reference ids="toc-entry-5" refid="body-elements"> <generated classes="sectnum"> 2 Body Elements <bullet_list classes="auto-toc"> <list_item> <paragraph> - <reference ids="id39" refid="paragraphs"> + <reference ids="toc-entry-6" refid="paragraphs"> <generated classes="sectnum"> 2.1 Paragraphs <bullet_list classes="auto-toc"> <list_item> <paragraph> - <reference ids="id40" refid="inline-markup"> + <reference ids="toc-entry-7" refid="inline-markup"> <generated classes="sectnum"> 2.1.1 Inline Markup <list_item> <paragraph> - <reference ids="id41" refid="bullet-lists"> + <reference ids="toc-entry-8" refid="bullet-lists"> <generated classes="sectnum"> 2.2 Bullet Lists <list_item> <paragraph> - <reference ids="id42" refid="enumerated-lists"> + <reference ids="toc-entry-9" refid="enumerated-lists"> <generated classes="sectnum"> 2.3 Enumerated Lists <list_item> <paragraph> - <reference ids="id43" refid="definition-lists"> + <reference ids="toc-entry-10" refid="definition-lists"> <generated classes="sectnum"> 2.4 Definition Lists <list_item> <paragraph> - <reference ids="id44" refid="field-lists"> + <reference ids="toc-entry-11" refid="field-lists"> <generated classes="sectnum"> 2.5 Field Lists <list_item> <paragraph> - <reference ids="id45" refid="option-lists"> + <reference ids="toc-entry-12" refid="option-lists"> <generated classes="sectnum"> 2.6 Option Lists <list_item> <paragraph> - <reference ids="id46" refid="literal-blocks"> + <reference ids="toc-entry-13" refid="literal-blocks"> <generated classes="sectnum"> 2.7 Literal Blocks <list_item> <paragraph> - <reference ids="id47" refid="line-blocks"> + <reference ids="toc-entry-14" refid="line-blocks"> <generated classes="sectnum"> 2.8 Line Blocks <list_item> <paragraph> - <reference ids="id48" refid="block-quotes"> + <reference ids="toc-entry-15" refid="block-quotes"> <generated classes="sectnum"> 2.9 Block Quotes <list_item> <paragraph> - <reference ids="id49" refid="doctest-blocks"> + <reference ids="toc-entry-16" refid="doctest-blocks"> <generated classes="sectnum"> 2.10 Doctest Blocks <list_item> <paragraph> - <reference ids="id50" refid="footnotes"> + <reference ids="toc-entry-17" refid="footnotes"> <generated classes="sectnum"> 2.11 Footnotes <list_item> <paragraph> - <reference ids="id51" refid="citations"> + <reference ids="toc-entry-18" refid="citations"> <generated classes="sectnum"> 2.12 Citations <list_item> <paragraph> - <reference ids="id52" refid="targets"> + <reference ids="toc-entry-19" refid="targets"> <generated classes="sectnum"> 2.13 Targets <bullet_list classes="auto-toc"> <list_item> <paragraph> - <reference ids="id53" refid="duplicate-target-names"> + <reference ids="toc-entry-20" refid="duplicate-target-names"> <generated classes="sectnum"> 2.13.1 Duplicate Target Names <list_item> <paragraph> - <reference ids="id54" refid="id21"> + <reference ids="toc-entry-21" refid="duplicate-target-names-1"> <generated classes="sectnum"> 2.13.2 Duplicate Target Names <list_item> <paragraph> - <reference ids="id55" refid="directives"> + <reference ids="toc-entry-22" refid="directives"> <generated classes="sectnum"> 2.14 Directives <bullet_list classes="auto-toc"> <list_item> <paragraph> - <reference ids="id56" refid="document-parts"> + <reference ids="toc-entry-23" refid="document-parts"> <generated classes="sectnum"> 2.14.1 Document Parts <list_item> <paragraph> - <reference ids="id57" refid="images-and-figures"> + <reference ids="toc-entry-24" refid="images-and-figures"> <generated classes="sectnum"> 2.14.2 Images and Figures <list_item> <paragraph> - <reference ids="id58" refid="admonitions"> + <reference ids="toc-entry-25" refid="admonitions"> <generated classes="sectnum"> 2.14.3 Admonitions <list_item> <paragraph> - <reference ids="id59" refid="topics-sidebars-and-rubrics"> + <reference ids="toc-entry-26" refid="topics-sidebars-and-rubrics"> <generated classes="sectnum"> 2.14.4 Topics, Sidebars, and Rubrics <list_item> <paragraph> - <reference ids="id60" refid="target-footnotes"> + <reference ids="toc-entry-27" refid="target-footnotes"> <generated classes="sectnum"> 2.14.5 Target Footnotes <list_item> <paragraph> - <reference ids="id61" refid="replacement-text"> + <reference ids="toc-entry-28" refid="replacement-text"> <generated classes="sectnum"> 2.14.6 Replacement Text <list_item> <paragraph> - <reference ids="id62" refid="compound-paragraph"> + <reference ids="toc-entry-29" refid="compound-paragraph"> <generated classes="sectnum"> 2.14.7 Compound Paragraph <list_item> <paragraph> - <reference ids="id63" refid="parsed-literal-blocks"> + <reference ids="toc-entry-30" refid="parsed-literal-blocks"> <generated classes="sectnum"> 2.14.8 Parsed Literal Blocks <list_item> <paragraph> - <reference ids="id64" refid="code"> + <reference ids="toc-entry-31" refid="code"> <generated classes="sectnum"> 2.14.9 Code <list_item> <paragraph> - <reference ids="id65" refid="substitution-definitions"> + <reference ids="toc-entry-32" refid="substitution-definitions"> <generated classes="sectnum"> 2.15 Substitution Definitions <list_item> <paragraph> - <reference ids="id66" refid="comments"> + <reference ids="toc-entry-33" refid="comments"> <generated classes="sectnum"> 2.16 Comments <list_item> <paragraph> - <reference ids="id67" refid="raw-text"> + <reference ids="toc-entry-34" refid="raw-text"> <generated classes="sectnum"> 2.17 Raw text <list_item> <paragraph> - <reference ids="id68" refid="container"> + <reference ids="toc-entry-35" refid="container"> <generated classes="sectnum"> 2.18 Container <list_item> <paragraph> - <reference ids="id69" refid="colspanning-tables"> + <reference ids="toc-entry-36" refid="colspanning-tables"> <generated classes="sectnum"> 2.19 Colspanning tables <list_item> <paragraph> - <reference ids="id70" refid="rowspanning-tables"> + <reference ids="toc-entry-37" refid="rowspanning-tables"> <generated classes="sectnum"> 2.20 Rowspanning tables <list_item> <paragraph> - <reference ids="id71" refid="complex-tables"> + <reference ids="toc-entry-38" refid="complex-tables"> <generated classes="sectnum"> 2.21 Complex tables <list_item> <paragraph> - <reference ids="id72" refid="list-tables"> + <reference ids="toc-entry-39" refid="list-tables"> <generated classes="sectnum"> 2.22 List Tables <list_item> <paragraph> - <reference ids="id73" refid="error-handling"> + <reference ids="toc-entry-40" refid="error-handling"> <generated classes="sectnum"> 3 Error Handling <section ids="structural-elements" names="structural\ elements"> - <title auto="1" refid="id34"> + <title auto="1" refid="toc-entry-1"> <generated classes="sectnum"> 1 Structural Elements <section ids="section-title" names="section\ title"> - <title auto="1" refid="id35"> + <title auto="1" refid="toc-entry-2"> <generated classes="sectnum"> 1.1 Section Title @@ -358,12 +358,12 @@ sectsubtitle-xform configuration value. <section ids="empty-section" names="empty\ section"> - <title auto="1" refid="id36"> + <title auto="1" refid="toc-entry-3"> <generated classes="sectnum"> 1.2 Empty Section <section ids="transitions" names="transitions"> - <title auto="1" refid="id37"> + <title auto="1" refid="toc-entry-4"> <generated classes="sectnum"> 1.3 Transitions @@ -374,19 +374,19 @@ It divides the section. Transitions may also occur between sections: <transition> <section ids="body-elements" names="body\ elements"> - <title auto="1" refid="id38"> + <title auto="1" refid="toc-entry-5"> <generated classes="sectnum"> 2 Body Elements <section ids="paragraphs" names="paragraphs"> - <title auto="1" refid="id39"> + <title auto="1" refid="toc-entry-6"> <generated classes="sectnum"> 2.1 Paragraphs <paragraph> A paragraph. <section ids="inline-markup" names="inline\ markup"> - <title auto="1" refid="id40"> + <title auto="1" refid="toc-entry-7"> <generated classes="sectnum"> 2.1.1 Inline Markup @@ -408,7 +408,7 @@ <reference name="Python" refuri="http://www.python.org/"> Python - <footnote_reference auto="1" ids="id26" refid="id25"> + <footnote_reference auto="1" ids="footnote-reference-10" refid="footnote-6"> 5 ), internal cross-references ( @@ -423,29 +423,29 @@ anonymous hyperlink references - <footnote_reference auto="1" ids="id31" refid="id25"> + <footnote_reference auto="1" ids="footnote-reference-14" refid="footnote-6"> 5 ( <reference anonymous="1" name="a second reference" refuri="http://docutils.sourceforge.net/"> a second reference - <footnote_reference auto="1" ids="id33" refid="id32"> + <footnote_reference auto="1" ids="footnote-reference-15" refid="footnote-8"> 7 ), footnote references (manually numbered - <footnote_reference ids="id1" refid="id8"> + <footnote_reference ids="footnote-reference-1" refid="footnote-1"> 1 , anonymous auto-numbered - <footnote_reference auto="1" ids="id2" refid="id12"> + <footnote_reference auto="1" ids="footnote-reference-2" refid="footnote-2"> 3 , labeled auto-numbered - <footnote_reference auto="1" ids="id3" refid="label"> + <footnote_reference auto="1" ids="footnote-reference-3" refid="label"> 2 , or symbolic - <footnote_reference auto="*" ids="id4" refid="id13"> + <footnote_reference auto="*" ids="footnote-reference-4" refid="footnote-3"> * ), citation references ( - <citation_reference ids="id5" refid="cit2002"> + <citation_reference ids="citation-reference-1" refid="cit2002"> CIT2002 ), substitution references ( @@ -474,7 +474,7 @@ <emphasis> Text . Problems are indicated by - <problematic ids="id24" refid="id23"> + <problematic ids="problematic-1" refid="system-message-1"> |problematic| text (generated by processing errors; this one is intentional). Here is a @@ -485,8 +485,8 @@ <reference name="subtitle" refid="subtitle"> subtitle . - <target anonymous="1" ids="id6" refuri="http://www.python.org/"> - <target anonymous="1" ids="id7" refuri="http://docutils.sourceforge.net/"> + <target anonymous="1" ids="target-1" refuri="http://www.python.org/"> + <target anonymous="1" ids="target-2" refuri="http://docutils.sourceforge.net/"> <paragraph> The default role for interpreted text is <title_reference> @@ -546,7 +546,7 @@ option was supplied, there should be a live link to PEP 258 here. <section ids="bullet-lists" names="bullet\ lists"> - <title auto="1" refid="id41"> + <title auto="1" refid="toc-entry-8"> <generated classes="sectnum"> 2.2 Bullet Lists @@ -590,7 +590,7 @@ <comment xml:space="preserve"> Even if this item contains a target and a comment. <section ids="enumerated-lists" names="enumerated\ lists"> - <title auto="1" refid="id42"> + <title auto="1" refid="toc-entry-9"> <generated classes="sectnum"> 2.3 Enumerated Lists @@ -648,7 +648,7 @@ <paragraph> Enumerated list start value not ordinal-1: "iii" (ordinal 3) <section ids="definition-lists" names="definition\ lists"> - <title auto="1" refid="id43"> + <title auto="1" refid="toc-entry-10"> <generated classes="sectnum"> 2.4 Definition Lists @@ -686,7 +686,7 @@ <paragraph> Definition <section ids="field-lists" names="field\ lists"> - <title auto="1" refid="id44"> + <title auto="1" refid="toc-entry-11"> <generated classes="sectnum"> 2.5 Field Lists @@ -720,7 +720,7 @@ about credits but just for ensuring that the class attribute doesn't get stripped away.) <section ids="option-lists" names="option\ lists"> - <title auto="1" refid="id45"> + <title auto="1" refid="toc-entry-12"> <generated classes="sectnum"> 2.6 Option Lists @@ -833,7 +833,7 @@ There must be at least two spaces between the option and the description. <section ids="literal-blocks" names="literal\ blocks"> - <title auto="1" refid="id46"> + <title auto="1" refid="toc-entry-13"> <generated classes="sectnum"> 2.7 Literal Blocks @@ -855,7 +855,7 @@ > > Why didn't I think of that? <section ids="line-blocks" names="line\ blocks"> - <title auto="1" refid="id47"> + <title auto="1" refid="toc-entry-14"> <generated classes="sectnum"> 2.8 Line Blocks @@ -958,7 +958,7 @@ w. <line> <section ids="block-quotes" names="block\ quotes"> - <title auto="1" refid="id48"> + <title auto="1" refid="toc-entry-15"> <generated classes="sectnum"> 2.9 Block Quotes @@ -982,7 +982,7 @@ ReStructuredText est un langage de balisage léger utilisé notamment dans la documentation du langage Python. <section ids="doctest-blocks" names="doctest\ blocks"> - <title auto="1" refid="id49"> + <title auto="1" refid="toc-entry-16"> <generated classes="sectnum"> 2.10 Doctest Blocks @@ -992,11 +992,11 @@ >>> print '(cut and pasted from interactive Python sessions)' (cut and pasted from interactive Python sessions) <section ids="footnotes" names="footnotes"> - <title auto="1" refid="id50"> + <title auto="1" refid="toc-entry-17"> <generated classes="sectnum"> 2.11 Footnotes - <footnote backrefs="id1 id9 id22" ids="id8" names="1"> + <footnote backrefs="footnote-reference-1 footnote-reference-5 footnote-reference-9" ids="footnote-1" names="1"> <label> 1 <paragraph> @@ -1004,25 +1004,25 @@ least 3 spaces. <paragraph> This is the footnote's second paragraph. - <footnote auto="1" backrefs="id3 id10" ids="label" names="label"> + <footnote auto="1" backrefs="footnote-reference-3 footnote-reference-6" ids="label" names="label"> <label> 2 <paragraph> Footnotes may be numbered, either manually (as in - <footnote_reference ids="id9" refid="id8"> + <footnote_reference ids="footnote-reference-5" refid="footnote-1"> 1 ) 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 ( - <footnote_reference auto="1" ids="id10" refid="label"> + <footnote_reference auto="1" ids="footnote-reference-6" refid="label"> 2 ) and as a <reference anonymous="1" name="hyperlink reference" refid="label"> hyperlink reference . - <target anonymous="1" ids="id11" refid="label"> - <footnote auto="1" backrefs="id2" ids="id12" names="3"> + <target anonymous="1" ids="target-3" refid="label"> + <footnote auto="1" backrefs="footnote-reference-2" ids="footnote-2" names="3"> <label> 3 <paragraph> @@ -1032,35 +1032,35 @@ This is the second paragraph. <paragraph> And this is the third paragraph. - <footnote auto="*" backrefs="id4" ids="id13"> + <footnote auto="*" backrefs="footnote-reference-4" ids="footnote-3"> <label> * <paragraph> Footnotes may also use symbols, specified with a "*" label. Here's a reference to the next footnote: - <footnote_reference auto="*" ids="id14" refid="id15"> + <footnote_reference auto="*" ids="footnote-reference-7" refid="footnote-4"> † . - <footnote auto="*" backrefs="id14" ids="id15"> + <footnote auto="*" backrefs="footnote-reference-7" ids="footnote-4"> <label> † <paragraph> This footnote shows the next symbol in the sequence. - <footnote ids="id16" names="4"> + <footnote ids="footnote-5" names="4"> <label> 4 <paragraph> Here's an unreferenced footnote, with a reference to a nonexistent footnote: - <problematic ids="id17" refid="id83"> + <problematic ids="footnote-reference-8" refid="system-message-2"> [5]_ . <section ids="citations" names="citations"> - <title auto="1" refid="id51"> + <title auto="1" refid="toc-entry-18"> <generated classes="sectnum"> 2.12 Citations - <citation backrefs="id5 id18" ids="cit2002" names="cit2002"> + <citation backrefs="citation-reference-1 citation-reference-2" ids="cit2002" names="cit2002"> <label> CIT2002 <paragraph> @@ -1068,16 +1068,16 @@ rendered separately and differently from footnotes. <paragraph> Here's a reference to the above, - <citation_reference ids="id18" refid="cit2002"> + <citation_reference ids="citation-reference-2" refid="cit2002"> CIT2002 , and a - <problematic ids="id19" refid="id84"> + <problematic ids="citation-reference-3" refid="system-message-3"> [nonexistent]_ citation. <target refid="another-target"> <section ids="targets another-target" names="targets another\ target"> - <title auto="1" refid="id52"> + <title auto="1" refid="toc-entry-19"> <generated classes="sectnum"> 2.13 Targets @@ -1106,7 +1106,7 @@ <reference name="Python" refuri="http://www.python.org/"> Python - <footnote_reference auto="1" ids="id27" refid="id25"> + <footnote_reference auto="1" ids="footnote-reference-11" refid="footnote-6"> 5 ". <target ids="python" names="python" refuri="http://www.python.org/"> @@ -1119,15 +1119,15 @@ <reference name="Targets" refid="targets"> Targets section. - <target anonymous="1" ids="id20" refid="targets"> + <target anonymous="1" ids="target-4" refid="targets"> <paragraph> Here's a - <problematic ids="id86" refid="id85"> + <problematic ids="problematic-2" refid="system-message-4"> `hyperlink reference without a target`_ , which generates an error. <section dupnames="duplicate\ target\ names" ids="duplicate-target-names"> - <title auto="1" refid="id53"> + <title auto="1" refid="toc-entry-20"> <generated classes="sectnum"> 2.13.1 Duplicate Target Names @@ -1135,23 +1135,23 @@ Duplicate names in section headers or other implicit targets will generate "info" (level-1) system messages. Duplicate names in explicit targets will generate "warning" (level-2) system messages. - <section dupnames="duplicate\ target\ names" ids="id21"> - <title auto="1" refid="id54"> + <section dupnames="duplicate\ target\ names" ids="duplicate-target-names-1"> + <title auto="1" refid="toc-entry-21"> <generated classes="sectnum"> 2.13.2 Duplicate Target Names - <system_message backrefs="id21" level="1" line="439" source="functional/input/data/standard.txt" type="INFO"> + <system_message backrefs="duplicate-target-names-1" level="1" line="439" source="functional/input/data/standard.txt" type="INFO"> <paragraph> Duplicate implicit target name: "duplicate target names". <paragraph> Since there are two "Duplicate Target Names" section headers, we cannot uniquely refer to either of them by name. If we try to (like this: - <problematic ids="id88" refid="id87"> + <problematic ids="problematic-3" refid="system-message-5"> `Duplicate Target Names`_ ), an error is generated. <section ids="directives" names="directives"> - <title auto="1" refid="id55"> + <title auto="1" refid="toc-entry-22"> <generated classes="sectnum"> 2.14 Directives @@ -1159,55 +1159,55 @@ <bullet_list classes="auto-toc"> <list_item> <paragraph> - <reference ids="id74" refid="document-parts"> + <reference ids="toc-entry-41" refid="document-parts"> <generated classes="sectnum"> 2.14.1 Document Parts <list_item> <paragraph> - <reference ids="id75" refid="images-and-figures"> + <reference ids="toc-entry-42" refid="images-and-figures"> <generated classes="sectnum"> 2.14.2 Images and Figures <list_item> <paragraph> - <reference ids="id76" refid="admonitions"> + <reference ids="toc-entry-43" refid="admonitions"> <generated classes="sectnum"> 2.14.3 Admonitions <list_item> <paragraph> - <reference ids="id77" refid="topics-sidebars-and-rubrics"> + <reference ids="toc-entry-44" refid="topics-sidebars-and-rubrics"> <generated classes="sectnum"> 2.14.4 Topics, Sidebars, and Rubrics <list_item> <paragraph> - <reference ids="id78" refid="target-footnotes"> + <reference ids="toc-entry-45" refid="target-footnotes"> <generated classes="sectnum"> 2.14.5 Target Footnotes <list_item> <paragraph> - <reference ids="id79" refid="replacement-text"> + <reference ids="toc-entry-46" refid="replacement-text"> <generated classes="sectnum"> 2.14.6 Replacement Text <list_item> <paragraph> - <reference ids="id80" refid="compound-paragraph"> + <reference ids="toc-entry-47" refid="compound-paragraph"> <generated classes="sectnum"> 2.14.7 Compound Paragraph <list_item> <paragraph> - <reference ids="id81" refid="parsed-literal-blocks"> + <reference ids="toc-entry-48" refid="parsed-literal-blocks"> <generated classes="sectnum"> 2.14.8 Parsed Literal Blocks <list_item> <paragraph> - <reference ids="id82" refid="code"> + <reference ids="toc-entry-49" refid="code"> <generated classes="sectnum"> 2.14.9 Code @@ -1218,7 +1218,7 @@ http://docutils.sourceforge.net/docs/ref/rst/directives.html . <section ids="document-parts" names="document\ parts"> - <title auto="1" refid="id74"> + <title auto="1" refid="toc-entry-41"> <generated classes="sectnum"> 2.14.1 Document Parts @@ -1233,7 +1233,7 @@ table of contents ). <section ids="images-and-figures" names="images\ and\ figures"> - <title auto="1" refid="id75"> + <title auto="1" refid="toc-entry-42"> <generated classes="sectnum"> 2.14.2 Images and Figures @@ -1526,7 +1526,7 @@ <paragraph> True <section ids="admonitions" names="admonitions"> - <title auto="1" refid="id76"> + <title auto="1" refid="toc-entry-43"> <generated classes="sectnum"> 2.14.3 Admonitions @@ -1576,7 +1576,7 @@ You can make up your own admonition too. <target ids="docutils" names="docutils" refuri="http://docutils.sourceforge.net/"> <section ids="topics-sidebars-and-rubrics" names="topics,\ sidebars,\ and\ rubrics"> - <title auto="1" refid="id77"> + <title auto="1" refid="toc-entry-44"> <generated classes="sectnum"> 2.14.4 Topics, Sidebars, and Rubrics @@ -1623,30 +1623,30 @@ is not allowed (e.g. inside a directive). <section ids="target-footnotes" names="target\ footnotes"> - <title auto="1" refid="id78"> + <title auto="1" refid="toc-entry-45"> <generated classes="sectnum"> 2.14.5 Target Footnotes - <footnote auto="1" backrefs="id26 id27 id28 id31" ids="id25" names="TARGET_NOTE:\ id25"> + <footnote auto="1" backrefs="footnote-reference-10 footnote-reference-11 footnote-reference-12 footnote-reference-14" ids="footnote-6" names="TARGET_NOTE:\ footnote-6"> <label> 5 <paragraph> <reference refuri="http://www.python.org/"> http://www.python.org/ - <footnote auto="1" backrefs="id30" ids="id29" names="TARGET_NOTE:\ id29"> + <footnote auto="1" backrefs="footnote-reference-13" ids="footnote-7" names="TARGET_NOTE:\ footnote-7"> <label> 6 <paragraph> <reference refuri="http://pygments.org/"> http://pygments.org/ - <footnote auto="1" backrefs="id33" ids="id32" names="TARGET_NOTE:\ id32"> + <footnote auto="1" backrefs="footnote-reference-15" ids="footnote-8" names="TARGET_NOTE:\ footnote-8"> <label> 7 <paragraph> <reference refuri="http://docutils.sourceforge.net/"> http://docutils.sourceforge.net/ <section ids="replacement-text" names="replacement\ text"> - <title auto="1" refid="id79"> + <title auto="1" refid="toc-entry-46"> <generated classes="sectnum"> 2.14.6 Replacement Text @@ -1658,7 +1658,7 @@ the best language around - <footnote_reference auto="1" ids="id28" refid="id25"> + <footnote_reference auto="1" ids="footnote-reference-12" refid="footnote-6"> 5 . <substitution_definition names="Python"> @@ -1667,7 +1667,7 @@ the best language around <section ids="compound-paragraph" names="compound\ paragraph"> - <title auto="1" refid="id80"> + <title auto="1" refid="toc-entry-47"> <generated classes="sectnum"> 2.14.7 Compound Paragraph @@ -1822,7 +1822,7 @@ <paragraph> and the final paragraph of the compound 7. <section ids="parsed-literal-blocks" names="parsed\ literal\ blocks"> - <title auto="1" refid="id81"> + <title auto="1" refid="toc-entry-48"> <generated classes="sectnum"> 2.14.8 Parsed Literal Blocks @@ -1852,7 +1852,7 @@ A = 2 \pi r^2 , footnotes - <footnote_reference ids="id22" refid="id8"> + <footnote_reference ids="footnote-reference-9" refid="footnote-1"> 1 , <target ids="hyperlink-targets" names="hyperlink\ targets"> @@ -1863,7 +1863,7 @@ <target ids="references" names="references" refuri="http://www.python.org/"> . <section ids="code" names="code"> - <title auto="1" refid="id82"> + <title auto="1" refid="toc-entry-49"> <generated classes="sectnum"> 2.14.9 Code @@ -1876,7 +1876,7 @@ <reference name="Pygments" refuri="http://pygments.org/"> Pygments - <footnote_reference auto="1" ids="id30" refid="id29"> + <footnote_reference auto="1" ids="footnote-reference-13" refid="footnote-7"> 6 syntax highlighter and can be formatted with a style sheet. (Code parsing @@ -1941,7 +1941,7 @@ .. footer:: Document footer <target ids="pygments" names="pygments" refuri="http://pygments.org/"> <section ids="substitution-definitions" names="substitution\ definitions"> - <title auto="1" refid="id65"> + <title auto="1" refid="toc-entry-32"> <generated classes="sectnum"> 2.15 Substitution Definitions @@ -1958,7 +1958,7 @@ <paragraph> (Substitution definitions are not visible in the HTML source.) <section ids="comments" names="comments"> - <title auto="1" refid="id66"> + <title auto="1" refid="toc-entry-33"> <generated classes="sectnum"> 2.16 Comments @@ -1975,7 +1975,7 @@ <paragraph> (View the HTML source to see the comment.) <section ids="raw-text" names="raw\ text"> - <title auto="1" refid="id67"> + <title auto="1" refid="toc-entry-34"> <generated classes="sectnum"> 2.17 Raw text @@ -1999,7 +1999,7 @@ <raw format="latex" xml:space="preserve"> Fifth test in LaTeX.\\Line two. <section ids="container" names="container"> - <title auto="1" refid="id68"> + <title auto="1" refid="toc-entry-35"> <generated classes="sectnum"> 2.18 Container @@ -2009,7 +2009,7 @@ <paragraph> paragraph 2 <section ids="colspanning-tables" names="colspanning\ tables"> - <title auto="1" refid="id69"> + <title auto="1" refid="toc-entry-36"> <generated classes="sectnum"> 2.19 Colspanning tables @@ -2080,7 +2080,7 @@ <paragraph> True <section ids="rowspanning-tables" names="rowspanning\ tables"> - <title auto="1" refid="id70"> + <title auto="1" refid="toc-entry-37"> <generated classes="sectnum"> 2.20 Rowspanning tables @@ -2132,7 +2132,7 @@ <paragraph> body row 3 <section ids="complex-tables" names="complex\ tables"> - <title auto="1" refid="id71"> + <title auto="1" refid="toc-entry-38"> <generated classes="sectnum"> 2.21 Complex tables @@ -2217,7 +2217,7 @@ --> <entry> <section ids="list-tables" names="list\ tables"> - <title auto="1" refid="id72"> + <title auto="1" refid="toc-entry-39"> <generated classes="sectnum"> 2.22 List Tables @@ -2302,7 +2302,7 @@ <paragraph> 1.99 <section ids="error-handling" names="error\ handling"> - <title auto="1" refid="id73"> + <title auto="1" refid="toc-entry-40"> <generated classes="sectnum"> 3 Error Handling @@ -2316,19 +2316,19 @@ <section classes="system-messages"> <title> Docutils System Messages - <system_message backrefs="id24" ids="id23" level="3" line="104" source="functional/input/data/standard.txt" type="ERROR"> + <system_message backrefs="problematic-1" ids="system-message-1" level="3" line="104" source="functional/input/data/standard.txt" type="ERROR"> <paragraph> Undefined substitution referenced: "problematic". - <system_message backrefs="id17" ids="id83" level="3" line="392" source="functional/input/data/standard.txt" type="ERROR"> + <system_message backrefs="footnote-reference-8" ids="system-message-2" level="3" line="392" source="functional/input/data/standard.txt" type="ERROR"> <paragraph> Unknown target name: "5". - <system_message backrefs="id19" ids="id84" level="3" line="401" source="functional/input/data/standard.txt" type="ERROR"> + <system_message backrefs="citation-reference-3" ids="system-message-3" level="3" line="401" source="functional/input/data/standard.txt" type="ERROR"> <paragraph> Unknown target name: "nonexistent". - <system_message backrefs="id86" ids="id85" level="3" line="428" source="functional/input/data/standard.txt" type="ERROR"> + <system_message backrefs="problematic-2" ids="system-message-4" level="3" line="428" source="functional/input/data/standard.txt" type="ERROR"> <paragraph> Unknown target name: "hyperlink reference without a target". - <system_message backrefs="id88" ids="id87" level="3" line="441" source="functional/input/data/standard.txt" type="ERROR"> + <system_message backrefs="problematic-3" ids="system-message-5" level="3" line="441" source="functional/input/data/standard.txt" type="ERROR"> <paragraph> Duplicate target name, cannot be used as a unique reference: "duplicate target names". <system_message level="1" line="164" source="functional/input/data/standard.txt" type="INFO"> diff --git a/docutils/test/functional/expected/standalone_rst_s5_html_1.html b/docutils/test/functional/expected/standalone_rst_s5_html_1.html index 23b7b8ff0..a65989e8f 100644 --- a/docutils/test/functional/expected/standalone_rst_s5_html_1.html +++ b/docutils/test/functional/expected/standalone_rst_s5_html_1.html @@ -71,10 +71,10 @@ <div class="contents handout topic" id="contents"> <p class="topic-title">Contents</p> <ul class="simple"> -<li><a class="reference internal" href="#introduction" id="id1">Introduction</a></li> -<li><a class="reference internal" href="#features-1" id="id2">Features (1)</a></li> -<li><a class="reference internal" href="#features-2" id="id3">Features (2)</a></li> -<li><a class="reference internal" href="#checklist" id="id4">Checklist</a></li> +<li><a class="reference internal" href="#introduction" id="toc-entry-1">Introduction</a></li> +<li><a class="reference internal" href="#features-1" id="toc-entry-2">Features (1)</a></li> +<li><a class="reference internal" href="#features-2" id="toc-entry-3">Features (2)</a></li> +<li><a class="reference internal" href="#checklist" id="toc-entry-4">Checklist</a></li> </ul> </div> <p class="handout">This is a test. This is only a test. If this were a real slide diff --git a/docutils/test/functional/expected/standalone_rst_s5_html_2.html b/docutils/test/functional/expected/standalone_rst_s5_html_2.html index 6626b1145..066cb0924 100644 --- a/docutils/test/functional/expected/standalone_rst_s5_html_2.html +++ b/docutils/test/functional/expected/standalone_rst_s5_html_2.html @@ -67,10 +67,10 @@ <div class="contents handout topic" id="contents"> <p class="topic-title">Contents</p> <ul class="simple"> -<li><a class="reference internal" href="#introduction" id="id1">Introduction</a></li> -<li><a class="reference internal" href="#features-1" id="id2">Features (1)</a></li> -<li><a class="reference internal" href="#features-2" id="id3">Features (2)</a></li> -<li><a class="reference internal" href="#checklist" id="id4">Checklist</a></li> +<li><a class="reference internal" href="#introduction" id="toc-entry-1">Introduction</a></li> +<li><a class="reference internal" href="#features-1" id="toc-entry-2">Features (1)</a></li> +<li><a class="reference internal" href="#features-2" id="toc-entry-3">Features (2)</a></li> +<li><a class="reference internal" href="#checklist" id="toc-entry-4">Checklist</a></li> </ul> </div> <p class="handout">This is a test. This is only a test. If this were a real slide diff --git a/docutils/test/functional/expected/standalone_rst_xetex.tex b/docutils/test/functional/expected/standalone_rst_xetex.tex index b18f16849..d2a448566 100644 --- a/docutils/test/functional/expected/standalone_rst_xetex.tex +++ b/docutils/test/functional/expected/standalone_rst_xetex.tex @@ -349,17 +349,17 @@ A paragraph. Paragraphs contain text and may contain inline markup: \emph{emphasis}, \textbf{strong emphasis}, \texttt{inline literals}, standalone hyperlinks -(\url{http://www.python.org}), external hyperlinks (\href{http://www.python.org/}{Python}\DUfootnotemark{id30}{id29}{5}), internal +(\url{http://www.python.org}), external hyperlinks (\href{http://www.python.org/}{Python}\DUfootnotemark{footnote-reference-10}{footnote-6}{5}), internal cross-references (\hyperref[example]{example}), external hyperlinks with embedded URIs (\href{http://www.python.org}{Python web site}), \href{http://www.python.org/}{anonymous hyperlink -references}\DUfootnotemark{id40}{id29}{5} (\href{http://docutils.sourceforge.net/}{a second reference}\DUfootnotemark{id42}{id41}{9}), footnote references (manually -numbered\DUfootnotemark{id1}{id8}{1}, anonymous auto-numbered\DUfootnotemark{id2}{id12}{3}, labeled auto-numbered\DUfootnotemark{id3}{label}{2}, or symbolic\DUfootnotemark{id4}{id13}{*}), citation references (\hyperlink{cit2002}{[CIT2002]}), +references}\DUfootnotemark{footnote-reference-17}{footnote-6}{5} (\href{http://docutils.sourceforge.net/}{a second reference}\DUfootnotemark{footnote-reference-18}{footnote-10}{9}), footnote references (manually +numbered\DUfootnotemark{footnote-reference-1}{footnote-1}{1}, anonymous auto-numbered\DUfootnotemark{footnote-reference-2}{footnote-2}{3}, labeled auto-numbered\DUfootnotemark{footnote-reference-3}{label}{2}, or symbolic\DUfootnotemark{footnote-reference-4}{footnote-3}{*}), citation references (\hyperlink{cit2002}{[CIT2002]}), substitution references (\includegraphics{../../../docs/user/rst/images/biohazard.png} \& a \emph{trimmed heart} \texttt{(U+2665):}♥), and % \phantomsection\label{inline-hyperlink-targets}inline hyperlink targets (see \hyperref[targets]{Targets} below for a reference back to here). Character-level inline markup is also possible (although exceedingly ugly!) in \emph{re}\texttt{Structured}\emph{Text}. Problems are indicated by % -\raisebox{1em}{\hypertarget{id28}{}}\hyperlink{id27}{\textbf{\color{red}|problematic|}} text +\raisebox{1em}{\hypertarget{problematic-1}{}}\hyperlink{system-message-1}{\textbf{\color{red}|problematic|}} text (generated by processing errors; this one is intentional). Here is a reference to the \hyperref[doctitle]{doctitle} and the \hyperref[subtitle]{subtitle}. @@ -724,21 +724,21 @@ Python-specific usage examples; begun with ">>>" \label{footnotes}% } % -\DUfootnotetext{id8}{id1}{1}{% +\DUfootnotetext{footnote-1}{footnote-reference-1}{1}{% A footnote contains body elements, consistently indented by at least 3 spaces. This is the footnote’s second paragraph. } % -\DUfootnotetext{label}{id3}{2}{\phantomsection\label{label}% -Footnotes may be numbered, either manually (as in\DUfootnotemark{id9}{id8}{1}) or +\DUfootnotetext{label}{footnote-reference-3}{2}{\phantomsection\label{label}% +Footnotes may be numbered, either manually (as in\DUfootnotemark{footnote-reference-5}{footnote-1}{1}) 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 (\DUfootnotemark{id10}{label}{2}) and as a \hyperref[label]{hyperlink reference}. +footnote reference (\DUfootnotemark{footnote-reference-6}{label}{2}) and as a \hyperref[label]{hyperlink reference}. } % -\DUfootnotetext{id12}{id2}{3}{% +\DUfootnotetext{footnote-2}{footnote-reference-2}{3}{% This footnote is numbered automatically and anonymously using a label of “\#” only. @@ -747,19 +747,19 @@ This is the second paragraph. And this is the third paragraph. } % -\DUfootnotetext{id13}{id4}{*}{% +\DUfootnotetext{footnote-3}{footnote-reference-4}{*}{% Footnotes may also use symbols, specified with a “*” label. -Here’s a reference to the next footnote:\DUfootnotemark{id14}{id15}{†}. +Here’s a reference to the next footnote:\DUfootnotemark{footnote-reference-7}{footnote-4}{†}. } % -\DUfootnotetext{id15}{id14}{†}{% +\DUfootnotetext{footnote-4}{footnote-reference-7}{†}{% This footnote shows the next symbol in the sequence. } % -\DUfootnotetext{id16}{id16}{4}{% +\DUfootnotetext{footnote-5}{footnote-5}{4}{% Here’s an unreferenced footnote, with a reference to a nonexistent footnote:% -\raisebox{1em}{\hypertarget{id17}{}}\hyperlink{id47}{\textbf{\color{red}{[}5{]}\_}}. +\raisebox{1em}{\hypertarget{footnote-reference-8}{}}\hyperlink{system-message-2}{\textbf{\color{red}{[}5{]}\_}}. } @@ -772,7 +772,7 @@ rendered separately and differently from footnotes. \end{figure} Here’s a reference to the above, \hyperlink{cit2002}{[CIT2002]}, and a % -\raisebox{1em}{\hypertarget{id19}{}}\hyperlink{id48}{\textbf{\color{red}{[}nonexistent{]}\_}} +\raisebox{1em}{\hypertarget{citation-reference-3}{}}\hyperlink{system-message-3}{\textbf{\color{red}{[}nonexistent{]}\_}} citation. @@ -790,13 +790,13 @@ Section headers are implicit targets, referred to by name. See \hyperref[targets]{Targets}, which is a subsection of \hyperref[body-elements]{Body Elements}. Explicit external targets are interpolated into references such as -“\href{http://www.python.org/}{Python}\DUfootnotemark{id31}{id29}{5}”. +“\href{http://www.python.org/}{Python}\DUfootnotemark{footnote-reference-11}{footnote-6}{5}”. Targets may be indirect and anonymous. Thus \hyperref[targets]{this phrase} may also refer to the \hyperref[targets]{Targets} section. Here’s a % -\raisebox{1em}{\hypertarget{id50}{}}\hyperlink{id49}{\textbf{\color{red}`hyperlink reference without a target`\_}}, which generates an +\raisebox{1em}{\hypertarget{problematic-2}{}}\hyperlink{system-message-4}{\textbf{\color{red}`hyperlink reference without a target`\_}}, which generates an error. @@ -810,13 +810,13 @@ explicit targets will generate “warning” (level-2) system messages. \subsubsection{2.13.2 Duplicate Target Names% - \label{id21}% + \label{duplicate-target-names-1}% } Since there are two “Duplicate Target Names” section headers, we cannot uniquely refer to either of them by name. If we try to (like this: % -\raisebox{1em}{\hypertarget{id52}{}}\hyperlink{id51}{\textbf{\color{red}`Duplicate Target Names`\_}}), an error is generated. +\raisebox{1em}{\hypertarget{problematic-3}{}}\hyperlink{system-message-5}{\textbf{\color{red}`Duplicate Target Names`\_}}), an error is generated. \subsection{2.14 Directives% @@ -1243,27 +1243,27 @@ allowed (e.g. inside a directive). \label{target-footnotes}% } % -\DUfootnotetext{id29}{id30}{5}{% +\DUfootnotetext{footnote-6}{footnote-reference-10}{5}{% \url{http://www.python.org/} } % -\DUfootnotetext{id33}{id34}{6}{% +\DUfootnotetext{footnote-7}{footnote-reference-13}{6}{% \url{http://pygments.org/} } % -\DUfootnotetext{id35}{id36}{7}{% +\DUfootnotetext{footnote-8}{footnote-reference-14}{7}{% \url{ftp://ftp.ams.org/ams/doc/amsmath/short-math-guide.pdf} } % -\DUfootnotetext{id38}{id39}{8}{% +\DUfootnotetext{footnote-9}{footnote-reference-16}{8}{% \url{http://ctan.org/pkg/polyglossia} } % -\DUfootnotetext{id41}{id42}{9}{% +\DUfootnotetext{footnote-10}{footnote-reference-18}{9}{% \url{http://docutils.sourceforge.net/} } % -\DUfootnotetext{id43}{id44}{10}{% +\DUfootnotetext{footnote-11}{footnote-reference-19}{10}{% \url{A:DOS\\path\\} } @@ -1272,7 +1272,7 @@ allowed (e.g. inside a directive). \label{replacement-text}% } -I recommend you try \href{http://www.python.org/}{Python, \emph{the} best language around}\DUfootnotemark{id32}{id29}{5}. +I recommend you try \href{http://www.python.org/}{Python, \emph{the} best language around}\DUfootnotemark{footnote-reference-12}{footnote-6}{5}. \subsubsection{2.14.7 Compound Paragraph% @@ -1424,7 +1424,7 @@ This~is~a~parsed~literal~block.\\ Inline~markup~is~supported,~e.g.~\emph{emphasis},~\textbf{strong},~\texttt{literal\\ text},~\textsubscript{sub-}~and~\textsuperscript{super}scripts,\\ inline~formulas:~$A = 2 \pi r^2$,\\ -footnotes\DUfootnotemark{id22}{id8}{1},~% +footnotes\DUfootnotemark{footnote-reference-9}{footnote-1}{1},~% \phantomsection\label{hyperlink-targets}hyperlink~targets,~and~\href{http://www.python.org/}{references}. \end{quote} @@ -1434,7 +1434,7 @@ footnotes\DUfootnotemark{id22}{id8}{1},~% } Blocks of source code can be set with the \DUroletitlereference{code} directive. If the code -language is specified, the content is parsed and tagged by the \href{http://pygments.org/}{Pygments}\DUfootnotemark{id34}{id33}{6} +language is specified, the content is parsed and tagged by the \href{http://pygments.org/}{Pygments}\DUfootnotemark{footnote-reference-13}{footnote-7}{6} syntax highlighter and can be formatted with a style sheet. (Code parsing is turned off using the \texttt{syntax-highlight} config setting in the test conversions in order to get identical results with/without installed @@ -1902,7 +1902,7 @@ Modulation Transfer Function: \right). \end{equation*} Math split over two lines: If a double backslash is detected outside a -\texttt{\textbackslash{}begin\{...\} \textbackslash{}end\{...\}} pair, the math code is wrapped in an \href{ftp://ftp.ams.org/ams/doc/amsmath/short-math-guide.pdf}{AMSmath}\DUfootnotemark{id36}{id35}{7} +\texttt{\textbackslash{}begin\{...\} \textbackslash{}end\{...\}} pair, the math code is wrapped in an \href{ftp://ftp.ams.org/ams/doc/amsmath/short-math-guide.pdf}{AMSmath}\DUfootnotemark{footnote-reference-14}{footnote-8}{7} \texttt{align} environment: % \begin{align*} @@ -1917,7 +1917,7 @@ Cases (“manually”, with \texttt{matrix} environment): 1 & x>0 \end{matrix}\right. \end{equation*} -Cases with the \href{ftp://ftp.ams.org/ams/doc/amsmath/short-math-guide.pdf}{AMSmath}\DUfootnotemark{id37}{id35}{7} \texttt{cases} environment (not (yet) supported by +Cases with the \href{ftp://ftp.ams.org/ams/doc/amsmath/short-math-guide.pdf}{AMSmath}\DUfootnotemark{footnote-reference-15}{footnote-8}{7} \texttt{cases} environment (not (yet) supported by HTML writers with \texttt{--math-output=MathML}): % \begin{equation*} @@ -2183,7 +2183,7 @@ third paragraph \\ \subsection{3.4 Option lists% - \label{id23}% + \label{option-lists-1}% } The LaTeX-2e description environment is used for definition lists. @@ -2764,7 +2764,7 @@ Handling by the LaTeX writer: \url{http://www.w3.org/XML/Schema\#dev} \item[] \href{http://www.w3.org/XML/Schema\%dev}{URL with \%} \url{http://example.org/Schema\%dev} -\item[] \href{A:DOS\\path\\}{file with DOS path}\DUfootnotemark{id44}{id43}{10} \url{A:DOS\\path\\}\DUfootnotemark{id45}{id43}{10} +\item[] \href{A:DOS\\path\\}{file with DOS path}\DUfootnotemark{footnote-reference-19}{footnote-11}{10} \url{A:DOS\\path\\}\DUfootnotemark{footnote-reference-20}{footnote-11}{10} \end{DUlineblock} \DUadmonition[note]{ @@ -2775,7 +2775,7 @@ These URLs are typeset inside a LaTeX command without error. \begin{DUlineblock}{0em} \item[] \url{http://www.w3.org/XML/Schema\#dev} \item[] \url{http://example.org/Schema\%dev} -\item[] \url{A:DOS\\path\\}\DUfootnotemark{id46}{id43}{10} +\item[] \url{A:DOS\\path\\}\DUfootnotemark{footnote-reference-21}{footnote-11}{10} \end{DUlineblock} } \end{itemize} @@ -2868,7 +2868,7 @@ Latviešu, Lietuvių, Македонски, Монгол, Nāhuatl, Português, Русский, Slovenščina, Српски, Türkçe, Українська, Tiếng Việt, Volapük, Võro, ייִדיש , Žemaitėška. Currently, there is extended support for 28 languages in the -\href{http://ctan.org/pkg/polyglossia}{polyglossia}\DUfootnotemark{id39}{id38}{8} package. +\href{http://ctan.org/pkg/polyglossia}{polyglossia}\DUfootnotemark{footnote-reference-16}{footnote-9}{8} package. % System Messages: @@ -2890,51 +2890,51 @@ section, “Docutils System Messages”: \DUadmonition[system-message]{ \DUtitle[system-message]{system-message} -\raisebox{1em}{\hypertarget{id27}{}} +\raisebox{1em}{\hypertarget{system-message-1}{}} {\color{red}ERROR/3} in \texttt{functional/input/data/standard.txt}, line~104 -\hyperlink{id28}{ +\hyperlink{problematic-1}{ Undefined substitution referenced: \textquotedbl{}problematic\textquotedbl{}. }} \DUadmonition[system-message]{ \DUtitle[system-message]{system-message} -\raisebox{1em}{\hypertarget{id47}{}} +\raisebox{1em}{\hypertarget{system-message-2}{}} {\color{red}ERROR/3} in \texttt{functional/input/data/standard.txt}, line~392 -\hyperlink{id17}{ +\hyperlink{footnote-reference-8}{ Unknown target name: \textquotedbl{}5\textquotedbl{}. }} \DUadmonition[system-message]{ \DUtitle[system-message]{system-message} -\raisebox{1em}{\hypertarget{id48}{}} +\raisebox{1em}{\hypertarget{system-message-3}{}} {\color{red}ERROR/3} in \texttt{functional/input/data/standard.txt}, line~401 -\hyperlink{id19}{ +\hyperlink{citation-reference-3}{ Unknown target name: \textquotedbl{}nonexistent\textquotedbl{}. }} \DUadmonition[system-message]{ \DUtitle[system-message]{system-message} -\raisebox{1em}{\hypertarget{id49}{}} +\raisebox{1em}{\hypertarget{system-message-4}{}} {\color{red}ERROR/3} in \texttt{functional/input/data/standard.txt}, line~428 -\hyperlink{id50}{ +\hyperlink{problematic-2}{ Unknown target name: \textquotedbl{}hyperlink reference without a target\textquotedbl{}. }} \DUadmonition[system-message]{ \DUtitle[system-message]{system-message} -\raisebox{1em}{\hypertarget{id51}{}} +\raisebox{1em}{\hypertarget{system-message-5}{}} {\color{red}ERROR/3} in \texttt{functional/input/data/standard.txt}, line~441 -\hyperlink{id52}{ +\hyperlink{problematic-3}{ Duplicate target name, cannot be used as a unique reference: \textquotedbl{}duplicate target names\textquotedbl{}. }} diff --git a/docutils/test/functional/expected/xetex-cyrillic.tex b/docutils/test/functional/expected/xetex-cyrillic.tex index 8268a71d9..0741cd930 100644 --- a/docutils/test/functional/expected/xetex-cyrillic.tex +++ b/docutils/test/functional/expected/xetex-cyrillic.tex @@ -39,7 +39,7 @@ \section{Заголовок% - \label{id1}% + \label{section-1}% } первый пример: «Здравствуй, мир!» diff --git a/docutils/test/functional/tests/_default.py b/docutils/test/functional/tests/_default.py index 288b109df..8214f37d6 100644 --- a/docutils/test/functional/tests/_default.py +++ b/docutils/test/functional/tests/_default.py @@ -5,3 +5,4 @@ settings_overrides['halt_level'] = 5 settings_overrides['warning_stream'] = '' settings_overrides['input_encoding'] = 'utf-8' settings_overrides['embed_stylesheet'] = False +settings_overrides['auto_id_prefix'] = '%' |