Можно ли смешивать внешние ссылки и включения в toctree (по заказу)?

Мне нужно включить содержимое страницы и некоторые внешние ссылки в 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


person super-qua    schedule 28.09.2016    source источник