sphinx: размещайте второстепенные страницы в нужном месте в ТОС

Question

В моей документации по сфинксу у меня есть некоторые второстепенные страницы, которые (конечно) должны быть частью топа, но я не могу их перечислить в нужном месте ,

Если моя страница "раздела 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.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 

Тем не менее, нет хорошего способа, чтобы эти разделы были перечислены в токе на той же странице. Листинг self в toctree будет показывать только заголовок первого уровня и прямую саморегуляцию - в вашем примере до further-detail-1 - будет работать для html (хотя это вызовет предупреждение), но испортит сборку latexpdf.

В качестве обходного пути вы можете просто скопировать свой собственный указатель, используя список references.