summaryrefslogtreecommitdiff
path: root/docutils/test/functional
diff options
context:
space:
mode:
authorwiemann <wiemann@929543f6-e4f2-0310-98a6-ba3bd3dd1d04>2004-11-26 09:32:56 +0000
committerwiemann <wiemann@929543f6-e4f2-0310-98a6-ba3bd3dd1d04>2004-11-26 09:32:56 +0000
commitbd7d432a7e7d9c2a816e8533d57b1d9c83c880ed (patch)
treeff6078a9d83b9888f3521ea41b4adb1e00ed476b /docutils/test/functional
parentf581c40df4ed37dbc2f9ec83abb76ed2c05a2ecc (diff)
downloaddocutils-bd7d432a7e7d9c2a816e8533d57b1d9c83c880ed.tar.gz
added functional tests for empty sections and transitions between sections
git-svn-id: http://svn.code.sf.net/p/docutils/code/trunk@2871 929543f6-e4f2-0310-98a6-ba3bd3dd1d04
Diffstat (limited to 'docutils/test/functional')
-rw-r--r--docutils/test/functional/expected/standalone_rst_html4css1.html175
-rw-r--r--docutils/test/functional/expected/standalone_rst_latex.tex22
-rw-r--r--docutils/test/functional/input/data/standard.txt7
3 files changed, 114 insertions, 90 deletions
diff --git a/docutils/test/functional/expected/standalone_rst_html4css1.html b/docutils/test/functional/expected/standalone_rst_html4css1.html
index f8c74775b..1e8140686 100644
--- a/docutils/test/functional/expected/standalone_rst_html4css1.html
+++ b/docutils/test/functional/expected/standalone_rst_html4css1.html
@@ -86,48 +86,49 @@ They are transformed from section titles after parsing. -->
<ul class="auto-toc simple">
<li><a class="reference" href="#structural-elements" id="id25" name="id25">1&nbsp;&nbsp;&nbsp;Structural Elements</a><ul class="auto-toc">
<li><a class="reference" href="#section-title" id="id26" name="id26">1.1&nbsp;&nbsp;&nbsp;Section Title</a></li>
-<li><a class="reference" href="#transitions" id="id27" name="id27">1.2&nbsp;&nbsp;&nbsp;Transitions</a></li>
+<li><a class="reference" href="#empty-section" id="id27" name="id27">1.2&nbsp;&nbsp;&nbsp;Empty Section</a></li>
+<li><a class="reference" href="#transitions" id="id28" name="id28">1.3&nbsp;&nbsp;&nbsp;Transitions</a></li>
</ul>
</li>
-<li><a class="reference" href="#body-elements" id="id28" name="id28">2&nbsp;&nbsp;&nbsp;Body Elements</a><ul class="auto-toc">
-<li><a class="reference" href="#paragraphs" id="id29" name="id29">2.1&nbsp;&nbsp;&nbsp;Paragraphs</a><ul class="auto-toc">
-<li><a class="reference" href="#inline-markup" id="id30" name="id30">2.1.1&nbsp;&nbsp;&nbsp;Inline Markup</a></li>
+<li><a class="reference" href="#body-elements" id="id29" name="id29">2&nbsp;&nbsp;&nbsp;Body Elements</a><ul class="auto-toc">
+<li><a class="reference" href="#paragraphs" id="id30" name="id30">2.1&nbsp;&nbsp;&nbsp;Paragraphs</a><ul class="auto-toc">
+<li><a class="reference" href="#inline-markup" id="id31" name="id31">2.1.1&nbsp;&nbsp;&nbsp;Inline Markup</a></li>
</ul>
</li>
-<li><a class="reference" href="#bullet-lists" id="id31" name="id31">2.2&nbsp;&nbsp;&nbsp;Bullet Lists</a></li>
-<li><a class="reference" href="#enumerated-lists" id="id32" name="id32">2.3&nbsp;&nbsp;&nbsp;Enumerated Lists</a></li>
-<li><a class="reference" href="#definition-lists" id="id33" name="id33">2.4&nbsp;&nbsp;&nbsp;Definition Lists</a></li>
-<li><a class="reference" href="#field-lists" id="id34" name="id34">2.5&nbsp;&nbsp;&nbsp;Field Lists</a></li>
-<li><a class="reference" href="#option-lists" id="id35" name="id35">2.6&nbsp;&nbsp;&nbsp;Option Lists</a></li>
-<li><a class="reference" href="#literal-blocks" id="id36" name="id36">2.7&nbsp;&nbsp;&nbsp;Literal Blocks</a></li>
-<li><a class="reference" href="#line-blocks" id="id37" name="id37">2.8&nbsp;&nbsp;&nbsp;Line Blocks</a></li>
-<li><a class="reference" href="#block-quotes" id="id38" name="id38">2.9&nbsp;&nbsp;&nbsp;Block Quotes</a></li>
-<li><a class="reference" href="#doctest-blocks" id="id39" name="id39">2.10&nbsp;&nbsp;&nbsp;Doctest Blocks</a></li>
-<li><a class="reference" href="#footnotes" id="id40" name="id40">2.11&nbsp;&nbsp;&nbsp;Footnotes</a></li>
-<li><a class="reference" href="#citations" id="id41" name="id41">2.12&nbsp;&nbsp;&nbsp;Citations</a></li>
-<li><a class="reference" href="#targets" id="id42" name="id42">2.13&nbsp;&nbsp;&nbsp;Targets</a><ul class="auto-toc">
-<li><a class="reference" href="#duplicate-target-names" id="id43" name="id43">2.13.1&nbsp;&nbsp;&nbsp;Duplicate Target Names</a></li>
-<li><a class="reference" href="#id18" id="id44" name="id44">2.13.2&nbsp;&nbsp;&nbsp;Duplicate Target Names</a></li>
+<li><a class="reference" href="#bullet-lists" id="id32" name="id32">2.2&nbsp;&nbsp;&nbsp;Bullet Lists</a></li>
+<li><a class="reference" href="#enumerated-lists" id="id33" name="id33">2.3&nbsp;&nbsp;&nbsp;Enumerated Lists</a></li>
+<li><a class="reference" href="#definition-lists" id="id34" name="id34">2.4&nbsp;&nbsp;&nbsp;Definition Lists</a></li>
+<li><a class="reference" href="#field-lists" id="id35" name="id35">2.5&nbsp;&nbsp;&nbsp;Field Lists</a></li>
+<li><a class="reference" href="#option-lists" id="id36" name="id36">2.6&nbsp;&nbsp;&nbsp;Option Lists</a></li>
+<li><a class="reference" href="#literal-blocks" id="id37" name="id37">2.7&nbsp;&nbsp;&nbsp;Literal Blocks</a></li>
+<li><a class="reference" href="#line-blocks" id="id38" name="id38">2.8&nbsp;&nbsp;&nbsp;Line Blocks</a></li>
+<li><a class="reference" href="#block-quotes" id="id39" name="id39">2.9&nbsp;&nbsp;&nbsp;Block Quotes</a></li>
+<li><a class="reference" href="#doctest-blocks" id="id40" name="id40">2.10&nbsp;&nbsp;&nbsp;Doctest Blocks</a></li>
+<li><a class="reference" href="#footnotes" id="id41" name="id41">2.11&nbsp;&nbsp;&nbsp;Footnotes</a></li>
+<li><a class="reference" href="#citations" id="id42" name="id42">2.12&nbsp;&nbsp;&nbsp;Citations</a></li>
+<li><a class="reference" href="#targets" id="id43" name="id43">2.13&nbsp;&nbsp;&nbsp;Targets</a><ul class="auto-toc">
+<li><a class="reference" href="#duplicate-target-names" id="id44" name="id44">2.13.1&nbsp;&nbsp;&nbsp;Duplicate Target Names</a></li>
+<li><a class="reference" href="#id18" id="id45" name="id45">2.13.2&nbsp;&nbsp;&nbsp;Duplicate Target Names</a></li>
</ul>
</li>
-<li><a class="reference" href="#directives" id="id45" name="id45">2.14&nbsp;&nbsp;&nbsp;Directives</a><ul class="auto-toc">
-<li><a class="reference" href="#document-parts" id="id46" name="id46">2.14.1&nbsp;&nbsp;&nbsp;Document Parts</a></li>
-<li><a class="reference" href="#images" id="id47" name="id47">2.14.2&nbsp;&nbsp;&nbsp;Images</a></li>
-<li><a class="reference" href="#admonitions" id="id48" name="id48">2.14.3&nbsp;&nbsp;&nbsp;Admonitions</a></li>
-<li><a class="reference" href="#topics-sidebars-and-rubrics" id="id49" name="id49">2.14.4&nbsp;&nbsp;&nbsp;Topics, Sidebars, and Rubrics</a></li>
-<li><a class="reference" href="#target-footnotes" id="id50" name="id50">2.14.5&nbsp;&nbsp;&nbsp;Target Footnotes</a></li>
-<li><a class="reference" href="#replacement-text" id="id51" name="id51">2.14.6&nbsp;&nbsp;&nbsp;Replacement Text</a></li>
-<li><a class="reference" href="#compound-paragraph" id="id52" name="id52">2.14.7&nbsp;&nbsp;&nbsp;Compound Paragraph</a></li>
+<li><a class="reference" href="#directives" id="id46" name="id46">2.14&nbsp;&nbsp;&nbsp;Directives</a><ul class="auto-toc">
+<li><a class="reference" href="#document-parts" id="id47" name="id47">2.14.1&nbsp;&nbsp;&nbsp;Document Parts</a></li>
+<li><a class="reference" href="#images" id="id48" name="id48">2.14.2&nbsp;&nbsp;&nbsp;Images</a></li>
+<li><a class="reference" href="#admonitions" id="id49" name="id49">2.14.3&nbsp;&nbsp;&nbsp;Admonitions</a></li>
+<li><a class="reference" href="#topics-sidebars-and-rubrics" id="id50" name="id50">2.14.4&nbsp;&nbsp;&nbsp;Topics, Sidebars, and Rubrics</a></li>
+<li><a class="reference" href="#target-footnotes" id="id51" name="id51">2.14.5&nbsp;&nbsp;&nbsp;Target Footnotes</a></li>
+<li><a class="reference" href="#replacement-text" id="id52" name="id52">2.14.6&nbsp;&nbsp;&nbsp;Replacement Text</a></li>
+<li><a class="reference" href="#compound-paragraph" id="id53" name="id53">2.14.7&nbsp;&nbsp;&nbsp;Compound Paragraph</a></li>
</ul>
</li>
-<li><a class="reference" href="#substitution-definitions" id="id53" name="id53">2.15&nbsp;&nbsp;&nbsp;Substitution Definitions</a></li>
-<li><a class="reference" href="#comments" id="id54" name="id54">2.16&nbsp;&nbsp;&nbsp;Comments</a></li>
-<li><a class="reference" href="#colspanning-tables" id="id55" name="id55">2.17&nbsp;&nbsp;&nbsp;Colspanning tables</a></li>
-<li><a class="reference" href="#rowspanning-tables" id="id56" name="id56">2.18&nbsp;&nbsp;&nbsp;Rowspanning tables</a></li>
-<li><a class="reference" href="#complex-tables" id="id57" name="id57">2.19&nbsp;&nbsp;&nbsp;Complex tables</a></li>
+<li><a class="reference" href="#substitution-definitions" id="id54" name="id54">2.15&nbsp;&nbsp;&nbsp;Substitution Definitions</a></li>
+<li><a class="reference" href="#comments" id="id55" name="id55">2.16&nbsp;&nbsp;&nbsp;Comments</a></li>
+<li><a class="reference" href="#colspanning-tables" id="id56" name="id56">2.17&nbsp;&nbsp;&nbsp;Colspanning tables</a></li>
+<li><a class="reference" href="#rowspanning-tables" id="id57" name="id57">2.18&nbsp;&nbsp;&nbsp;Rowspanning tables</a></li>
+<li><a class="reference" href="#complex-tables" id="id58" name="id58">2.19&nbsp;&nbsp;&nbsp;Complex tables</a></li>
</ul>
</li>
-<li><a class="reference" href="#error-handling" id="id58" name="id58">3&nbsp;&nbsp;&nbsp;Error Handling</a></li>
+<li><a class="reference" href="#error-handling" id="id59" name="id59">3&nbsp;&nbsp;&nbsp;Error Handling</a></li>
</ul>
</div>
<div class="section" id="structural-elements">
@@ -136,20 +137,24 @@ They are transformed from section titles after parsing. -->
<h2><a class="toc-backref" href="#id26" name="section-title">1.1&nbsp;&nbsp;&nbsp;Section Title</a></h2>
<p>That's it, the text just above this line.</p>
</div>
+<div class="section" id="empty-section">
+<h2><a class="toc-backref" href="#id27" name="empty-section">1.2&nbsp;&nbsp;&nbsp;Empty Section</a></h2>
+</div>
<div class="section" id="transitions">
-<h2><a class="toc-backref" href="#id27" name="transitions">1.2&nbsp;&nbsp;&nbsp;Transitions</a></h2>
+<h2><a class="toc-backref" href="#id28" name="transitions">1.3&nbsp;&nbsp;&nbsp;Transitions</a></h2>
<p>Here's a transition:</p>
<hr class="docutils" />
-<p>It divides the section.</p>
+<p>It divides the section. Transitions may also occur between sections:</p>
</div>
</div>
+<hr class="docutils" />
<div class="section" id="body-elements">
-<h1><a class="toc-backref" href="#id28" name="body-elements">2&nbsp;&nbsp;&nbsp;Body Elements</a></h1>
+<h1><a class="toc-backref" href="#id29" name="body-elements">2&nbsp;&nbsp;&nbsp;Body Elements</a></h1>
<div class="section" id="paragraphs">
-<h2><a class="toc-backref" href="#id29" name="paragraphs">2.1&nbsp;&nbsp;&nbsp;Paragraphs</a></h2>
+<h2><a class="toc-backref" href="#id30" name="paragraphs">2.1&nbsp;&nbsp;&nbsp;Paragraphs</a></h2>
<p>A paragraph.</p>
<div class="section" id="inline-markup">
-<h3><a class="toc-backref" href="#id30" name="inline-markup">2.1.1&nbsp;&nbsp;&nbsp;Inline Markup</a></h3>
+<h3><a class="toc-backref" href="#id31" 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="#id21" id="id22" name="id22">[5]</a>), internal
@@ -180,7 +185,7 @@ live link to PEP 258 here.</p>
</div>
</div>
<div class="section" id="bullet-lists">
-<h2><a class="toc-backref" href="#id31" name="bullet-lists">2.2&nbsp;&nbsp;&nbsp;Bullet Lists</a></h2>
+<h2><a class="toc-backref" href="#id32" name="bullet-lists">2.2&nbsp;&nbsp;&nbsp;Bullet Lists</a></h2>
<ul>
<li><p class="first">A bullet list</p>
<ul class="simple">
@@ -205,7 +210,7 @@ live link to PEP 258 here.</p>
</ul>
</div>
<div class="section" id="enumerated-lists">
-<h2><a class="toc-backref" href="#id32" name="enumerated-lists">2.3&nbsp;&nbsp;&nbsp;Enumerated Lists</a></h2>
+<h2><a class="toc-backref" href="#id33" 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">
@@ -238,7 +243,7 @@ live link to PEP 258 here.</p>
</ol>
</div>
<div class="section" id="definition-lists">
-<h2><a class="toc-backref" href="#id33" name="definition-lists">2.4&nbsp;&nbsp;&nbsp;Definition Lists</a></h2>
+<h2><a class="toc-backref" href="#id34" name="definition-lists">2.4&nbsp;&nbsp;&nbsp;Definition Lists</a></h2>
<dl class="docutils">
<dt>Term</dt>
<dd>Definition</dd>
@@ -253,7 +258,7 @@ live link to PEP 258 here.</p>
</dl>
</div>
<div class="section" id="field-lists">
-<h2><a class="toc-backref" href="#id34" name="field-lists">2.5&nbsp;&nbsp;&nbsp;Field Lists</a></h2>
+<h2><a class="toc-backref" href="#id35" 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" />
@@ -276,7 +281,7 @@ doesn't get stripped away.)</p>
</table>
</div>
<div class="section" id="option-lists">
-<h2><a class="toc-backref" href="#id35" name="option-lists">2.6&nbsp;&nbsp;&nbsp;Option Lists</a></h2>
+<h2><a class="toc-backref" href="#id36" 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" />
@@ -322,7 +327,7 @@ regardless of where it starts.</p>
description.</p>
</div>
<div class="section" id="literal-blocks">
-<h2><a class="toc-backref" href="#id36" name="literal-blocks">2.7&nbsp;&nbsp;&nbsp;Literal Blocks</a></h2>
+<h2><a class="toc-backref" href="#id37" 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">
@@ -339,7 +344,7 @@ if literal_block:
</pre>
</div>
<div class="section" id="line-blocks">
-<h2><a class="toc-backref" href="#id37" name="line-blocks">2.8&nbsp;&nbsp;&nbsp;Line Blocks</a></h2>
+<h2><a class="toc-backref" href="#id38" 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>
@@ -398,7 +403,7 @@ the left edge of the text above it.</div>
</blockquote>
</div>
<div class="section" id="block-quotes">
-<h2><a class="toc-backref" href="#id38" name="block-quotes">2.9&nbsp;&nbsp;&nbsp;Block Quotes</a></h2>
+<h2><a class="toc-backref" href="#id39" 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
@@ -410,7 +415,7 @@ own it, and what it is too.</p>
</blockquote>
</div>
<div class="section" id="doctest-blocks">
-<h2><a class="toc-backref" href="#id39" name="doctest-blocks">2.10&nbsp;&nbsp;&nbsp;Doctest Blocks</a></h2>
+<h2><a class="toc-backref" href="#id40" 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;
@@ -419,7 +424,7 @@ Python-specific usage examples; begun with &quot;&gt;&gt;&gt;&quot;
</pre>
</div>
<div class="section" id="footnotes">
-<h2><a class="toc-backref" href="#id40" name="footnotes">2.11&nbsp;&nbsp;&nbsp;Footnotes</a></h2>
+<h2><a class="toc-backref" href="#id41" name="footnotes">2.11&nbsp;&nbsp;&nbsp;Footnotes</a></h2>
<table class="docutils footnote" frame="void" id="id6" rules="none">
<colgroup><col class="label" /><col /></colgroup>
<tbody valign="top">
@@ -466,12 +471,12 @@ Here's a reference to the next footnote: <a class="footnote-reference" href="#id
<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="#id66" name="id67"><span class="problematic" id="id67">[5]_</span></a>.</td></tr>
+nonexistent footnote: <a href="#id67" name="id68"><span class="problematic" id="id68">[5]_</span></a>.</td></tr>
</tbody>
</table>
</div>
<div class="section" id="citations">
-<h2><a class="toc-backref" href="#id41" name="citations">2.12&nbsp;&nbsp;&nbsp;Citations</a></h2>
+<h2><a class="toc-backref" href="#id42" 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">
@@ -479,11 +484,11 @@ nonexistent footnote: <a href="#id66" name="id67"><span class="problematic" id="
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="#id68" name="id69"><span class="problematic" id="id69">[nonexistent]_</span></a>
+<p>Here's a reference to the above, <a class="citation-reference" href="#cit2002" id="id15" name="id15">[CIT2002]</a>, and a <a href="#id69" name="id70"><span class="problematic" id="id70">[nonexistent]_</span></a>
citation.</p>
</div>
<div class="section" id="targets">
-<h2><a class="toc-backref" href="#id42" name="targets">2.13&nbsp;&nbsp;&nbsp;Targets</a></h2>
+<h2><a class="toc-backref" href="#id43" name="targets">2.13&nbsp;&nbsp;&nbsp;Targets</a></h2>
<a class="target" id="example" name="example"></a><p>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>
@@ -493,45 +498,45 @@ hyperlink targets</a> are also possible.</p>
&quot;<a class="reference" href="http://www.python.org/">Python</a> <a class="footnote-reference" href="#id21" id="id23" name="id23">[5]</a>&quot;.</p>
<p>Targets may be indirect and anonymous. Thus <a class="reference" href="#targets">this phrase</a> may also
refer to the <a class="reference" href="#targets">Targets</a> section.</p>
-<p>Here's a <a href="#id70" name="id71"><span class="problematic" id="id71">`hyperlink reference without a target`_</span></a>, which generates an
+<p>Here's a <a href="#id71" name="id72"><span class="problematic" id="id72">`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="#id43" name="duplicate-target-names">2.13.1&nbsp;&nbsp;&nbsp;Duplicate Target Names</a></h3>
+<h3><a class="toc-backref" href="#id44" 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" id="id18">
-<h3><a class="toc-backref" href="#id44" name="id18">2.13.2&nbsp;&nbsp;&nbsp;Duplicate Target Names</a></h3>
+<h3><a class="toc-backref" href="#id45" name="id18">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="#id72" name="id73"><span class="problematic" id="id73">`Duplicate Target Names`_</span></a>), an error is generated.</p>
+this: <a href="#id73" name="id74"><span class="problematic" id="id74">`Duplicate Target Names`_</span></a>), an error is generated.</p>
</div>
</div>
<div class="section" id="directives">
-<h2><a class="toc-backref" href="#id45" name="directives">2.14&nbsp;&nbsp;&nbsp;Directives</a></h2>
+<h2><a class="toc-backref" href="#id46" name="directives">2.14&nbsp;&nbsp;&nbsp;Directives</a></h2>
<div class="contents topic" id="contents">
<ul class="auto-toc simple">
-<li><a class="reference" href="#document-parts" id="id59" name="id59">2.14.1&nbsp;&nbsp;&nbsp;Document Parts</a></li>
-<li><a class="reference" href="#images" id="id60" name="id60">2.14.2&nbsp;&nbsp;&nbsp;Images</a></li>
-<li><a class="reference" href="#admonitions" id="id61" name="id61">2.14.3&nbsp;&nbsp;&nbsp;Admonitions</a></li>
-<li><a class="reference" href="#topics-sidebars-and-rubrics" id="id62" name="id62">2.14.4&nbsp;&nbsp;&nbsp;Topics, Sidebars, and Rubrics</a></li>
-<li><a class="reference" href="#target-footnotes" id="id63" name="id63">2.14.5&nbsp;&nbsp;&nbsp;Target Footnotes</a></li>
-<li><a class="reference" href="#replacement-text" id="id64" name="id64">2.14.6&nbsp;&nbsp;&nbsp;Replacement Text</a></li>
-<li><a class="reference" href="#compound-paragraph" id="id65" name="id65">2.14.7&nbsp;&nbsp;&nbsp;Compound Paragraph</a></li>
+<li><a class="reference" href="#document-parts" id="id60" name="id60">2.14.1&nbsp;&nbsp;&nbsp;Document Parts</a></li>
+<li><a class="reference" href="#images" id="id61" name="id61">2.14.2&nbsp;&nbsp;&nbsp;Images</a></li>
+<li><a class="reference" href="#admonitions" id="id62" name="id62">2.14.3&nbsp;&nbsp;&nbsp;Admonitions</a></li>
+<li><a class="reference" href="#topics-sidebars-and-rubrics" id="id63" name="id63">2.14.4&nbsp;&nbsp;&nbsp;Topics, Sidebars, and Rubrics</a></li>
+<li><a class="reference" href="#target-footnotes" id="id64" name="id64">2.14.5&nbsp;&nbsp;&nbsp;Target Footnotes</a></li>
+<li><a class="reference" href="#replacement-text" id="id65" name="id65">2.14.6&nbsp;&nbsp;&nbsp;Replacement Text</a></li>
+<li><a class="reference" href="#compound-paragraph" id="id66" name="id66">2.14.7&nbsp;&nbsp;&nbsp;Compound Paragraph</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" id="document-parts">
-<h3><a class="toc-backref" href="#id59" name="document-parts">2.14.1&nbsp;&nbsp;&nbsp;Document Parts</a></h3>
+<h3><a class="toc-backref" href="#id60" 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" id="images">
-<h3><a class="toc-backref" href="#id60" name="images">2.14.2&nbsp;&nbsp;&nbsp;Images</a></h3>
+<h3><a class="toc-backref" href="#id61" name="images">2.14.2&nbsp;&nbsp;&nbsp;Images</a></h3>
<p>An image directive (also clickable -- a hyperlink reference):</p>
<p><a class="reference" href="#directives"><img alt="../../../docs/user/rst/images/title.png" src="../../../docs/user/rst/images/title.png" /></a></p>
<p>A figure directive:</p>
@@ -561,7 +566,7 @@ document (a document-wide <a class="reference" href="#table-of-contents">table o
</div>
</div>
<div class="section" id="admonitions">
-<h3><a class="toc-backref" href="#id61" name="admonitions">2.14.3&nbsp;&nbsp;&nbsp;Admonitions</a></h3>
+<h3><a class="toc-backref" href="#id62" 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>
@@ -610,7 +615,7 @@ Reader discretion is strongly advised.</p>
</div>
</div>
<div class="section" id="topics-sidebars-and-rubrics">
-<h3><a class="toc-backref" href="#id62" name="topics-sidebars-and-rubrics">2.14.4&nbsp;&nbsp;&nbsp;Topics, Sidebars, and Rubrics</a></h3>
+<h3><a class="toc-backref" href="#id63" 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>
@@ -627,7 +632,7 @@ background color.</p>
<p class="rubric">This is a rubric</p>
</div>
<div class="section" id="target-footnotes">
-<h3><a class="toc-backref" href="#id63" name="target-footnotes">2.14.5&nbsp;&nbsp;&nbsp;Target Footnotes</a></h3>
+<h3><a class="toc-backref" href="#id64" name="target-footnotes">2.14.5&nbsp;&nbsp;&nbsp;Target Footnotes</a></h3>
<table class="docutils footnote" frame="void" id="id21" rules="none">
<colgroup><col class="label" /><col /></colgroup>
<tbody valign="top">
@@ -636,11 +641,11 @@ background color.</p>
</table>
</div>
<div class="section" id="replacement-text">
-<h3><a class="toc-backref" href="#id64" name="replacement-text">2.14.6&nbsp;&nbsp;&nbsp;Replacement Text</a></h3>
+<h3><a class="toc-backref" href="#id65" 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="#id21" id="id24" name="id24">[5]</a>.</p>
</div>
<div class="section" id="compound-paragraph">
-<h3><a class="toc-backref" href="#id65" name="compound-paragraph">2.14.7&nbsp;&nbsp;&nbsp;Compound Paragraph</a></h3>
+<h3><a class="toc-backref" href="#id66" 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>
@@ -708,12 +713,12 @@ paragraph.</td>
</div>
</div>
<div class="section" id="substitution-definitions">
-<h2><a class="toc-backref" href="#id53" name="substitution-definitions">2.15&nbsp;&nbsp;&nbsp;Substitution Definitions</a></h2>
+<h2><a class="toc-backref" href="#id54" 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" id="comments">
-<h2><a class="toc-backref" href="#id54" name="comments">2.16&nbsp;&nbsp;&nbsp;Comments</a></h2>
+<h2><a class="toc-backref" href="#id55" 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
@@ -723,7 +728,7 @@ Double-dashes - - "- -" - - must be escaped somehow in HTML output. -->
<p>(View the HTML source to see the comment.)</p>
</div>
<div class="section" id="colspanning-tables">
-<h2><a class="toc-backref" href="#id55" name="colspanning-tables">2.17&nbsp;&nbsp;&nbsp;Colspanning tables</a></h2>
+<h2><a class="toc-backref" href="#id56" name="colspanning-tables">2.17&nbsp;&nbsp;&nbsp;Colspanning tables</a></h2>
<p>This table has a cell spanning two columns:</p>
<table border="1" class="docutils">
<colgroup>
@@ -761,7 +766,7 @@ Double-dashes - - "- -" - - must be escaped somehow in HTML output. -->
</table>
</div>
<div class="section" id="rowspanning-tables">
-<h2><a class="toc-backref" href="#id56" name="rowspanning-tables">2.18&nbsp;&nbsp;&nbsp;Rowspanning tables</a></h2>
+<h2><a class="toc-backref" href="#id57" name="rowspanning-tables">2.18&nbsp;&nbsp;&nbsp;Rowspanning tables</a></h2>
<p>Here's a table with cells spanning several rows:</p>
<table border="1" class="docutils">
<colgroup>
@@ -797,7 +802,7 @@ span rows.</td>
</table>
</div>
<div class="section" id="complex-tables">
-<h2><a class="toc-backref" href="#id57" name="complex-tables">2.19&nbsp;&nbsp;&nbsp;Complex tables</a></h2>
+<h2><a class="toc-backref" href="#id58" name="complex-tables">2.19&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>
@@ -847,7 +852,7 @@ empty: <tt class="docutils literal"><span class="pre">--&gt;</span></tt></td>
</div>
</div>
<div class="section" id="error-handling">
-<h1><a class="toc-backref" href="#id58" name="error-handling">3&nbsp;&nbsp;&nbsp;Error Handling</a></h1>
+<h1><a class="toc-backref" href="#id59" 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>
@@ -856,19 +861,19 @@ section, &quot;Docutils System Messages&quot;:</p>
<div class="system-messages section">
<h1><a>Docutils System Messages</a></h1>
<div class="system-message" id="id19">
-<p class="system-message-title">System Message: <a name="id19">ERROR/3</a> (<tt class="docutils">functional/input/data/standard.txt</tt>, line 89); <em><a href="#id20">backlink</a></em></p>
+<p class="system-message-title">System Message: <a name="id19">ERROR/3</a> (<tt class="docutils">functional/input/data/standard.txt</tt>, line 94); <em><a href="#id20">backlink</a></em></p>
Undefined substitution referenced: &quot;problematic&quot;.</div>
-<div class="system-message" id="id66">
-<p class="system-message-title">System Message: <a name="id66">ERROR/3</a> (<tt class="docutils">functional/input/standalone_rst_html4css1.txt</tt>, line 343); <em><a href="#id67">backlink</a></em></p>
+<div class="system-message" id="id67">
+<p class="system-message-title">System Message: <a name="id67">ERROR/3</a> (<tt class="docutils">functional/input/standalone_rst_html4css1.txt</tt>, line 348); <em><a href="#id68">backlink</a></em></p>
Unknown target name: &quot;5&quot;.</div>
-<div class="system-message" id="id68">
-<p class="system-message-title">System Message: <a name="id68">ERROR/3</a> (<tt class="docutils">functional/input/data/standard.txt</tt>, line 352); <em><a href="#id69">backlink</a></em></p>
+<div class="system-message" id="id69">
+<p class="system-message-title">System Message: <a name="id69">ERROR/3</a> (<tt class="docutils">functional/input/data/standard.txt</tt>, line 357); <em><a href="#id70">backlink</a></em></p>
Unknown target name: &quot;nonexistent&quot;.</div>
-<div class="system-message" id="id70">
-<p class="system-message-title">System Message: <a name="id70">ERROR/3</a> (<tt class="docutils">functional/input/data/standard.txt</tt>, line 377); <em><a href="#id71">backlink</a></em></p>
+<div class="system-message" id="id71">
+<p class="system-message-title">System Message: <a name="id71">ERROR/3</a> (<tt class="docutils">functional/input/data/standard.txt</tt>, line 382); <em><a href="#id72">backlink</a></em></p>
Unknown target name: &quot;hyperlink reference without a target&quot;.</div>
-<div class="system-message" id="id72">
-<p class="system-message-title">System Message: <a name="id72">ERROR/3</a> (<tt class="docutils">functional/input/data/standard.txt</tt>, line 390); <em><a href="#id73">backlink</a></em></p>
+<div class="system-message" id="id73">
+<p class="system-message-title">System Message: <a name="id73">ERROR/3</a> (<tt class="docutils">functional/input/data/standard.txt</tt>, line 395); <em><a href="#id74">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 5770de317..ed51f30ea 100644
--- a/docutils/test/functional/expected/standalone_rst_latex.tex
+++ b/docutils/test/functional/expected/standalone_rst_latex.tex
@@ -138,7 +138,9 @@ reStructuredText construct.
\begin{list}{}{}
\item {} \href{\#section-title}{1.1~~~Section Title}
-\item {} \href{\#transitions}{1.2~~~Transitions}
+\item {} \href{\#empty-section}{1.2~~~Empty Section}
+
+\item {} \href{\#transitions}{1.3~~~Transitions}
\end{list}
@@ -238,9 +240,16 @@ That's it, the text just above this line.
%___________________________________________________________________________
+\hypertarget{empty-section}{}
+\pdfbookmark[1]{1.2~~~Empty Section}{empty-section}
+\subsection*{1.2~~~Empty Section}
+
+
+%___________________________________________________________________________
+
\hypertarget{transitions}{}
-\pdfbookmark[1]{1.2~~~Transitions}{transitions}
-\subsection*{1.2~~~Transitions}
+\pdfbookmark[1]{1.3~~~Transitions}{transitions}
+\subsection*{1.3~~~Transitions}
Here's a transition:
@@ -249,7 +258,12 @@ Here's a transition:
\hspace*{\fill}\hrulefill\hspace*{\fill}
-It divides the section.
+It divides the section. Transitions may also occur between sections:
+
+
+%___________________________________________________________________________
+\hspace*{\fill}\hrulefill\hspace*{\fill}
+
%___________________________________________________________________________
diff --git a/docutils/test/functional/input/data/standard.txt b/docutils/test/functional/input/data/standard.txt
index fcf3c7ad8..a8d773242 100644
--- a/docutils/test/functional/input/data/standard.txt
+++ b/docutils/test/functional/input/data/standard.txt
@@ -64,6 +64,9 @@ Section Title
That's it, the text just above this line.
+Empty Section
+-------------
+
Transitions
-----------
@@ -71,7 +74,9 @@ Here's a transition:
---------
-It divides the section.
+It divides the section. Transitions may also occur between sections:
+
+---------
Body Elements
=============