将次要页面放在TOC的正确位置上

Question

在我的狮身人面像文档中，我有一些次要的页面（当然）需要成为toctree的一部分，但我不能把它们列在正确的地方。

如果我的 "第3节 "页面看起来像这样。

.. toctree::
   3.3
   3.4

3
=====



3.1
-----


3.2
---

那么 3.3 和 3.4 被列入 之前 3.

我试过其他的组合，但似乎都不行。

1. 如果我把toctree放在 3 然后 3.3 和 3.4 被列入 之间 3 和 3.1.
2. 如果我把toctree放在页面的最后，一切都按正确的顺序排列，但是......。3.3 和 3.4 成为三级科室，是科室的子女 3.2.

---

我已经放了一个具体的例子，在这里。

• http:/sphinx-problem.readthedocs.orgenlatest。
• https:/github.combukzorsphinx-problem。

Answer 1

要获得正确的总体结构，你可以使用 包括指令 如下。

3
=====

3.1
-----

3.2
---

.. include:: 3_3.rst

.. include:: 3_4.rst

不过，也没有什么好办法让这些部分在同一页的toctree中列出。列出 self 将只显示第一层标题和直接的自引用--在您的例子中为 further-detail-1 - 将适用于html(虽然会引起警告)，但会把 latexpdf 构建。

作为一个变通办法，你可以简单地使用一个列表来硬编码你自己的toctree 参考文献.