在 reStructuredText 中跳过标题级别

Posted 2023-04-14

【中文标题】在 reStructuredText 中跳过标题级别

【英文标题】：Skipping heading levels in reStructuredText

【发布时间】：2016-01-13 22:46:10

【问题描述】：

是否可以通过某种方式跳过 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 说它应该是一致的：

不需要使用所有章节标题样式，也不需要任何特定的 使用节标题样式。但是，文件必须一致 它对章节标题的使用：一旦标题样式的层次结构是 已建立，部分必须使用该层次结构。

【参考方案1】：

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

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

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

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