跳过 reStructuredText 中的标题级别

2023-12-19

是否可以通过某种方式跳过 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(使用前将#替换为@)

跳过 reStructuredText 中的标题级别 的相关文章

随机推荐