獅身人面像：在TOC正確的地方發生輕微頁

Question

在我的獅身人面像的文檔，我（當然）需要是toctree的一部分，一些小的頁面，但我不能讓他們在正確的地方上市。

如果我的 「第3節」 頁面看起來像這樣：

.. toctree:: 
    3.3 
    3.4 

3 
===== 



3.1 
----- 


3.2 
--- 

然後3.3和3.43之前上市。

我試過其他排列，但沒有一個似乎工作。

1. 如果我把標題然後3.3和3.4列3和3.1之間的3後toctree。
2. 如果我把頁面放在頁面的最後，一切都按照正確的順序排列，但是3.3和3.4會成爲第三層段，第3.2段的子段。

---

我已經提出了一個具體的例子，在這裏：

• http://sphinx-problem.readthedocs.org/en/latest/
• https://github.com/bukzor/sphinx-problem

Answer 1

要獲得一般結構右側，您可以將用戶作爲include directive如下：

3 
===== 

3.1 
----- 

3.2 
--- 

.. include:: 3_3.rst 

.. include:: 3_4.rst 

儘管如此，還有就是在同一個頁面上toctree上市的這些部分沒有什麼好辦法。清單self在toctree將只顯示第一級標題和直接的自我參照 - 在你的榜樣，以further-detail-1 - 會爲HTML工作（儘管它會產生警告），但搞亂了latexpdf構建。

作爲一種解決方法，您可以使用references列表簡單地對自己的toctree進行硬編碼。