标题级别不一致是什么意思？ [英] What does "Title level inconsistent" mean?

问题描述

在我的文档构建中，我一直收到"标题级别不一致"的警告。据我所知，我有一个一致的结构，如下所示：

Big Title
=========

Section
-------

Subsection
~~~~~~~~~~

但该错误与我无法跟踪的自动生成(automodapi)文本相关联：

Classes
^^^^^^^

我如何才能找出"不一致"来自哪里？

推荐答案

显然答案很明显： http://sphinx-doc.org/rest.html#sections

# with overline, for parts
* with overline, for chapters
=, for sections
-, for subsections
^, for subsubsections
", for paragraphs

我一直使用====作为我的顶层标题，因为riv.vim就是这样做的，但####和****在它们上面。~~~~~显然不是官方的。

我仍然不完全理解这个问题，因为我在名义上使用^^^^的位置上使用了----，这应该可以，但将所有标题向上提升一个级别已经解决了我的特定问题。

这篇关于标题级别不一致是什么意思？的文章就介绍到这了，希望我们推荐的答案对大家有所帮助，也希望大家多多支持IT屋！