python-sphinx - 将小节添加到文档后如何升级？

Question

我有一个重组文本文档，其中有几个分层部分，例如：

Main title
##########

Text under the main title.

Sub-section
===========

Text under the sub-section.

这很好用，当我使用 Sphinx 编译它时，我得到了正确的 HTML 格式。

我的问题是：我怎样才能提高层次结构，以便在几个子部分之后添加更多文本？

例如：

Main title
##########

Text under the main title.

Sub-section
===========

Text under the sub-section.

In my CSS, sub-section is indented.
I want this paragraph to be rendered as part of the Main title section,
not the sub-section.

我基本上是在寻找一种提升层次结构的方法。

这可能吗？

谢谢！

Answer 1

如果不在您想要的级别开始新的部分，就不可能“向上”层次结构。文档部分结构不是这样工作的。章节级别的更改必须以相应的章节标题开头。使用缩进来表示类似节的结构只能在有限的局部范围内使用。

您所描述的不是小节，而是一个主题。Docutils 对此有一个指令：

.. topic:: title

   Topic text.

   May include multiple body elements (paragraphs, lists, etc.).

对于类似的结构，还有一个“侧边栏”指令，但通常用于偏旁的平行主题。“rubric”指令也可能很有趣。

有关详细信息，请参阅http://docutils.sourceforge.net/docs/ref/rst/directives.html。