summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorwiemann <wiemann@929543f6-e4f2-0310-98a6-ba3bd3dd1d04>2005-10-11 21:22:01 +0000
committerwiemann <wiemann@929543f6-e4f2-0310-98a6-ba3bd3dd1d04>2005-10-11 21:22:01 +0000
commit6e03ef782ab76d9e11cd003eb4759a0599cf8897 (patch)
tree34c5334061ac6a3e8350cfce1603b1cb5bfb066b
parent56809ba46e8c9b350a26e0925e263c2e1752ebec (diff)
downloaddocutils-6e03ef782ab76d9e11cd003eb4759a0599cf8897.tar.gz
added a functional test for target footnotes for anonymous targets
git-svn-id: http://svn.code.sf.net/p/docutils/code/trunk@3938 929543f6-e4f2-0310-98a6-ba3bd3dd1d04
-rw-r--r--docutils/test/functional/expected/standalone_rst_html4css1.html266
-rw-r--r--docutils/test/functional/expected/standalone_rst_latex.tex56
-rw-r--r--docutils/test/functional/expected/standalone_rst_pseudoxml.txt292
-rw-r--r--docutils/test/functional/input/data/standard.txt22
4 files changed, 334 insertions, 302 deletions
diff --git a/docutils/test/functional/expected/standalone_rst_html4css1.html b/docutils/test/functional/expected/standalone_rst_html4css1.html
index 8a8def5e9..e14d5a72d 100644
--- a/docutils/test/functional/expected/standalone_rst_html4css1.html
+++ b/docutils/test/functional/expected/standalone_rst_html4css1.html
@@ -88,68 +88,68 @@ They are transformed from section titles after parsing. -->
<div class="contents topic">
<p class="topic-title first"><a id="table-of-contents" name="table-of-contents">Table of Contents</a></p>
<ul class="auto-toc simple">
-<li><a class="reference" href="#structural-elements" id="id27" name="id27">1&nbsp;&nbsp;&nbsp;Structural Elements</a><ul class="auto-toc">
-<li><a class="reference" href="#section-title" id="id28" name="id28">1.1&nbsp;&nbsp;&nbsp;Section Title</a></li>
-<li><a class="reference" href="#empty-section" id="id29" name="id29">1.2&nbsp;&nbsp;&nbsp;Empty Section</a></li>
-<li><a class="reference" href="#transitions" id="id30" name="id30">1.3&nbsp;&nbsp;&nbsp;Transitions</a></li>
+<li><a class="reference" href="#structural-elements" id="id32" name="id32">1&nbsp;&nbsp;&nbsp;Structural Elements</a><ul class="auto-toc">
+<li><a class="reference" href="#section-title" id="id33" name="id33">1.1&nbsp;&nbsp;&nbsp;Section Title</a></li>
+<li><a class="reference" href="#empty-section" id="id34" name="id34">1.2&nbsp;&nbsp;&nbsp;Empty Section</a></li>
+<li><a class="reference" href="#transitions" id="id35" name="id35">1.3&nbsp;&nbsp;&nbsp;Transitions</a></li>
</ul>
</li>
-<li><a class="reference" href="#body-elements" id="id31" name="id31">2&nbsp;&nbsp;&nbsp;Body Elements</a><ul class="auto-toc">
-<li><a class="reference" href="#paragraphs" id="id32" name="id32">2.1&nbsp;&nbsp;&nbsp;Paragraphs</a><ul class="auto-toc">
-<li><a class="reference" href="#inline-markup" id="id33" name="id33">2.1.1&nbsp;&nbsp;&nbsp;Inline Markup</a></li>
+<li><a class="reference" href="#body-elements" id="id36" name="id36">2&nbsp;&nbsp;&nbsp;Body Elements</a><ul class="auto-toc">
+<li><a class="reference" href="#paragraphs" id="id37" name="id37">2.1&nbsp;&nbsp;&nbsp;Paragraphs</a><ul class="auto-toc">
+<li><a class="reference" href="#inline-markup" id="id38" name="id38">2.1.1&nbsp;&nbsp;&nbsp;Inline Markup</a></li>
</ul>
</li>
-<li><a class="reference" href="#bullet-lists" id="id34" name="id34">2.2&nbsp;&nbsp;&nbsp;Bullet Lists</a></li>
-<li><a class="reference" href="#enumerated-lists" id="id35" name="id35">2.3&nbsp;&nbsp;&nbsp;Enumerated Lists</a></li>
-<li><a class="reference" href="#definition-lists" id="id36" name="id36">2.4&nbsp;&nbsp;&nbsp;Definition Lists</a></li>
-<li><a class="reference" href="#field-lists" id="id37" name="id37">2.5&nbsp;&nbsp;&nbsp;Field Lists</a></li>
-<li><a class="reference" href="#option-lists" id="id38" name="id38">2.6&nbsp;&nbsp;&nbsp;Option Lists</a></li>
-<li><a class="reference" href="#literal-blocks" id="id39" name="id39">2.7&nbsp;&nbsp;&nbsp;Literal Blocks</a></li>
-<li><a class="reference" href="#line-blocks" id="id40" name="id40">2.8&nbsp;&nbsp;&nbsp;Line Blocks</a></li>
-<li><a class="reference" href="#block-quotes" id="id41" name="id41">2.9&nbsp;&nbsp;&nbsp;Block Quotes</a></li>
-<li><a class="reference" href="#doctest-blocks" id="id42" name="id42">2.10&nbsp;&nbsp;&nbsp;Doctest Blocks</a></li>
-<li><a class="reference" href="#footnotes" id="id43" name="id43">2.11&nbsp;&nbsp;&nbsp;Footnotes</a></li>
-<li><a class="reference" href="#citations" id="id44" name="id44">2.12&nbsp;&nbsp;&nbsp;Citations</a></li>
-<li><a class="reference" href="#targets" id="id45" name="id45">2.13&nbsp;&nbsp;&nbsp;Targets</a><ul class="auto-toc">
-<li><a class="reference" href="#duplicate-target-names" id="id46" name="id46">2.13.1&nbsp;&nbsp;&nbsp;Duplicate Target Names</a></li>
-<li><a class="reference" href="#id18" id="id47" name="id47">2.13.2&nbsp;&nbsp;&nbsp;Duplicate Target Names</a></li>
+<li><a class="reference" href="#bullet-lists" id="id39" name="id39">2.2&nbsp;&nbsp;&nbsp;Bullet Lists</a></li>
+<li><a class="reference" href="#enumerated-lists" id="id40" name="id40">2.3&nbsp;&nbsp;&nbsp;Enumerated Lists</a></li>
+<li><a class="reference" href="#definition-lists" id="id41" name="id41">2.4&nbsp;&nbsp;&nbsp;Definition Lists</a></li>
+<li><a class="reference" href="#field-lists" id="id42" name="id42">2.5&nbsp;&nbsp;&nbsp;Field Lists</a></li>
+<li><a class="reference" href="#option-lists" id="id43" name="id43">2.6&nbsp;&nbsp;&nbsp;Option Lists</a></li>
+<li><a class="reference" href="#literal-blocks" id="id44" name="id44">2.7&nbsp;&nbsp;&nbsp;Literal Blocks</a></li>
+<li><a class="reference" href="#line-blocks" id="id45" name="id45">2.8&nbsp;&nbsp;&nbsp;Line Blocks</a></li>
+<li><a class="reference" href="#block-quotes" id="id46" name="id46">2.9&nbsp;&nbsp;&nbsp;Block Quotes</a></li>
+<li><a class="reference" href="#doctest-blocks" id="id47" name="id47">2.10&nbsp;&nbsp;&nbsp;Doctest Blocks</a></li>
+<li><a class="reference" href="#footnotes" id="id48" name="id48">2.11&nbsp;&nbsp;&nbsp;Footnotes</a></li>
+<li><a class="reference" href="#citations" id="id49" name="id49">2.12&nbsp;&nbsp;&nbsp;Citations</a></li>
+<li><a class="reference" href="#targets" id="id50" name="id50">2.13&nbsp;&nbsp;&nbsp;Targets</a><ul class="auto-toc">
+<li><a class="reference" href="#duplicate-target-names" id="id51" name="id51">2.13.1&nbsp;&nbsp;&nbsp;Duplicate Target Names</a></li>
+<li><a class="reference" href="#id20" id="id52" name="id52">2.13.2&nbsp;&nbsp;&nbsp;Duplicate Target Names</a></li>
</ul>
</li>
-<li><a class="reference" href="#directives" id="id48" name="id48">2.14&nbsp;&nbsp;&nbsp;Directives</a><ul class="auto-toc">
-<li><a class="reference" href="#document-parts" id="id49" name="id49">2.14.1&nbsp;&nbsp;&nbsp;Document Parts</a></li>
-<li><a class="reference" href="#images" id="id50" name="id50">2.14.2&nbsp;&nbsp;&nbsp;Images</a></li>
-<li><a class="reference" href="#admonitions" id="id51" name="id51">2.14.3&nbsp;&nbsp;&nbsp;Admonitions</a></li>
-<li><a class="reference" href="#topics-sidebars-and-rubrics" id="id52" name="id52">2.14.4&nbsp;&nbsp;&nbsp;Topics, Sidebars, and Rubrics</a></li>
-<li><a class="reference" href="#target-footnotes" id="id53" name="id53">2.14.5&nbsp;&nbsp;&nbsp;Target Footnotes</a></li>
-<li><a class="reference" href="#replacement-text" id="id54" name="id54">2.14.6&nbsp;&nbsp;&nbsp;Replacement Text</a></li>
-<li><a class="reference" href="#compound-paragraph" id="id55" name="id55">2.14.7&nbsp;&nbsp;&nbsp;Compound Paragraph</a></li>
-<li><a class="reference" href="#parsed-literal-blocks" id="id56" name="id56">2.14.8&nbsp;&nbsp;&nbsp;Parsed Literal Blocks</a></li>
+<li><a class="reference" href="#directives" id="id53" name="id53">2.14&nbsp;&nbsp;&nbsp;Directives</a><ul class="auto-toc">
+<li><a class="reference" href="#document-parts" id="id54" name="id54">2.14.1&nbsp;&nbsp;&nbsp;Document Parts</a></li>
+<li><a class="reference" href="#images" id="id55" name="id55">2.14.2&nbsp;&nbsp;&nbsp;Images</a></li>
+<li><a class="reference" href="#admonitions" id="id56" name="id56">2.14.3&nbsp;&nbsp;&nbsp;Admonitions</a></li>
+<li><a class="reference" href="#topics-sidebars-and-rubrics" id="id57" name="id57">2.14.4&nbsp;&nbsp;&nbsp;Topics, Sidebars, and Rubrics</a></li>
+<li><a class="reference" href="#target-footnotes" id="id58" name="id58">2.14.5&nbsp;&nbsp;&nbsp;Target Footnotes</a></li>
+<li><a class="reference" href="#replacement-text" id="id59" name="id59">2.14.6&nbsp;&nbsp;&nbsp;Replacement Text</a></li>
+<li><a class="reference" href="#compound-paragraph" id="id60" name="id60">2.14.7&nbsp;&nbsp;&nbsp;Compound Paragraph</a></li>
+<li><a class="reference" href="#parsed-literal-blocks" id="id61" name="id61">2.14.8&nbsp;&nbsp;&nbsp;Parsed Literal Blocks</a></li>
</ul>
</li>
-<li><a class="reference" href="#substitution-definitions" id="id57" name="id57">2.15&nbsp;&nbsp;&nbsp;Substitution Definitions</a></li>
-<li><a class="reference" href="#comments" id="id58" name="id58">2.16&nbsp;&nbsp;&nbsp;Comments</a></li>
-<li><a class="reference" href="#raw-text" id="id59" name="id59">2.17&nbsp;&nbsp;&nbsp;Raw text</a></li>
-<li><a class="reference" href="#colspanning-tables" id="id60" name="id60">2.18&nbsp;&nbsp;&nbsp;Colspanning tables</a></li>
-<li><a class="reference" href="#rowspanning-tables" id="id61" name="id61">2.19&nbsp;&nbsp;&nbsp;Rowspanning tables</a></li>
-<li><a class="reference" href="#complex-tables" id="id62" name="id62">2.20&nbsp;&nbsp;&nbsp;Complex tables</a></li>
-<li><a class="reference" href="#list-tables" id="id63" name="id63">2.21&nbsp;&nbsp;&nbsp;List Tables</a></li>
+<li><a class="reference" href="#substitution-definitions" id="id62" name="id62">2.15&nbsp;&nbsp;&nbsp;Substitution Definitions</a></li>
+<li><a class="reference" href="#comments" id="id63" name="id63">2.16&nbsp;&nbsp;&nbsp;Comments</a></li>
+<li><a class="reference" href="#raw-text" id="id64" name="id64">2.17&nbsp;&nbsp;&nbsp;Raw text</a></li>
+<li><a class="reference" href="#colspanning-tables" id="id65" name="id65">2.18&nbsp;&nbsp;&nbsp;Colspanning tables</a></li>
+<li><a class="reference" href="#rowspanning-tables" id="id66" name="id66">2.19&nbsp;&nbsp;&nbsp;Rowspanning tables</a></li>
+<li><a class="reference" href="#complex-tables" id="id67" name="id67">2.20&nbsp;&nbsp;&nbsp;Complex tables</a></li>
+<li><a class="reference" href="#list-tables" id="id68" name="id68">2.21&nbsp;&nbsp;&nbsp;List Tables</a></li>
</ul>
</li>
-<li><a class="reference" href="#error-handling" id="id64" name="id64">3&nbsp;&nbsp;&nbsp;Error Handling</a></li>
+<li><a class="reference" href="#error-handling" id="id69" name="id69">3&nbsp;&nbsp;&nbsp;Error Handling</a></li>
</ul>
</div>
<div class="section">
-<h1><a class="toc-backref" href="#id27" id="structural-elements" name="structural-elements">1&nbsp;&nbsp;&nbsp;Structural Elements</a></h1>
+<h1><a class="toc-backref" href="#id32" id="structural-elements" name="structural-elements">1&nbsp;&nbsp;&nbsp;Structural Elements</a></h1>
<div class="section">
-<h2 class="with-subtitle"><a class="toc-backref" href="#id28" id="section-title" name="section-title">1.1&nbsp;&nbsp;&nbsp;Section Title</a></h2>
+<h2 class="with-subtitle"><a class="toc-backref" href="#id33" id="section-title" name="section-title">1.1&nbsp;&nbsp;&nbsp;Section Title</a></h2>
<h2 class="section-subtitle" id="section-subtitle"><span class="section-subtitle">Section Subtitle</span></h2>
<p>That's it, the text just above this line.</p>
</div>
<div class="section">
-<h2><a class="toc-backref" href="#id29" id="empty-section" name="empty-section">1.2&nbsp;&nbsp;&nbsp;Empty Section</a></h2>
+<h2><a class="toc-backref" href="#id34" id="empty-section" name="empty-section">1.2&nbsp;&nbsp;&nbsp;Empty Section</a></h2>
</div>
<div class="section">
-<h2><a class="toc-backref" href="#id30" id="transitions" name="transitions">1.3&nbsp;&nbsp;&nbsp;Transitions</a></h2>
+<h2><a class="toc-backref" href="#id35" id="transitions" name="transitions">1.3&nbsp;&nbsp;&nbsp;Transitions</a></h2>
<p>Here's a transition:</p>
<hr class="docutils" />
<p>It divides the section. Transitions may also occur between sections:</p>
@@ -157,25 +157,25 @@ They are transformed from section titles after parsing. -->
</div>
<hr class="docutils" />
<div class="section">
-<h1><a class="toc-backref" href="#id31" id="body-elements" name="body-elements">2&nbsp;&nbsp;&nbsp;Body Elements</a></h1>
+<h1><a class="toc-backref" href="#id36" id="body-elements" name="body-elements">2&nbsp;&nbsp;&nbsp;Body Elements</a></h1>
<div class="section">
-<h2><a class="toc-backref" href="#id32" id="paragraphs" name="paragraphs">2.1&nbsp;&nbsp;&nbsp;Paragraphs</a></h2>
+<h2><a class="toc-backref" href="#id37" id="paragraphs" name="paragraphs">2.1&nbsp;&nbsp;&nbsp;Paragraphs</a></h2>
<p>A paragraph.</p>
<div class="section">
-<h3><a class="toc-backref" href="#id33" id="inline-markup" name="inline-markup">2.1.1&nbsp;&nbsp;&nbsp;Inline Markup</a></h3>
+<h3><a class="toc-backref" href="#id38" id="inline-markup" name="inline-markup">2.1.1&nbsp;&nbsp;&nbsp;Inline Markup</a></h3>
<p>Paragraphs contain text and may contain inline markup: <em>emphasis</em>,
<strong>strong emphasis</strong>, <tt class="docutils literal"><span class="pre">inline</span> <span class="pre">literals</span></tt>, standalone hyperlinks
-(<a class="reference" href="http://www.python.org">http://www.python.org</a>), external hyperlinks (<a class="reference" href="http://www.python.org/">Python</a> <a class="footnote-reference" href="#id23" id="id24" name="id24">[5]</a>), internal
+(<a class="reference" href="http://www.python.org">http://www.python.org</a>), external hyperlinks (<a class="reference" href="http://www.python.org/">Python</a> <a class="footnote-reference" href="#id25" id="id26" name="id26">[5]</a>), internal
cross-references (<a class="reference" href="#example">example</a>), external hyperlinks with embedded URIs
-(<a class="reference" href="http://www.python.org">Python web site</a>), footnote references
-(manually numbered <a class="footnote-reference" href="#id6" id="id1" name="id1">[1]</a>, anonymous auto-numbered <a class="footnote-reference" href="#id9" id="id2" name="id2">[3]</a>, labeled
-auto-numbered <a class="footnote-reference" href="#label" id="id3" name="id3">[2]</a>, or symbolic <a class="footnote-reference" href="#id10" id="id4" name="id4">[*]</a>), citation references
-(<a class="citation-reference" href="#cit2002" id="id5" name="id5">[CIT2002]</a>), substitution references (<img alt="EXAMPLE" src="../../../docs/user/rst/images/biohazard.png" />), and <span class="target" id="inline-hyperlink-targets">inline
-hyperlink targets</span> (see <a class="reference" href="#id20">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"><span class="pre">Structured</span></tt><em>Text</em>. Problems are indicated by
-<a href="#id21" name="id22"><span class="problematic" id="id22">|problematic|</span></a> text (generated by processing errors; this one is
-intentional). Here is a reference to the <a class="reference" href="#doctitle">doctitle</a> and the <a class="reference" href="#subtitle">subtitle</a>.</p>
+(<a class="reference" href="http://www.python.org">Python web site</a>), <a class="reference" href="http://www.python.org/">anonymous hyperlink
+references</a> <a class="footnote-reference" href="#id25" id="id29" name="id29">[5]</a> (<a class="reference" href="http://docutils.sourceforge.net/">a second reference</a> <a class="footnote-reference" href="#id30" id="id31" name="id31">[6]</a>), footnote references (manually
+numbered <a class="footnote-reference" href="#id8" id="id1" name="id1">[1]</a>, anonymous auto-numbered <a class="footnote-reference" href="#id11" id="id2" name="id2">[3]</a>, labeled auto-numbered
+<a class="footnote-reference" href="#label" id="id3" name="id3">[2]</a>, or symbolic <a class="footnote-reference" href="#id12" id="id4" name="id4">[*]</a>), citation references (<a class="citation-reference" href="#cit2002" id="id5" name="id5">[CIT2002]</a>),
+substitution references (<img alt="EXAMPLE" src="../../../docs/user/rst/images/biohazard.png" />), and <span class="target" id="inline-hyperlink-targets">inline hyperlink targets</span>
+(see <a class="reference" href="#id22">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"><span class="pre">Structured</span></tt><em>Text</em>. Problems are indicated by <a href="#id23" name="id24"><span class="problematic" id="id24">|problematic|</span></a> text
+(generated by processing errors; this one is intentional). Here is a
+reference to the <a class="reference" href="#doctitle">doctitle</a> and the <a class="reference" href="#subtitle">subtitle</a>.</p>
<p>The default role for interpreted text is <cite>Title Reference</cite>. Here are
some explicit interpreted text roles: a PEP reference (<a class="reference" href="http://www.python.org/peps/pep-0287.html">PEP 287</a>); an
RFC reference (<a class="reference" href="http://www.faqs.org/rfcs/rfc2822.html">RFC 2822</a>); a <sub>subscript</sub>; a <sup>superscript</sup>;
@@ -193,7 +193,7 @@ live link to PEP 258 here.</p>
</div>
</div>
<div class="section">
-<h2><a class="toc-backref" href="#id34" id="bullet-lists" name="bullet-lists">2.2&nbsp;&nbsp;&nbsp;Bullet Lists</a></h2>
+<h2><a class="toc-backref" href="#id39" id="bullet-lists" name="bullet-lists">2.2&nbsp;&nbsp;&nbsp;Bullet Lists</a></h2>
<ul>
<li><p class="first">A bullet list</p>
<ul class="simple">
@@ -218,7 +218,7 @@ live link to PEP 258 here.</p>
</ul>
</div>
<div class="section">
-<h2><a class="toc-backref" href="#id35" id="enumerated-lists" name="enumerated-lists">2.3&nbsp;&nbsp;&nbsp;Enumerated Lists</a></h2>
+<h2><a class="toc-backref" href="#id40" id="enumerated-lists" name="enumerated-lists">2.3&nbsp;&nbsp;&nbsp;Enumerated Lists</a></h2>
<ol class="arabic">
<li><p class="first">Arabic numerals.</p>
<ol class="loweralpha simple">
@@ -251,7 +251,7 @@ live link to PEP 258 here.</p>
</ol>
</div>
<div class="section">
-<h2><a class="toc-backref" href="#id36" id="definition-lists" name="definition-lists">2.4&nbsp;&nbsp;&nbsp;Definition Lists</a></h2>
+<h2><a class="toc-backref" href="#id41" id="definition-lists" name="definition-lists">2.4&nbsp;&nbsp;&nbsp;Definition Lists</a></h2>
<dl class="docutils">
<dt>Term</dt>
<dd>Definition</dd>
@@ -266,7 +266,7 @@ live link to PEP 258 here.</p>
</dl>
</div>
<div class="section">
-<h2><a class="toc-backref" href="#id37" id="field-lists" name="field-lists">2.5&nbsp;&nbsp;&nbsp;Field Lists</a></h2>
+<h2><a class="toc-backref" href="#id42" id="field-lists" name="field-lists">2.5&nbsp;&nbsp;&nbsp;Field Lists</a></h2>
<table class="docutils field-list" frame="void" rules="none">
<col class="field-name" />
<col class="field-body" />
@@ -290,7 +290,7 @@ doesn't get stripped away.)</p>
</table>
</div>
<div class="section">
-<h2><a class="toc-backref" href="#id38" id="option-lists" name="option-lists">2.6&nbsp;&nbsp;&nbsp;Option Lists</a></h2>
+<h2><a class="toc-backref" href="#id43" id="option-lists" name="option-lists">2.6&nbsp;&nbsp;&nbsp;Option Lists</a></h2>
<p>For listing command-line options:</p>
<table class="docutils option-list" frame="void" rules="none">
<col class="option" />
@@ -336,7 +336,7 @@ regardless of where it starts.</p>
description.</p>
</div>
<div class="section">
-<h2><a class="toc-backref" href="#id39" id="literal-blocks" name="literal-blocks">2.7&nbsp;&nbsp;&nbsp;Literal Blocks</a></h2>
+<h2><a class="toc-backref" href="#id44" id="literal-blocks" name="literal-blocks">2.7&nbsp;&nbsp;&nbsp;Literal Blocks</a></h2>
<p>Literal blocks are indicated with a double-colon (&quot;::&quot;) at the end of
the preceding paragraph (over there <tt class="docutils literal"><span class="pre">--&gt;</span></tt>). They can be indented:</p>
<pre class="literal-block">
@@ -353,7 +353,7 @@ if literal_block:
</pre>
</div>
<div class="section">
-<h2><a class="toc-backref" href="#id40" id="line-blocks" name="line-blocks">2.8&nbsp;&nbsp;&nbsp;Line Blocks</a></h2>
+<h2><a class="toc-backref" href="#id45" id="line-blocks" name="line-blocks">2.8&nbsp;&nbsp;&nbsp;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>
@@ -412,7 +412,7 @@ the left edge of the text above it.</div>
</blockquote>
</div>
<div class="section">
-<h2><a class="toc-backref" href="#id41" id="block-quotes" name="block-quotes">2.9&nbsp;&nbsp;&nbsp;Block Quotes</a></h2>
+<h2><a class="toc-backref" href="#id46" id="block-quotes" name="block-quotes">2.9&nbsp;&nbsp;&nbsp;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
@@ -424,7 +424,7 @@ own it, and what it is too.</p>
</blockquote>
</div>
<div class="section">
-<h2><a class="toc-backref" href="#id42" id="doctest-blocks" name="doctest-blocks">2.10&nbsp;&nbsp;&nbsp;Doctest Blocks</a></h2>
+<h2><a class="toc-backref" href="#id47" id="doctest-blocks" name="doctest-blocks">2.10&nbsp;&nbsp;&nbsp;Doctest Blocks</a></h2>
<pre class="doctest-block">
&gt;&gt;&gt; print 'Python-specific usage examples; begun with &quot;&gt;&gt;&gt;&quot;'
Python-specific usage examples; begun with &quot;&gt;&gt;&gt;&quot;
@@ -433,11 +433,11 @@ Python-specific usage examples; begun with &quot;&gt;&gt;&gt;&quot;
</pre>
</div>
<div class="section">
-<h2><a class="toc-backref" href="#id43" id="footnotes" name="footnotes">2.11&nbsp;&nbsp;&nbsp;Footnotes</a></h2>
-<table class="docutils footnote" frame="void" id="id6" rules="none">
+<h2><a class="toc-backref" href="#id48" id="footnotes" name="footnotes">2.11&nbsp;&nbsp;&nbsp;Footnotes</a></h2>
+<table class="docutils footnote" frame="void" id="id8" rules="none">
<colgroup><col class="label" /><col /></colgroup>
<tbody valign="top">
-<tr><td class="label"><a name="id6">[1]</a></td><td><em>(<a class="fn-backref" href="#id1">1</a>, <a class="fn-backref" href="#id7">2</a>, <a class="fn-backref" href="#id19">3</a>)</em> <p>A footnote contains body elements, consistently indented by at
+<tr><td class="label"><a name="id8">[1]</a></td><td><em>(<a class="fn-backref" href="#id1">1</a>, <a class="fn-backref" href="#id9">2</a>, <a class="fn-backref" href="#id21">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>
@@ -446,107 +446,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"><a name="label">[2]</a></td><td><em>(<a class="fn-backref" href="#id3">1</a>, <a class="fn-backref" href="#id8">2</a>)</em> Footnotes may be numbered, either manually (as in <a class="footnote-reference" href="#id6" id="id7" name="id7">[1]</a>) or
+<tr><td class="label"><a name="label">[2]</a></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" name="id9">[1]</a>) or
automatically using a &quot;#&quot;-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="id8" name="id8">[2]</a>) and as a hyperlink reference
+footnote reference (<a class="footnote-reference" href="#label" id="id10" name="id10">[2]</a>) and as a hyperlink reference
(<a class="reference" href="#label">label</a>).</td></tr>
</tbody>
</table>
-<table class="docutils footnote" frame="void" id="id9" rules="none">
+<table class="docutils footnote" frame="void" id="id11" rules="none">
<colgroup><col class="label" /><col /></colgroup>
<tbody valign="top">
-<tr><td class="label"><a class="fn-backref" href="#id2" name="id9">[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="#id2" name="id11">[3]</a></td><td><p class="first">This footnote is numbered automatically and anonymously using a
label of &quot;#&quot; 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="id10" rules="none">
+<table class="docutils footnote" frame="void" id="id12" rules="none">
<colgroup><col class="label" /><col /></colgroup>
<tbody valign="top">
-<tr><td class="label"><a class="fn-backref" href="#id4" name="id10">[*]</a></td><td>Footnotes may also use symbols, specified with a &quot;*&quot; label.
-Here's a reference to the next footnote: <a class="footnote-reference" href="#id12" id="id11" name="id11">[†]</a>.</td></tr>
+<tr><td class="label"><a class="fn-backref" href="#id4" name="id12">[*]</a></td><td>Footnotes may also use symbols, specified with a &quot;*&quot; label.
+Here's a reference to the next footnote: <a class="footnote-reference" href="#id14" id="id13" name="id13">[†]</a>.</td></tr>
</tbody>
</table>
-<table class="docutils footnote" frame="void" id="id12" rules="none">
+<table class="docutils footnote" frame="void" id="id14" rules="none">
<colgroup><col class="label" /><col /></colgroup>
<tbody valign="top">
-<tr><td class="label"><a class="fn-backref" href="#id11" name="id12">[†]</a></td><td>This footnote shows the next symbol in the sequence.</td></tr>
+<tr><td class="label"><a class="fn-backref" href="#id13" name="id14">[†]</a></td><td>This footnote shows the next symbol in the sequence.</td></tr>
</tbody>
</table>
-<table class="docutils footnote" frame="void" id="id13" rules="none">
+<table class="docutils footnote" frame="void" id="id15" rules="none">
<colgroup><col class="label" /><col /></colgroup>
<tbody valign="top">
-<tr><td class="label"><a name="id13">[4]</a></td><td>Here's an unreferenced footnote, with a reference to a
-nonexistent footnote: <a href="#id73" name="id74"><span class="problematic" id="id74"><span id="id14"></span>[5]_</span></a>.</td></tr>
+<tr><td class="label"><a name="id15">[4]</a></td><td>Here's an unreferenced footnote, with a reference to a
+nonexistent footnote: <a href="#id78" name="id79"><span class="problematic" id="id79"><span id="id16"></span>[5]_</span></a>.</td></tr>
</tbody>
</table>
</div>
<div class="section">
-<h2><a class="toc-backref" href="#id44" id="citations" name="citations">2.12&nbsp;&nbsp;&nbsp;Citations</a></h2>
+<h2><a class="toc-backref" href="#id49" id="citations" name="citations">2.12&nbsp;&nbsp;&nbsp;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"><a name="cit2002">[CIT2002]</a></td><td><em>(<a class="fn-backref" href="#id5">1</a>, <a class="fn-backref" href="#id15">2</a>)</em> Citations are text-labeled footnotes. They may be
+<tr><td class="label"><a name="cit2002">[CIT2002]</a></td><td><em>(<a class="fn-backref" href="#id5">1</a>, <a class="fn-backref" href="#id17">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="id15" name="id15">[CIT2002]</a>, and a <a href="#id75" name="id76"><span class="problematic" id="id76"><span id="id16"></span>[nonexistent]_</span></a>
+<p>Here's a reference to the above, <a class="citation-reference" href="#cit2002" id="id17" name="id17">[CIT2002]</a>, and a <a href="#id80" name="id81"><span class="problematic" id="id81"><span id="id18"></span>[nonexistent]_</span></a>
citation.</p>
</div>
<div class="section">
-<h2><a class="toc-backref" href="#id45" id="targets" name="targets"><span id="another-target"></span>2.13&nbsp;&nbsp;&nbsp;Targets</a></h2>
+<h2><a class="toc-backref" href="#id50" id="targets" name="targets"><span id="another-target"></span>2.13&nbsp;&nbsp;&nbsp;Targets</a></h2>
<p id="example">This paragraph is pointed to by the explicit &quot;example&quot; target. A
reference can be found under <a class="reference" href="#inline-markup">Inline Markup</a>, above. <a class="reference" 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" href="#id20">Targets</a>, which is a subsection of <a class="reference" href="#body-elements">Body Elements</a>.</p>
+<a class="reference" href="#id22">Targets</a>, which is a subsection of <a class="reference" href="#body-elements">Body Elements</a>.</p>
<p>Explicit external targets are interpolated into references such as
-&quot;<a class="reference" href="http://www.python.org/">Python</a> <a class="footnote-reference" href="#id23" id="id25" name="id25">[5]</a>&quot;.</p>
-<p>Targets may be indirect and anonymous. Thus <a class="reference" href="#id20">this phrase</a> may also
-refer to the <a class="reference" href="#id20">Targets</a> section.</p>
-<p>Here's a <a href="#id77" name="id78"><span class="problematic" id="id78">`hyperlink reference without a target`_</span></a>, which generates an
+&quot;<a class="reference" href="http://www.python.org/">Python</a> <a class="footnote-reference" href="#id25" id="id27" name="id27">[5]</a>&quot;.</p>
+<p>Targets may be indirect and anonymous. Thus <a class="reference" href="#id22">this phrase</a> may also
+refer to the <a class="reference" href="#id22">Targets</a> section.</p>
+<p>Here's a <a href="#id82" name="id83"><span class="problematic" id="id83">`hyperlink reference without a target`_</span></a>, which generates an
error.</p>
<div class="section">
-<h3><a class="toc-backref" href="#id46" id="duplicate-target-names" name="duplicate-target-names">2.13.1&nbsp;&nbsp;&nbsp;Duplicate Target Names</a></h3>
+<h3><a class="toc-backref" href="#id51" id="duplicate-target-names" name="duplicate-target-names">2.13.1&nbsp;&nbsp;&nbsp;Duplicate Target Names</a></h3>
<p>Duplicate names in section headers or other implicit targets will
generate &quot;info&quot; (level-1) system messages. Duplicate names in
explicit targets will generate &quot;warning&quot; (level-2) system messages.</p>
</div>
<div class="section">
-<h3><a class="toc-backref" href="#id47" id="id18" name="id18">2.13.2&nbsp;&nbsp;&nbsp;Duplicate Target Names</a></h3>
+<h3><a class="toc-backref" href="#id52" id="id20" name="id20">2.13.2&nbsp;&nbsp;&nbsp;Duplicate Target Names</a></h3>
<p>Since there are two &quot;Duplicate Target Names&quot; section headers, we
cannot uniquely refer to either of them by name. If we try to (like
-this: <a href="#id79" name="id80"><span class="problematic" id="id80">`Duplicate Target Names`_</span></a>), an error is generated.</p>
+this: <a href="#id84" name="id85"><span class="problematic" id="id85">`Duplicate Target Names`_</span></a>), an error is generated.</p>
</div>
</div>
<div class="section">
-<h2><a class="toc-backref" href="#id48" id="directives" name="directives">2.14&nbsp;&nbsp;&nbsp;Directives</a></h2>
+<h2><a class="toc-backref" href="#id53" id="directives" name="directives">2.14&nbsp;&nbsp;&nbsp;Directives</a></h2>
<div class="contents local topic">
<ul class="auto-toc simple">
-<li><a class="reference" href="#document-parts" id="id65" name="id65">2.14.1&nbsp;&nbsp;&nbsp;Document Parts</a></li>
-<li><a class="reference" href="#images" id="id66" name="id66">2.14.2&nbsp;&nbsp;&nbsp;Images</a></li>
-<li><a class="reference" href="#admonitions" id="id67" name="id67">2.14.3&nbsp;&nbsp;&nbsp;Admonitions</a></li>
-<li><a class="reference" href="#topics-sidebars-and-rubrics" id="id68" name="id68">2.14.4&nbsp;&nbsp;&nbsp;Topics, Sidebars, and Rubrics</a></li>
-<li><a class="reference" href="#target-footnotes" id="id69" name="id69">2.14.5&nbsp;&nbsp;&nbsp;Target Footnotes</a></li>
-<li><a class="reference" href="#replacement-text" id="id70" name="id70">2.14.6&nbsp;&nbsp;&nbsp;Replacement Text</a></li>
-<li><a class="reference" href="#compound-paragraph" id="id71" name="id71">2.14.7&nbsp;&nbsp;&nbsp;Compound Paragraph</a></li>
-<li><a class="reference" href="#parsed-literal-blocks" id="id72" name="id72">2.14.8&nbsp;&nbsp;&nbsp;Parsed Literal Blocks</a></li>
+<li><a class="reference" href="#document-parts" id="id70" name="id70">2.14.1&nbsp;&nbsp;&nbsp;Document Parts</a></li>
+<li><a class="reference" href="#images" id="id71" name="id71">2.14.2&nbsp;&nbsp;&nbsp;Images</a></li>
+<li><a class="reference" href="#admonitions" id="id72" name="id72">2.14.3&nbsp;&nbsp;&nbsp;Admonitions</a></li>
+<li><a class="reference" href="#topics-sidebars-and-rubrics" id="id73" name="id73">2.14.4&nbsp;&nbsp;&nbsp;Topics, Sidebars, and Rubrics</a></li>
+<li><a class="reference" href="#target-footnotes" id="id74" name="id74">2.14.5&nbsp;&nbsp;&nbsp;Target Footnotes</a></li>
+<li><a class="reference" href="#replacement-text" id="id75" name="id75">2.14.6&nbsp;&nbsp;&nbsp;Replacement Text</a></li>
+<li><a class="reference" href="#compound-paragraph" id="id76" name="id76">2.14.7&nbsp;&nbsp;&nbsp;Compound Paragraph</a></li>
+<li><a class="reference" href="#parsed-literal-blocks" id="id77" name="id77">2.14.8&nbsp;&nbsp;&nbsp;Parsed Literal Blocks</a></li>
</ul>
</div>
<p>These are just a sample of the many reStructuredText Directives. For
others, please see
<a class="reference" href="http://docutils.sourceforge.net/docs/ref/rst/directives.html">http://docutils.sourceforge.net/docs/ref/rst/directives.html</a>.</p>
<div class="section">
-<h3><a class="toc-backref" href="#id65" id="document-parts" name="document-parts">2.14.1&nbsp;&nbsp;&nbsp;Document Parts</a></h3>
+<h3><a class="toc-backref" href="#id70" id="document-parts" name="document-parts">2.14.1&nbsp;&nbsp;&nbsp;Document Parts</a></h3>
<p>An example of the &quot;contents&quot; directive can be seen above this section
(a local, untitled table of <a class="reference" href="#contents">contents</a>) and at the beginning of the
document (a document-wide <a class="reference" href="#table-of-contents">table of contents</a>).</p>
</div>
<div class="section">
-<h3><a class="toc-backref" href="#id66" id="images" name="images">2.14.2&nbsp;&nbsp;&nbsp;Images</a></h3>
+<h3><a class="toc-backref" href="#id71" id="images" name="images">2.14.2&nbsp;&nbsp;&nbsp;Images</a></h3>
<p>An image directive (also clickable -- a hyperlink reference):</p>
<a class="reference 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>
@@ -614,7 +614,7 @@ document (a document-wide <a class="reference" href="#table-of-contents">table o
<img alt="../../../docs/user/rst/images/biohazard.png" src="../../../docs/user/rst/images/biohazard.png" style="height: 3cm;" />
</div>
<div class="section">
-<h3><a class="toc-backref" href="#id67" id="admonitions" name="admonitions">2.14.3&nbsp;&nbsp;&nbsp;Admonitions</a></h3>
+<h3><a class="toc-backref" href="#id72" id="admonitions" name="admonitions">2.14.3&nbsp;&nbsp;&nbsp;Admonitions</a></h3>
<div class="attention">
<p class="first admonition-title">Attention!</p>
<p class="last">Directives at large.</p>
@@ -663,7 +663,7 @@ Reader discretion is strongly advised.</p>
</div>
</div>
<div class="section">
-<h3><a class="toc-backref" href="#id68" id="topics-sidebars-and-rubrics" name="topics-sidebars-and-rubrics">2.14.4&nbsp;&nbsp;&nbsp;Topics, Sidebars, and Rubrics</a></h3>
+<h3><a class="toc-backref" href="#id73" id="topics-sidebars-and-rubrics" name="topics-sidebars-and-rubrics">2.14.4&nbsp;&nbsp;&nbsp;Topics, Sidebars, and Rubrics</a></h3>
<div class="sidebar">
<p class="first sidebar-title">Sidebar Title</p>
<p class="sidebar-subtitle">Optional Subtitle</p>
@@ -680,20 +680,26 @@ background color.</p>
<p class="rubric">This is a rubric</p>
</div>
<div class="section">
-<h3><a class="toc-backref" href="#id69" id="target-footnotes" name="target-footnotes">2.14.5&nbsp;&nbsp;&nbsp;Target Footnotes</a></h3>
-<table class="docutils footnote" frame="void" id="id23" rules="none">
+<h3><a class="toc-backref" href="#id74" id="target-footnotes" name="target-footnotes">2.14.5&nbsp;&nbsp;&nbsp;Target Footnotes</a></h3>
+<table class="docutils footnote" frame="void" id="id25" rules="none">
+<colgroup><col class="label" /><col /></colgroup>
+<tbody valign="top">
+<tr><td class="label"><a name="id25">[5]</a></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="#id29">4</a>)</em> <a class="reference" href="http://www.python.org/">http://www.python.org/</a></td></tr>
+</tbody>
+</table>
+<table class="docutils footnote" frame="void" id="id30" rules="none">
<colgroup><col class="label" /><col /></colgroup>
<tbody valign="top">
-<tr><td class="label"><a name="id23">[5]</a></td><td><em>(<a class="fn-backref" href="#id24">1</a>, <a class="fn-backref" href="#id25">2</a>, <a class="fn-backref" href="#id26">3</a>)</em> <a class="reference" href="http://www.python.org/">http://www.python.org/</a></td></tr>
+<tr><td class="label"><a class="fn-backref" href="#id31" name="id30">[6]</a></td><td><a class="reference" href="http://docutils.sourceforge.net/">http://docutils.sourceforge.net/</a></td></tr>
</tbody>
</table>
</div>
<div class="section">
-<h3><a class="toc-backref" href="#id70" id="replacement-text" name="replacement-text">2.14.6&nbsp;&nbsp;&nbsp;Replacement Text</a></h3>
-<p>I recommend you try <a class="reference" href="http://www.python.org/">Python, <em>the</em> best language around</a> <a class="footnote-reference" href="#id23" id="id26" name="id26">[5]</a>.</p>
+<h3><a class="toc-backref" href="#id75" id="replacement-text" name="replacement-text">2.14.6&nbsp;&nbsp;&nbsp;Replacement Text</a></h3>
+<p>I recommend you try <a class="reference" href="http://www.python.org/">Python, <em>the</em> best language around</a> <a class="footnote-reference" href="#id25" id="id28" name="id28">[5]</a>.</p>
</div>
<div class="section">
-<h3><a class="toc-backref" href="#id71" id="compound-paragraph" name="compound-paragraph">2.14.7&nbsp;&nbsp;&nbsp;Compound Paragraph</a></h3>
+<h3><a class="toc-backref" href="#id76" id="compound-paragraph" name="compound-paragraph">2.14.7&nbsp;&nbsp;&nbsp;Compound Paragraph</a></h3>
<div class="some-class compound">
<p class="compound-first">Compound 1, paragraph 1.</p>
<p class="compound-middle">Compound 1, paragraph 2.</p>
@@ -761,23 +767,23 @@ paragraph.</td>
</div>
</div>
<div class="section">
-<h3><a class="toc-backref" href="#id72" id="parsed-literal-blocks" name="parsed-literal-blocks">2.14.8&nbsp;&nbsp;&nbsp;Parsed Literal Blocks</a></h3>
+<h3><a class="toc-backref" href="#id77" id="parsed-literal-blocks" name="parsed-literal-blocks">2.14.8&nbsp;&nbsp;&nbsp;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>, <tt class="docutils literal"><span class="pre">literal</span>
-<span class="pre">text</span></tt>, footnotes <a class="footnote-reference" href="#id6" id="id19" name="id19">[1]</a>, <span class="target" id="id20">targets</span>, and <a class="reference" href="http://www.python.org/">references</a>.
+<span class="pre">text</span></tt>, footnotes <a class="footnote-reference" href="#id8" id="id21" name="id21">[1]</a>, <span class="target" id="id22">targets</span>, and <a class="reference" href="http://www.python.org/">references</a>.
</pre>
</div>
</div>
<div class="section">
-<h2><a class="toc-backref" href="#id57" id="substitution-definitions" name="substitution-definitions">2.15&nbsp;&nbsp;&nbsp;Substitution Definitions</a></h2>
+<h2><a class="toc-backref" href="#id62" id="substitution-definitions" name="substitution-definitions">2.15&nbsp;&nbsp;&nbsp;Substitution Definitions</a></h2>
<p>An inline image (<img alt="EXAMPLE" src="../../../docs/user/rst/images/biohazard.png" />) example:</p>
<p>(Substitution definitions are not visible in the HTML source.)</p>
</div>
<div class="section">
-<h2><a class="toc-backref" href="#id58" id="comments" name="comments">2.16&nbsp;&nbsp;&nbsp;Comments</a></h2>
+<h2><a class="toc-backref" href="#id63" id="comments" name="comments">2.16&nbsp;&nbsp;&nbsp;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
@@ -787,13 +793,13 @@ Double-dashes - - "- -" - - must be escaped somehow in HTML output. -->
<p>(View the HTML source to see the comment.)</p>
</div>
<div class="section">
-<h2><a class="toc-backref" href="#id59" id="raw-text" name="raw-text">2.17&nbsp;&nbsp;&nbsp;Raw text</a></h2>
+<h2><a class="toc-backref" href="#id64" id="raw-text" name="raw-text">2.17&nbsp;&nbsp;&nbsp;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">
-<h2><a class="toc-backref" href="#id60" id="colspanning-tables" name="colspanning-tables">2.18&nbsp;&nbsp;&nbsp;Colspanning tables</a></h2>
+<h2><a class="toc-backref" href="#id65" id="colspanning-tables" name="colspanning-tables">2.18&nbsp;&nbsp;&nbsp;Colspanning tables</a></h2>
<p>This table has a cell spanning two columns:</p>
<table border="1" class="docutils">
<colgroup>
@@ -831,7 +837,7 @@ Fifth test in HTML.<br />Line two.</div>
</table>
</div>
<div class="section">
-<h2><a class="toc-backref" href="#id61" id="rowspanning-tables" name="rowspanning-tables">2.19&nbsp;&nbsp;&nbsp;Rowspanning tables</a></h2>
+<h2><a class="toc-backref" href="#id66" id="rowspanning-tables" name="rowspanning-tables">2.19&nbsp;&nbsp;&nbsp;Rowspanning tables</a></h2>
<p>Here's a table with cells spanning several rows:</p>
<table border="1" class="docutils">
<colgroup>
@@ -864,7 +870,7 @@ cell.</td>
</table>
</div>
<div class="section">
-<h2><a class="toc-backref" href="#id62" id="complex-tables" name="complex-tables">2.20&nbsp;&nbsp;&nbsp;Complex tables</a></h2>
+<h2><a class="toc-backref" href="#id67" id="complex-tables" name="complex-tables">2.20&nbsp;&nbsp;&nbsp;Complex tables</a></h2>
<p>Here's a complex table, which should test all features.</p>
<table border="1" class="docutils">
<colgroup>
@@ -913,7 +919,7 @@ empty: <tt class="docutils literal"><span class="pre">--&gt;</span></tt></td>
</table>
</div>
<div class="section">
-<h2><a class="toc-backref" href="#id63" id="list-tables" name="list-tables">2.21&nbsp;&nbsp;&nbsp;List Tables</a></h2>
+<h2><a class="toc-backref" href="#id68" id="list-tables" name="list-tables">2.21&nbsp;&nbsp;&nbsp;List Tables</a></h2>
<p>Here's a list table exercising all features:</p>
<table border="1" class="test docutils">
<caption>list table with integral header</caption>
@@ -947,7 +953,7 @@ crunchy, now would it?</td>
</div>
</div>
<div class="section">
-<h1><a class="toc-backref" href="#id64" id="error-handling" name="error-handling">3&nbsp;&nbsp;&nbsp;Error Handling</a></h1>
+<h1><a class="toc-backref" href="#id69" id="error-handling" name="error-handling">3&nbsp;&nbsp;&nbsp;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, &quot;Docutils System Messages&quot;:</p>
@@ -955,20 +961,20 @@ section, &quot;Docutils System Messages&quot;:</p>
</div>
<div class="system-messages section">
<h1><a>Docutils System Messages</a></h1>
-<div class="system-message" id="id21">
-<p class="system-message-title">System Message: <a name="id21">ERROR/3</a> (<tt class="docutils">functional/input/data/standard.txt</tt>, line 100); <em><a href="#id22">backlink</a></em></p>
+<div class="system-message" id="id23">
+<p class="system-message-title">System Message: <a name="id23">ERROR/3</a> (<tt class="docutils">functional/input/data/standard.txt</tt>, line 100); <em><a href="#id24">backlink</a></em></p>
Undefined substitution referenced: &quot;problematic&quot;.</div>
-<div class="system-message" id="id73">
-<p class="system-message-title">System Message: <a name="id73">ERROR/3</a> (<tt class="docutils">functional/input/standalone_rst_html4css1.txt</tt>, line 354); <em><a href="#id74">backlink</a></em></p>
+<div class="system-message" id="id78">
+<p class="system-message-title">System Message: <a name="id78">ERROR/3</a> (<tt class="docutils">functional/input/standalone_rst_html4css1.txt</tt>, line 358); <em><a href="#id79">backlink</a></em></p>
Unknown target name: &quot;5&quot;.</div>
-<div class="system-message" id="id75">
-<p class="system-message-title">System Message: <a name="id75">ERROR/3</a> (<tt class="docutils">functional/input/data/standard.txt</tt>, line 363); <em><a href="#id76">backlink</a></em></p>
+<div class="system-message" id="id80">
+<p class="system-message-title">System Message: <a name="id80">ERROR/3</a> (<tt class="docutils">functional/input/data/standard.txt</tt>, line 367); <em><a href="#id81">backlink</a></em></p>
Unknown target name: &quot;nonexistent&quot;.</div>
-<div class="system-message" id="id77">
-<p class="system-message-title">System Message: <a name="id77">ERROR/3</a> (<tt class="docutils">functional/input/data/standard.txt</tt>, line 390); <em><a href="#id78">backlink</a></em></p>
+<div class="system-message" id="id82">
+<p class="system-message-title">System Message: <a name="id82">ERROR/3</a> (<tt class="docutils">functional/input/data/standard.txt</tt>, line 394); <em><a href="#id83">backlink</a></em></p>
Unknown target name: &quot;hyperlink reference without a target&quot;.</div>
-<div class="system-message" id="id79">
-<p class="system-message-title">System Message: <a name="id79">ERROR/3</a> (<tt class="docutils">functional/input/data/standard.txt</tt>, line 403); <em><a href="#id80">backlink</a></em></p>
+<div class="system-message" id="id84">
+<p class="system-message-title">System Message: <a name="id84">ERROR/3</a> (<tt class="docutils">functional/input/data/standard.txt</tt>, line 407); <em><a href="#id85">backlink</a></em></p>
Duplicate target name, cannot be used as a unique reference: &quot;duplicate target names&quot;.</div>
</div>
</div>
diff --git a/docutils/test/functional/expected/standalone_rst_latex.tex b/docutils/test/functional/expected/standalone_rst_latex.tex
index 0a5aec391..4f318f90a 100644
--- a/docutils/test/functional/expected/standalone_rst_latex.tex
+++ b/docutils/test/functional/expected/standalone_rst_latex.tex
@@ -178,7 +178,7 @@ reStructuredText construct.
\begin{list}{}{}
\item {} \href{\#duplicate-target-names}{2.13.1~~~Duplicate Target Names}
-\item {} \href{\#id18}{2.13.2~~~Duplicate Target Names}
+\item {} \href{\#id20}{2.13.2~~~Duplicate Target Names}
\end{list}
@@ -298,17 +298,16 @@ A paragraph.
Paragraphs contain text and may contain inline markup: \emph{emphasis},
\textbf{strong emphasis}, \texttt{inline literals}, standalone hyperlinks
-(\href{http://www.python.org}{http://www.python.org}), external hyperlinks (\href{http://www.python.org/}{Python}\raisebox{.5em}[0em]{\scriptsize\hyperlink{id23}{5}}), internal
+(\href{http://www.python.org}{http://www.python.org}), external hyperlinks (\href{http://www.python.org/}{Python}\raisebox{.5em}[0em]{\scriptsize\hyperlink{id25}{5}}), internal
cross-references (\href{\#example}{example}), external hyperlinks with embedded URIs
-(\href{http://www.python.org}{Python web site}), footnote references
-(manually numbered\raisebox{.5em}[0em]{\scriptsize\hyperlink{id6}{1}}, anonymous auto-numbered\raisebox{.5em}[0em]{\scriptsize\hyperlink{id9}{3}}, labeled
-auto-numbered\raisebox{.5em}[0em]{\scriptsize\hyperlink{label}{2}}, or symbolic\raisebox{.5em}[0em]{\scriptsize\hyperlink{id10}{*}}), citation references
-([\hyperlink{cit2002}{CIT2002}]), substitution references (\includegraphics{../../../docs/user/rst/images/biohazard.png}), and \hypertarget{inline-hyperlink-targets}{inline
-hyperlink targets} (see \href{\#id20}{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
-{\color{red}\bfseries{}{\textbar}problematic{\textbar}} text (generated by processing errors; this one is
-intentional). Here is a reference to the \href{\#doctitle}{doctitle} and the \href{\#subtitle}{subtitle}.
+(\href{http://www.python.org}{Python web site}), \href{http://www.python.org/}{anonymous hyperlink
+references}\raisebox{.5em}[0em]{\scriptsize\hyperlink{id25}{5}} (\href{http://docutils.sourceforge.net/}{a second reference}\raisebox{.5em}[0em]{\scriptsize\hyperlink{id30}{6}}), footnote references (manually
+numbered\raisebox{.5em}[0em]{\scriptsize\hyperlink{id8}{1}}, anonymous auto-numbered\raisebox{.5em}[0em]{\scriptsize\hyperlink{id11}{3}}, labeled auto-numbered\raisebox{.5em}[0em]{\scriptsize\hyperlink{label}{2}}, or symbolic\raisebox{.5em}[0em]{\scriptsize\hyperlink{id12}{*}}), citation references ([\hyperlink{cit2002}{CIT2002}]),
+substitution references (\includegraphics{../../../docs/user/rst/images/biohazard.png}), and \hypertarget{inline-hyperlink-targets}{inline hyperlink targets}
+(see \href{\#id22}{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 {\color{red}\bfseries{}{\textbar}problematic{\textbar}} text
+(generated by processing errors; this one is intentional). Here is a
+reference to the \href{\#doctitle}{doctitle} and the \href{\#subtitle}{subtitle}.
The default role for interpreted text is \titlereference{Title Reference}. Here are
some explicit interpreted text roles: a PEP reference (\href{http://www.python.org/peps/pep-0287.html}{PEP 287}); an
@@ -725,20 +724,20 @@ Python-specific usage examples; begun with ">>>"
\hypertarget{footnotes}{}
\pdfbookmark[1]{2.11~~~Footnotes}{footnotes}
\subsection*{2.11~~~Footnotes}
-\begin{figure}[b]\hypertarget{id6}$^{1}$
+\begin{figure}[b]\hypertarget{id8}$^{1}$
A footnote contains body elements, consistently indented by at
least 3 spaces.
This is the footnote's second paragraph.
\end{figure}
\begin{figure}[b]\hypertarget{label}$^{2}$
-Footnotes may be numbered, either manually (as in\raisebox{.5em}[0em]{\scriptsize\hyperlink{id6}{1}}) or
+Footnotes may be numbered, either manually (as in\raisebox{.5em}[0em]{\scriptsize\hyperlink{id8}{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 (\raisebox{.5em}[0em]{\scriptsize\hyperlink{label}{2}}) and as a hyperlink reference
(\href{\#label}{label}).
\end{figure}
-\begin{figure}[b]\hypertarget{id9}$^{3}$
+\begin{figure}[b]\hypertarget{id11}$^{3}$
This footnote is numbered automatically and anonymously using a
label of ``{\#}'' only.
@@ -746,14 +745,14 @@ This is the second paragraph.
And this is the third paragraph.
\end{figure}
-\begin{figure}[b]\hypertarget{id10}$^{*}$
+\begin{figure}[b]\hypertarget{id12}$^{*}$
Footnotes may also use symbols, specified with a ``*'' label.
-Here's a reference to the next footnote:\raisebox{.5em}[0em]{\scriptsize\hyperlink{id12}{{\dag}}}.
+Here's a reference to the next footnote:\raisebox{.5em}[0em]{\scriptsize\hyperlink{id14}{{\dag}}}.
\end{figure}
-\begin{figure}[b]\hypertarget{id12}$^{{\dag}}$
+\begin{figure}[b]\hypertarget{id14}$^{{\dag}}$
This footnote shows the next symbol in the sequence.
\end{figure}
-\begin{figure}[b]\hypertarget{id13}$^{4}$
+\begin{figure}[b]\hypertarget{id15}$^{4}$
Here's an unreferenced footnote, with a reference to a
nonexistent footnote:{\color{red}\bfseries{}{[}5{]}{\_}}.
\end{figure}
@@ -786,13 +785,13 @@ reference can be found under \href{\#inline-markup}{Inline Markup}, above. \href
hyperlink targets} are also possible.
Section headers are implicit targets, referred to by name. See
-\href{\#id20}{Targets}, which is a subsection of \href{\#body-elements}{Body Elements}.
+\href{\#id22}{Targets}, which is a subsection of \href{\#body-elements}{Body Elements}.
Explicit external targets are interpolated into references such as
-``\href{http://www.python.org/}{Python}\raisebox{.5em}[0em]{\scriptsize\hyperlink{id23}{5}}''.
+``\href{http://www.python.org/}{Python}\raisebox{.5em}[0em]{\scriptsize\hyperlink{id25}{5}}''.
-Targets may be indirect and anonymous. Thus \href{\#id20}{this phrase} may also
-refer to the \href{\#id20}{Targets} section.
+Targets may be indirect and anonymous. Thus \href{\#id22}{this phrase} may also
+refer to the \href{\#id22}{Targets} section.
Here's a {\color{red}\bfseries{}`hyperlink reference without a target`{\_}}, which generates an
error.
@@ -811,8 +810,8 @@ explicit targets will generate ``warning'' (level-2) system messages.
%___________________________________________________________________________
-\hypertarget{id18}{}
-\pdfbookmark[2]{2.13.2~~~Duplicate Target Names}{id18}
+\hypertarget{id20}{}
+\pdfbookmark[2]{2.13.2~~~Duplicate Target Names}{id20}
\subsubsection*{2.13.2~~~Duplicate Target Names}
Since there are two ``Duplicate Target Names'' section headers, we
@@ -1109,9 +1108,12 @@ This is a topic.
\hypertarget{target-footnotes}{}
\pdfbookmark[2]{2.14.5~~~Target Footnotes}{target-footnotes}
\subsubsection*{2.14.5~~~Target Footnotes}
-\begin{figure}[b]\hypertarget{id23}$^{5}$
+\begin{figure}[b]\hypertarget{id25}$^{5}$
\href{http://www.python.org/}{http://www.python.org/}
\end{figure}
+\begin{figure}[b]\hypertarget{id30}$^{6}$
+\href{http://docutils.sourceforge.net/}{http://docutils.sourceforge.net/}
+\end{figure}
%___________________________________________________________________________
@@ -1120,7 +1122,7 @@ This is a topic.
\pdfbookmark[2]{2.14.6~~~Replacement Text}{replacement-text}
\subsubsection*{2.14.6~~~Replacement Text}
-I recommend you try \href{http://www.python.org/}{Python, \emph{the} best language around}\raisebox{.5em}[0em]{\scriptsize\hyperlink{id23}{5}}.
+I recommend you try \href{http://www.python.org/}{Python, \emph{the} best language around}\raisebox{.5em}[0em]{\scriptsize\hyperlink{id25}{5}}.
%___________________________________________________________________________
@@ -1207,7 +1209,7 @@ This~is~a~parsed~literal~block.~\\
~~~~This~line~is~indented.~~The~next~line~is~blank.~\\
~\\
Inline~markup~is~supported,~e.g.~\emph{emphasis},~\textbf{strong},~\texttt{literal~\\
-text},~footnotes\raisebox{.5em}[0em]{\scriptsize\hyperlink{id6}{1}},~\hypertarget{id20}{targets},~and~\href{http://www.python.org/}{references}.
+text},~footnotes\raisebox{.5em}[0em]{\scriptsize\hyperlink{id8}{1}},~\hypertarget{id22}{targets},~and~\href{http://www.python.org/}{references}.
}\end{quote}
diff --git a/docutils/test/functional/expected/standalone_rst_pseudoxml.txt b/docutils/test/functional/expected/standalone_rst_pseudoxml.txt
index ac3fc98a7..6af1c9ded 100644
--- a/docutils/test/functional/expected/standalone_rst_pseudoxml.txt
+++ b/docutils/test/functional/expected/standalone_rst_pseudoxml.txt
@@ -91,244 +91,244 @@
<bullet_list classes="auto-toc">
<list_item>
<paragraph>
- <reference ids="id27" refid="structural-elements">
+ <reference ids="id32" refid="structural-elements">
<generated classes="sectnum">
1   
Structural Elements
<bullet_list classes="auto-toc">
<list_item>
<paragraph>
- <reference ids="id28" refid="section-title">
+ <reference ids="id33" refid="section-title">
<generated classes="sectnum">
1.1   
Section Title
<list_item>
<paragraph>
- <reference ids="id29" refid="empty-section">
+ <reference ids="id34" refid="empty-section">
<generated classes="sectnum">
1.2   
Empty Section
<list_item>
<paragraph>
- <reference ids="id30" refid="transitions">
+ <reference ids="id35" refid="transitions">
<generated classes="sectnum">
1.3   
Transitions
<list_item>
<paragraph>
- <reference ids="id31" refid="body-elements">
+ <reference ids="id36" refid="body-elements">
<generated classes="sectnum">
2   
Body Elements
<bullet_list classes="auto-toc">
<list_item>
<paragraph>
- <reference ids="id32" refid="paragraphs">
+ <reference ids="id37" refid="paragraphs">
<generated classes="sectnum">
2.1   
Paragraphs
<bullet_list classes="auto-toc">
<list_item>
<paragraph>
- <reference ids="id33" refid="inline-markup">
+ <reference ids="id38" refid="inline-markup">
<generated classes="sectnum">
2.1.1   
Inline Markup
<list_item>
<paragraph>
- <reference ids="id34" refid="bullet-lists">
+ <reference ids="id39" refid="bullet-lists">
<generated classes="sectnum">
2.2   
Bullet Lists
<list_item>
<paragraph>
- <reference ids="id35" refid="enumerated-lists">
+ <reference ids="id40" refid="enumerated-lists">
<generated classes="sectnum">
2.3   
Enumerated Lists
<list_item>
<paragraph>
- <reference ids="id36" refid="definition-lists">
+ <reference ids="id41" refid="definition-lists">
<generated classes="sectnum">
2.4   
Definition Lists
<list_item>
<paragraph>
- <reference ids="id37" refid="field-lists">
+ <reference ids="id42" refid="field-lists">
<generated classes="sectnum">
2.5   
Field Lists
<list_item>
<paragraph>
- <reference ids="id38" refid="option-lists">
+ <reference ids="id43" refid="option-lists">
<generated classes="sectnum">
2.6   
Option Lists
<list_item>
<paragraph>
- <reference ids="id39" refid="literal-blocks">
+ <reference ids="id44" refid="literal-blocks">
<generated classes="sectnum">
2.7   
Literal Blocks
<list_item>
<paragraph>
- <reference ids="id40" refid="line-blocks">
+ <reference ids="id45" refid="line-blocks">
<generated classes="sectnum">
2.8   
Line Blocks
<list_item>
<paragraph>
- <reference ids="id41" refid="block-quotes">
+ <reference ids="id46" refid="block-quotes">
<generated classes="sectnum">
2.9   
Block Quotes
<list_item>
<paragraph>
- <reference ids="id42" refid="doctest-blocks">
+ <reference ids="id47" refid="doctest-blocks">
<generated classes="sectnum">
2.10   
Doctest Blocks
<list_item>
<paragraph>
- <reference ids="id43" refid="footnotes">
+ <reference ids="id48" refid="footnotes">
<generated classes="sectnum">
2.11   
Footnotes
<list_item>
<paragraph>
- <reference ids="id44" refid="citations">
+ <reference ids="id49" refid="citations">
<generated classes="sectnum">
2.12   
Citations
<list_item>
<paragraph>
- <reference ids="id45" refid="targets">
+ <reference ids="id50" refid="targets">
<generated classes="sectnum">
2.13   
Targets
<bullet_list classes="auto-toc">
<list_item>
<paragraph>
- <reference ids="id46" refid="duplicate-target-names">
+ <reference ids="id51" refid="duplicate-target-names">
<generated classes="sectnum">
2.13.1   
Duplicate Target Names
<list_item>
<paragraph>
- <reference ids="id47" refid="id18">
+ <reference ids="id52" refid="id20">
<generated classes="sectnum">
2.13.2   
Duplicate Target Names
<list_item>
<paragraph>
- <reference ids="id48" refid="directives">
+ <reference ids="id53" refid="directives">
<generated classes="sectnum">
2.14   
Directives
<bullet_list classes="auto-toc">
<list_item>
<paragraph>
- <reference ids="id49" refid="document-parts">
+ <reference ids="id54" refid="document-parts">
<generated classes="sectnum">
2.14.1   
Document Parts
<list_item>
<paragraph>
- <reference ids="id50" refid="images">
+ <reference ids="id55" refid="images">
<generated classes="sectnum">
2.14.2   
Images
<list_item>
<paragraph>
- <reference ids="id51" refid="admonitions">
+ <reference ids="id56" refid="admonitions">
<generated classes="sectnum">
2.14.3   
Admonitions
<list_item>
<paragraph>
- <reference ids="id52" refid="topics-sidebars-and-rubrics">
+ <reference ids="id57" refid="topics-sidebars-and-rubrics">
<generated classes="sectnum">
2.14.4   
Topics, Sidebars, and Rubrics
<list_item>
<paragraph>
- <reference ids="id53" refid="target-footnotes">
+ <reference ids="id58" refid="target-footnotes">
<generated classes="sectnum">
2.14.5   
Target Footnotes
<list_item>
<paragraph>
- <reference ids="id54" refid="replacement-text">
+ <reference ids="id59" refid="replacement-text">
<generated classes="sectnum">
2.14.6   
Replacement Text
<list_item>
<paragraph>
- <reference ids="id55" refid="compound-paragraph">
+ <reference ids="id60" refid="compound-paragraph">
<generated classes="sectnum">
2.14.7   
Compound Paragraph
<list_item>
<paragraph>
- <reference ids="id56" refid="parsed-literal-blocks">
+ <reference ids="id61" refid="parsed-literal-blocks">
<generated classes="sectnum">
2.14.8   
Parsed Literal Blocks
<list_item>
<paragraph>
- <reference ids="id57" refid="substitution-definitions">
+ <reference ids="id62" refid="substitution-definitions">
<generated classes="sectnum">
2.15   
Substitution Definitions
<list_item>
<paragraph>
- <reference ids="id58" refid="comments">
+ <reference ids="id63" refid="comments">
<generated classes="sectnum">
2.16   
Comments
<list_item>
<paragraph>
- <reference ids="id59" refid="raw-text">
+ <reference ids="id64" refid="raw-text">
<generated classes="sectnum">
2.17   
Raw text
<list_item>
<paragraph>
- <reference ids="id60" refid="colspanning-tables">
+ <reference ids="id65" refid="colspanning-tables">
<generated classes="sectnum">
2.18   
Colspanning tables
<list_item>
<paragraph>
- <reference ids="id61" refid="rowspanning-tables">
+ <reference ids="id66" refid="rowspanning-tables">
<generated classes="sectnum">
2.19   
Rowspanning tables
<list_item>
<paragraph>
- <reference ids="id62" refid="complex-tables">
+ <reference ids="id67" refid="complex-tables">
<generated classes="sectnum">
2.20   
Complex tables
<list_item>
<paragraph>
- <reference ids="id63" refid="list-tables">
+ <reference ids="id68" refid="list-tables">
<generated classes="sectnum">
2.21   
List Tables
<list_item>
<paragraph>
- <reference ids="id64" refid="error-handling">
+ <reference ids="id69" refid="error-handling">
<generated classes="sectnum">
3   
Error Handling
<section ids="structural-elements" names="structural\ elements">
- <title auto="1" refid="id27">
+ <title auto="1" refid="id32">
<generated classes="sectnum">
1   
Structural Elements
<section ids="section-title" names="section\ title">
- <title auto="1" refid="id28">
+ <title auto="1" refid="id33">
<generated classes="sectnum">
1.1   
Section Title
@@ -337,12 +337,12 @@
<paragraph>
That's it, the text just above this line.
<section ids="empty-section" names="empty\ section">
- <title auto="1" refid="id29">
+ <title auto="1" refid="id34">
<generated classes="sectnum">
1.2   
Empty Section
<section ids="transitions" names="transitions">
- <title auto="1" refid="id30">
+ <title auto="1" refid="id35">
<generated classes="sectnum">
1.3   
Transitions
@@ -353,19 +353,19 @@
It divides the section. Transitions may also occur between sections:
<transition>
<section ids="body-elements" names="body\ elements">
- <title auto="1" refid="id31">
+ <title auto="1" refid="id36">
<generated classes="sectnum">
2   
Body Elements
<section ids="paragraphs" names="paragraphs">
- <title auto="1" refid="id32">
+ <title auto="1" refid="id37">
<generated classes="sectnum">
2.1   
Paragraphs
<paragraph>
A paragraph.
<section ids="inline-markup" names="inline\ markup">
- <title auto="1" refid="id33">
+ <title auto="1" refid="id38">
<generated classes="sectnum">
2.1.1   
Inline Markup
@@ -387,7 +387,7 @@
<reference name="Python" refuri="http://www.python.org/">
Python
- <footnote_reference auto="1" ids="id24" refid="id23">
+ <footnote_reference auto="1" ids="id26" refid="id25">
5
), internal
cross-references (
@@ -397,53 +397,67 @@
(
<reference name="Python web site" refuri="http://www.python.org">
Python web site
- ), footnote references
- (manually numbered
- <footnote_reference ids="id1" refid="id6">
+ ),
+ <reference anonymous="1" name="anonymous hyperlink references" refuri="http://www.python.org/">
+ anonymous hyperlink
+ references
+
+ <footnote_reference auto="1" ids="id29" refid="id25">
+ 5
+ (
+ <reference anonymous="1" name="a second reference" refuri="http://docutils.sourceforge.net/">
+ a second reference
+
+ <footnote_reference auto="1" ids="id31" refid="id30">
+ 6
+ ), footnote references (manually
+ numbered
+ <footnote_reference ids="id1" refid="id8">
1
, anonymous auto-numbered
- <footnote_reference auto="1" ids="id2" refid="id9">
+ <footnote_reference auto="1" ids="id2" refid="id11">
3
- , labeled
- auto-numbered
+ , labeled auto-numbered
<footnote_reference auto="1" ids="id3" refid="label">
2
, or symbolic
- <footnote_reference auto="*" ids="id4" refid="id10">
+ <footnote_reference auto="*" ids="id4" refid="id12">
*
- ), citation references
- (
+ ), citation references (
<citation_reference ids="id5" refid="cit2002">
CIT2002
- ), substitution references (
+ ),
+ substitution references (
<image alt="EXAMPLE" uri="../../../docs/user/rst/images/biohazard.png">
), and
<target ids="inline-hyperlink-targets" names="inline\ hyperlink\ targets">
- inline
- hyperlink targets
- (see
- <reference name="Targets" refid="id20">
+ inline hyperlink targets
+
+ (see
+ <reference name="Targets" refid="id22">
Targets
- below for a reference back to here).
- Character-level inline markup is also possible (although exceedingly
- ugly!) in
+ below for a reference back to here). Character-level
+ inline markup is also possible (although exceedingly ugly!) in
<emphasis>
re
<literal>
Structured
<emphasis>
Text
- . Problems are indicated by
- <problematic ids="id22" refid="id21">
+ . Problems are indicated by
+ <problematic ids="id24" refid="id23">
|problematic|
- text (generated by processing errors; this one is
- intentional). Here is a reference to the
+ text
+ (generated by processing errors; this one is intentional). Here is a
+ reference to the
<reference name="doctitle" refid="doctitle">
doctitle
and the
<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/">
<paragraph>
The default role for interpreted text is
<title_reference>
@@ -490,7 +504,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="id34">
+ <title auto="1" refid="id39">
<generated classes="sectnum">
2.2   
Bullet Lists
@@ -534,7 +548,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="id35">
+ <title auto="1" refid="id40">
<generated classes="sectnum">
2.3   
Enumerated Lists
@@ -583,7 +597,7 @@
<paragraph>
iv
<section ids="definition-lists" names="definition\ lists">
- <title auto="1" refid="id36">
+ <title auto="1" refid="id41">
<generated classes="sectnum">
2.4   
Definition Lists
@@ -621,7 +635,7 @@
<paragraph>
Definition
<section ids="field-lists" names="field\ lists">
- <title auto="1" refid="id37">
+ <title auto="1" refid="id42">
<generated classes="sectnum">
2.5   
Field Lists
@@ -655,7 +669,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="id38">
+ <title auto="1" refid="id43">
<generated classes="sectnum">
2.6   
Option Lists
@@ -768,7 +782,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="id39">
+ <title auto="1" refid="id44">
<generated classes="sectnum">
2.7   
Literal Blocks
@@ -790,7 +804,7 @@
>
> Why didn't I think of that?
<section ids="line-blocks" names="line\ blocks">
- <title auto="1" refid="id40">
+ <title auto="1" refid="id45">
<generated classes="sectnum">
2.8   
Line Blocks
@@ -868,7 +882,7 @@
<line>
Singing...
<section ids="block-quotes" names="block\ quotes">
- <title auto="1" refid="id41">
+ <title auto="1" refid="id46">
<generated classes="sectnum">
2.9   
Block Quotes
@@ -884,7 +898,7 @@
<attribution>
Anne Elk (Miss)
<section ids="doctest-blocks" names="doctest\ blocks">
- <title auto="1" refid="id42">
+ <title auto="1" refid="id47">
<generated classes="sectnum">
2.10   
Doctest Blocks
@@ -894,11 +908,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="id43">
+ <title auto="1" refid="id48">
<generated classes="sectnum">
2.11   
Footnotes
- <footnote backrefs="id1 id7 id19" ids="id6" names="1">
+ <footnote backrefs="id1 id9 id21" ids="id8" names="1">
<label>
1
<paragraph>
@@ -906,25 +920,25 @@
least 3 spaces.
<paragraph>
This is the footnote's second paragraph.
- <footnote auto="1" backrefs="id3 id8" ids="label" names="label">
+ <footnote auto="1" backrefs="id3 id10" ids="label" names="label">
<label>
2
<paragraph>
Footnotes may be numbered, either manually (as in
- <footnote_reference ids="id7" refid="id6">
+ <footnote_reference ids="id9" refid="id8">
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="id8" refid="label">
+ <footnote_reference auto="1" ids="id10" refid="label">
2
) and as a hyperlink reference
(
<reference name="label" refid="label">
label
).
- <footnote auto="1" backrefs="id2" ids="id9" names="3">
+ <footnote auto="1" backrefs="id2" ids="id11" names="3">
<label>
3
<paragraph>
@@ -934,35 +948,35 @@
This is the second paragraph.
<paragraph>
And this is the third paragraph.
- <footnote auto="*" backrefs="id4" ids="id10">
+ <footnote auto="*" backrefs="id4" ids="id12">
<label>
*
<paragraph>
Footnotes may also use symbols, specified with a "*" label.
Here's a reference to the next footnote:
- <footnote_reference auto="*" ids="id11" refid="id12">
+ <footnote_reference auto="*" ids="id13" refid="id14">
.
- <footnote auto="*" backrefs="id11" ids="id12">
+ <footnote auto="*" backrefs="id13" ids="id14">
<label>
<paragraph>
This footnote shows the next symbol in the sequence.
- <footnote ids="id13" names="4">
+ <footnote ids="id15" names="4">
<label>
4
<paragraph>
Here's an unreferenced footnote, with a reference to a
nonexistent footnote:
- <problematic ids="id74 id14" refid="id73">
+ <problematic ids="id79 id16" refid="id78">
[5]_
.
<section ids="citations" names="citations">
- <title auto="1" refid="id44">
+ <title auto="1" refid="id49">
<generated classes="sectnum">
2.12   
Citations
- <citation backrefs="id5 id15" ids="cit2002" names="cit2002">
+ <citation backrefs="id5 id17" ids="cit2002" names="cit2002">
<label>
CIT2002
<paragraph>
@@ -970,16 +984,16 @@
rendered separately and differently from footnotes.
<paragraph>
Here's a reference to the above,
- <citation_reference ids="id15" refid="cit2002">
+ <citation_reference ids="id17" refid="cit2002">
CIT2002
, and a
- <problematic ids="id76 id16" refid="id75">
+ <problematic ids="id81 id18" refid="id80">
[nonexistent]_
citation.
<target refid="another-target">
<section dupnames="targets" ids="targets another-target" names="another\ target">
- <title auto="1" refid="id45">
+ <title auto="1" refid="id50">
<generated classes="sectnum">
2.13   
Targets
@@ -996,7 +1010,7 @@
are also possible.
<paragraph>
Section headers are implicit targets, referred to by name. See
- <reference name="Targets" refid="id20">
+ <reference name="Targets" refid="id22">
Targets
, which is a subsection of
<reference name="Body Elements" refid="body-elements">
@@ -1008,28 +1022,28 @@
<reference name="Python" refuri="http://www.python.org/">
Python
- <footnote_reference auto="1" ids="id25" refid="id23">
+ <footnote_reference auto="1" ids="id27" refid="id25">
5
".
<target ids="python" names="python" refuri="http://www.python.org/">
<paragraph>
Targets may be indirect and anonymous. Thus
- <reference anonymous="1" name="this phrase" refid="id20">
+ <reference anonymous="1" name="this phrase" refid="id22">
this phrase
may also
refer to the
- <reference name="Targets" refid="id20">
+ <reference name="Targets" refid="id22">
Targets
section.
- <target anonymous="1" ids="id17" refid="id20">
+ <target anonymous="1" ids="id19" refid="id22">
<paragraph>
Here's a
- <problematic ids="id78" refid="id77">
+ <problematic ids="id83" refid="id82">
`hyperlink reference without a target`_
, which generates an
error.
<section dupnames="duplicate\ target\ names" ids="duplicate-target-names">
- <title auto="1" refid="id46">
+ <title auto="1" refid="id51">
<generated classes="sectnum">
2.13.1   
Duplicate Target Names
@@ -1037,8 +1051,8 @@
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="id18">
- <title auto="1" refid="id47">
+ <section dupnames="duplicate\ target\ names" ids="id20">
+ <title auto="1" refid="id52">
<generated classes="sectnum">
2.13.2   
Duplicate Target Names
@@ -1046,11 +1060,11 @@
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="id80" refid="id79">
+ <problematic ids="id85" refid="id84">
`Duplicate Target Names`_
), an error is generated.
<section ids="directives" names="directives">
- <title auto="1" refid="id48">
+ <title auto="1" refid="id53">
<generated classes="sectnum">
2.14   
Directives
@@ -1058,49 +1072,49 @@
<bullet_list classes="auto-toc">
<list_item>
<paragraph>
- <reference ids="id65" refid="document-parts">
+ <reference ids="id70" refid="document-parts">
<generated classes="sectnum">
2.14.1   
Document Parts
<list_item>
<paragraph>
- <reference ids="id66" refid="images">
+ <reference ids="id71" refid="images">
<generated classes="sectnum">
2.14.2   
Images
<list_item>
<paragraph>
- <reference ids="id67" refid="admonitions">
+ <reference ids="id72" refid="admonitions">
<generated classes="sectnum">
2.14.3   
Admonitions
<list_item>
<paragraph>
- <reference ids="id68" refid="topics-sidebars-and-rubrics">
+ <reference ids="id73" refid="topics-sidebars-and-rubrics">
<generated classes="sectnum">
2.14.4   
Topics, Sidebars, and Rubrics
<list_item>
<paragraph>
- <reference ids="id69" refid="target-footnotes">
+ <reference ids="id74" refid="target-footnotes">
<generated classes="sectnum">
2.14.5   
Target Footnotes
<list_item>
<paragraph>
- <reference ids="id70" refid="replacement-text">
+ <reference ids="id75" refid="replacement-text">
<generated classes="sectnum">
2.14.6   
Replacement Text
<list_item>
<paragraph>
- <reference ids="id71" refid="compound-paragraph">
+ <reference ids="id76" refid="compound-paragraph">
<generated classes="sectnum">
2.14.7   
Compound Paragraph
<list_item>
<paragraph>
- <reference ids="id72" refid="parsed-literal-blocks">
+ <reference ids="id77" refid="parsed-literal-blocks">
<generated classes="sectnum">
2.14.8   
Parsed Literal Blocks
@@ -1111,7 +1125,7 @@
http://docutils.sourceforge.net/docs/ref/rst/directives.html
.
<section ids="document-parts" names="document\ parts">
- <title auto="1" refid="id65">
+ <title auto="1" refid="id70">
<generated classes="sectnum">
2.14.1   
Document Parts
@@ -1126,7 +1140,7 @@
table of contents
).
<section ids="images" names="images">
- <title auto="1" refid="id66">
+ <title auto="1" refid="id71">
<generated classes="sectnum">
2.14.2   
Images
@@ -1227,7 +1241,7 @@
An image 3 cm high:
<image height="3cm" uri="../../../docs/user/rst/images/biohazard.png">
<section ids="admonitions" names="admonitions">
- <title auto="1" refid="id67">
+ <title auto="1" refid="id72">
<generated classes="sectnum">
2.14.3   
Admonitions
@@ -1277,7 +1291,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="id68">
+ <title auto="1" refid="id73">
<generated classes="sectnum">
2.14.4   
Topics, Sidebars, and Rubrics
@@ -1302,18 +1316,24 @@
<rubric>
This is a rubric
<section ids="target-footnotes" names="target\ footnotes">
- <title auto="1" refid="id69">
+ <title auto="1" refid="id74">
<generated classes="sectnum">
2.14.5   
Target Footnotes
- <footnote auto="1" backrefs="id24 id25 id26" ids="id23" names="TARGET_NOTE:\ id23">
+ <footnote auto="1" backrefs="id26 id27 id28 id29" ids="id25" names="TARGET_NOTE:\ id25">
<label>
5
<paragraph>
<reference refuri="http://www.python.org/">
http://www.python.org/
+ <footnote auto="1" backrefs="id31" ids="id30" names="TARGET_NOTE:\ id30">
+ <label>
+ 6
+ <paragraph>
+ <reference refuri="http://docutils.sourceforge.net/">
+ http://docutils.sourceforge.net/
<section ids="replacement-text" names="replacement\ text">
- <title auto="1" refid="id70">
+ <title auto="1" refid="id75">
<generated classes="sectnum">
2.14.6   
Replacement Text
@@ -1325,7 +1345,7 @@
the
best language around
- <footnote_reference auto="1" ids="id26" refid="id23">
+ <footnote_reference auto="1" ids="id28" refid="id25">
5
.
<substitution_definition names="Python">
@@ -1334,7 +1354,7 @@
the
best language around
<section ids="compound-paragraph" names="compound\ paragraph">
- <title auto="1" refid="id71">
+ <title auto="1" refid="id76">
<generated classes="sectnum">
2.14.7   
Compound Paragraph
@@ -1420,7 +1440,7 @@
<paragraph>
Compound 7, another paragraph.
<section ids="parsed-literal-blocks" names="parsed\ literal\ blocks">
- <title auto="1" refid="id72">
+ <title auto="1" refid="id77">
<generated classes="sectnum">
2.14.8   
Parsed Literal Blocks
@@ -1439,10 +1459,10 @@
literal
text
, footnotes
- <footnote_reference ids="id19" refid="id6">
+ <footnote_reference ids="id21" refid="id8">
1
,
- <target ids="id20" names="targets">
+ <target ids="id22" names="targets">
targets
, and
<reference name="references" refuri="http://www.python.org/">
@@ -1450,7 +1470,7 @@
<target ids="references" names="references" refuri="http://www.python.org/">
.
<section ids="substitution-definitions" names="substitution\ definitions">
- <title auto="1" refid="id57">
+ <title auto="1" refid="id62">
<generated classes="sectnum">
2.15   
Substitution Definitions
@@ -1463,7 +1483,7 @@
<paragraph>
(Substitution definitions are not visible in the HTML source.)
<section ids="comments" names="comments">
- <title auto="1" refid="id58">
+ <title auto="1" refid="id63">
<generated classes="sectnum">
2.16   
Comments
@@ -1478,7 +1498,7 @@
<paragraph>
(View the HTML source to see the comment.)
<section ids="raw-text" names="raw\ text">
- <title auto="1" refid="id59">
+ <title auto="1" refid="id64">
<generated classes="sectnum">
2.17   
Raw text
@@ -1502,7 +1522,7 @@
<raw format="latex" xml:space="preserve">
Fifth test in LaTeX.\\Line two.
<section ids="colspanning-tables" names="colspanning\ tables">
- <title auto="1" refid="id60">
+ <title auto="1" refid="id65">
<generated classes="sectnum">
2.18   
Colspanning tables
@@ -1573,7 +1593,7 @@
<paragraph>
True
<section ids="rowspanning-tables" names="rowspanning\ tables">
- <title auto="1" refid="id61">
+ <title auto="1" refid="id66">
<generated classes="sectnum">
2.19   
Rowspanning tables
@@ -1625,7 +1645,7 @@
<paragraph>
body row 3
<section ids="complex-tables" names="complex\ tables">
- <title auto="1" refid="id62">
+ <title auto="1" refid="id67">
<generated classes="sectnum">
2.20   
Complex tables
@@ -1710,7 +1730,7 @@
-->
<entry>
<section ids="list-tables" names="list\ tables">
- <title auto="1" refid="id63">
+ <title auto="1" refid="id68">
<generated classes="sectnum">
2.21   
List Tables
@@ -1767,7 +1787,7 @@
<paragraph>
On a stick!
<section ids="error-handling" names="error\ handling">
- <title auto="1" refid="id64">
+ <title auto="1" refid="id69">
<generated classes="sectnum">
3   
Error Handling
@@ -1781,18 +1801,18 @@
<section classes="system-messages">
<title>
Docutils System Messages
- <system_message backrefs="id22" ids="id21" level="3" line="100" source="functional/input/data/standard.txt" type="ERROR">
+ <system_message backrefs="id24" ids="id23" level="3" line="100" source="functional/input/data/standard.txt" type="ERROR">
<paragraph>
Undefined substitution referenced: "problematic".
- <system_message backrefs="id74" ids="id73" level="3" line="354" source="functional/input/standalone_rst_html4css1.txt" type="ERROR">
+ <system_message backrefs="id79" ids="id78" level="3" line="358" source="functional/input/standalone_rst_html4css1.txt" type="ERROR">
<paragraph>
Unknown target name: "5".
- <system_message backrefs="id76" ids="id75" level="3" line="363" source="functional/input/data/standard.txt" type="ERROR">
+ <system_message backrefs="id81" ids="id80" level="3" line="367" source="functional/input/data/standard.txt" type="ERROR">
<paragraph>
Unknown target name: "nonexistent".
- <system_message backrefs="id78" ids="id77" level="3" line="390" source="functional/input/data/standard.txt" type="ERROR">
+ <system_message backrefs="id83" ids="id82" level="3" line="394" source="functional/input/data/standard.txt" type="ERROR">
<paragraph>
Unknown target name: "hyperlink reference without a target".
- <system_message backrefs="id80" ids="id79" level="3" line="403" source="functional/input/data/standard.txt" type="ERROR">
+ <system_message backrefs="id85" ids="id84" level="3" line="407" source="functional/input/data/standard.txt" type="ERROR">
<paragraph>
Duplicate target name, cannot be used as a unique reference: "duplicate target names".
diff --git a/docutils/test/functional/input/data/standard.txt b/docutils/test/functional/input/data/standard.txt
index ccb5ddbeb..ea904eaec 100644
--- a/docutils/test/functional/input/data/standard.txt
+++ b/docutils/test/functional/input/data/standard.txt
@@ -99,15 +99,19 @@ Paragraphs contain text and may contain inline markup: *emphasis*,
**strong emphasis**, ``inline literals``, standalone hyperlinks
(http://www.python.org), external hyperlinks (Python_), internal
cross-references (example_), external hyperlinks with embedded URIs
-(`Python web site <http://www.python.org>`__), footnote references
-(manually numbered [1]_, anonymous auto-numbered [#]_, labeled
-auto-numbered [#label]_, or symbolic [*]_), citation references
-([CIT2002]_), substitution references (|example|), and _`inline
-hyperlink targets` (see Targets_ below for a reference back to here).
-Character-level inline markup is also possible (although exceedingly
-ugly!) in *re*\ ``Structured``\ *Text*. Problems are indicated by
-|problematic| text (generated by processing errors; this one is
-intentional). Here is a reference to the doctitle_ and the subtitle_.
+(`Python web site <http://www.python.org>`__), `anonymous hyperlink
+references`__ (`a second reference`__), footnote references (manually
+numbered [1]_, anonymous auto-numbered [#]_, labeled auto-numbered
+[#label]_, or symbolic [*]_), citation references ([CIT2002]_),
+substitution references (|example|), and _`inline hyperlink targets`
+(see Targets_ below for a reference back to here). Character-level
+inline markup is also possible (although exceedingly ugly!) in *re*\
+``Structured``\ *Text*. Problems are indicated by |problematic| text
+(generated by processing errors; this one is intentional). Here is a
+reference to the doctitle_ and the subtitle_.
+
+__ http://www.python.org/
+__ http://docutils.sourceforge.net/
The default role for interpreted text is `Title Reference`. Here are
some explicit interpreted text roles: a PEP reference (:PEP:`287`); an