是否可以通过某种方式跳过 RestructedText 中的标题级别?例如,给定
####
PART
####
*******
Chapter
*******
Section
=======
Subsection
----------
Subsubsection
^^^^^^^^^^^^
Paragraph
"""""""""
Another section
===============
Another Paragraph
"""""""""""""""""
The above heading seems to be rendered as a subsection-level heading...
最后一段将呈现为小节而不是段落。 (我在用Sphinx http://sphinx-doc.org/作为渲染器。)所以看起来节级检测是本地的,尽管重构文本文档 http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#sections说它应该是一致的:
不需要使用所有章节标题样式,也不需要任何特定的
使用章节标题样式。但是,文件必须在以下方面保持一致:
它对章节标题的使用:一旦标题样式的层次结构是
建立后,各部分必须使用该层次结构。
在问题中的文档上运行 Sphinx 1.3 时,会发出警告:
C:\path\to\test.rst:24: SEVERE: Title level inconsistent:
“Another Paragraph”位于第 24 行,它被渲染为小节标题,因为这是 Sphinx 在该位置所期望的。
所以不,你不能跳过标题级别。这也是我如何解释问题中引用的关于一致性的段落的含义。
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系:hwhale#tublm.com(使用前将#替换为@)