python-sphinx - 在 reStructuredText 中跳过标题级别

Question

是否有可能以某种方式跳过 RestructuredText 中的标题级别？例如，给定

####
PART
####

*******
Chapter
*******

Section
=======

Subsection
----------

Subsubsection
^^^^^^^^^^^^

Paragraph
"""""""""

Another section
===============

Another Paragraph
"""""""""""""""""
The above heading seems to be rendered as a subsection-level heading...

最后一段被呈现为一个小节而不是一个段落。 (我使用 Sphinx 作为渲染器。)所以看起来节级检测是本地的，尽管 RestructuredText documentation说它应该是一致的:

All section title styles need not be used, nor need any specific section title style be used. However, a document must be consistent in its use of section titles: once a hierarchy of title styles is established, sections must use that hierarchy.

Answer 1

在问题中的文档上运行 Sphinx 1.3 时，会发出警告:

C:\path\to\test.rst:24: SEVERE: Title level inconsistent:

“另一段”在第 24 行，它被呈现为小节标题，因为这是 Sphinx 在该位置所期望的。

所以不，你不能跳过标题级别。这也是我如何解释问题中引用的关于一致性的段落的含义。