在reStructuredText

时间:2015-10-15 12:55:57

标签: python-sphinx restructuredtext heading

是否有可能以某种方式跳过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 个答案:

答案 0 :(得分:2)

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

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

"另一段"在第24行,它被渲染为子标题,因为这是Sphinx在该位置所期望的。

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