python-sphinx - “Title level inconsistent”是什么意思？

Question

我的文档版本中出现“标题级别不一致”的警告。据我所知，我有一个类似的一致结构:

Big Title
=========

Section
-------

Subsection
~~~~~~~~~~

但是错误与我无法追踪的自动生成( automodapi)文本有关:

Classes
^^^^^^^

我如何找出“不一致”的来源？

Answer 1

显然答案很明显:
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就是这样做的，但是 ####和 ****在它们之上。 ~~~~~显然甚至不是官方的。

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