是否有可能以某种方式跳过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说它应该是一致的:
不需要使用所有部分标题样式,也不需要任何特定的部分 部分标题样式使用。但是,文档必须一致 它使用节标题:一旦标题样式的层次结构是 已建立,部分必须使用该层次结构。
答案 0 :(得分:2)
在问题文档中运行Sphinx 1.3时,会发出警告:
C:\path\to\test.rst:24: SEVERE: Title level inconsistent:
"另一段"在第24行,它被渲染为子标题,因为这是Sphinx在该位置所期望的。
所以不,你不能跳过标题级别。这也是我如何解释关于问题中所引用的一致性的段落的含义。