如何使用rst2html创建适当的标题级别

Question

我不明白为什么：

H1: document title
##################

Sample H2
*********
Sample content.

导致：

<div class="document" id="h1-document-title">
<h1 class="title">H1: document title</h1>
<h2 class="subtitle" id="sample-h2">Sample H2</h2>

<p>Sample content.</p>
</div>

而

H1: document title
##################

Sample H2
*********
Sample content.

Sample H3
*********
Sample content.

结果：

<div class="document" id="h1-document-title">
<h1 class="title">H1: document title</h1>

<div class="section" id="sample-h2">
<h1>Sample H2</h1>
<p>Sample content.</p>
</div>
<div class="section" id="sample-h3">
<h1>Sample H3</h1>
<p>Sample content.</p>
</div>

即我不能有一个h1元素，后接多个h2。谢谢。

Answer 1

这是关于文档标题和副标题的解释。如果第一个标题的装饰在文档中是唯一的，则将其解释为文档标题。如果在第二个标题之后紧跟着另一个独特的装饰，则将其视为副标题。

请参见http://docutils.sourceforge.net/docs/user/rst/quickstart.html#document-title-subtitle。

示例：

Document title
##############

Subtitle
.........

Heading 1
*********
Sample content.

Heading 2
---------
Sample content.

Heading 3
---------
Sample content.

从该标记中，rst2html将生成具有以下标题的HTML：

• 文档标题：<h1>（居中）
• 字幕：<h2>（居中）
• 标题1：<h1>
• 标题2：<h2>
• 标题3：<h2>