Мне нужно включить содержимое страницы и некоторые внешние ссылки в toctree
документации по сфинксу в правильном порядке.
Предположим, это моя структура:
=======
Test
=======
.. toctree::
:hidden:
Test <http:://stackoverflow.com>
Some text
.. include page1.rst
.. include page2.rst
Тогда результирующее дерево
- Тест
- Страница 1
- Страница 2
Но мне нужно, чтобы это было
- Страница 1
- Страница 2
- Тест
Итак, мне нужен способ либо изменить порядок toctree, либо вручную добавить включенные страницы в toctree, что тоже будет хорошо.
Единственное «решение», которое я придумал на данный момент, это включить фиктивные документы. Но это приводит к не очень удобному пути навигации для пользователей.
Примечание. Этот вопрос частично связан с этим https://stackoverflow.com/questions/35659349/sphinx-place-minor-pages-in-the-right-place-in-the-toc/35672388#35672388