reStructuredText中的子节

Question

我正在尝试用reStructuredText编写一个文档，但目前遇到了一个问题。

我想让文档有一个标题，它将居中，然后紧接着我想要一个小节。

我试着做了以下事情

##############
Title
##############

+++++++++
Subtitle
+++++++++
content

但当我将其转换为PDF时，它使标题和副标题都居中。

Answer 1

从reStructuredText中，quick start guide标题和副标题指定如下(重点是我的)：

若要在reStructuredText中指示文档标题，请在文档开头使用唯一的装饰样式。若要指示文档副标题，请紧跟在文档标题之后使用另一种唯一的装饰样式。

因此，在问题中的reST示例中，Subtitle被格式化为副标题，而不是小节标题，因为文档中其他任何地方都不使用围绕Subtitle使用的装饰样式。在下面的示例中，此装饰在两个部分标题周围使用，因此不是唯一的，也不会被视为副标题：

##############
Document Title
##############

+++++++++++++++
Section 1 Title
+++++++++++++++

Section 1 content...

+++++++++++++++
Section 2 Title
+++++++++++++++

Section 2 content...

使用http://www.tele3.cz/jbar/rest/rest.html可以让您快速试用一些简单的reStructuredText，并测试字幕和章节标题等内容。

编辑：或者，您可以在标题和章节标题之间放置一些文本(例如，摘要)。

附注：我倾向于使用标题上面和下面的装饰来表示文档标题和副标题，在标题下面使用单个装饰来表示(子)部分标题。这使得我很容易看到我想要成为标题/副标题的内容。例如：

==============
Document title
==============
-----------------
Document subtitle
-----------------

Section
=======

Sub-section
-----------
etc.

Answer 2

我认为小节直接在小节标题下开始是很自然的，比如

我的东西

我的第一件事

..。

我的第二件事

..。

我通过反复试验发现的一种变通办法是将"\“(反斜杠-空格)作为空内容放在小节标题和子标题之间。对于rst2html，这可以在不引入任何不需要的空间的情况下达到预期的效果。