Локальные разделы указываются первыми, связанные страницы последними в оглавлении

Допустим, у меня есть следующие index.rst:

Some global topic
=====================

.. toctree::
  :glob:

  nested/index

Global topic introduction
------------------------

И nested/index.rst:

Some sub-topic
==============

Я хочу, чтобы TOC был таким:

  • Some global topic
    • Global topic introduction
    • Какая-то подтема

Вместо этого я получаю следующее:

  • Some global topic
    • Some sub-topic
    • Введение в глобальную тему

Как сделать так, чтобы сначала отображались локальные разделы, а после них страницы со ссылками?


python tableofcontents python-sphinx toctree restructuredtext
person EugZol    schedule 23.08.2016    source источник
comment
И, конечно же, размещение toctree внизу страницы заставляет это вкладываться во введение вместо этого...   -  person Eric    schedule 12.04.2017
comment
Я сделал PR по этому поводу, но это не исправит ваш случай (нет :hidden: по выбору. Если вы хотите, чтобы это изменилось, приведите аргумент на github.com/sphinx-doc/sphinx/pull/3622.   -  person Eric    schedule 12.04.2017

Ответы (1)


arrow_upward
0
arrow_downward

Это не идеальное решение, но как насчет

.. contents::
   :local:

.. toctree::       
   :glob:
    nested/index

Это даст вам:

  • Some global topic
    • Global topic introduction
  • Какая-то подтема
person Sascha    schedule 24.08.2016
comment
Нет, это не будет хорошо смотреться в моей документации. Мой пример упрощен, на самом деле у меня многоуровневая вложенность. Я думаю, что получал результат, аналогичный вашему, просто вручную перечисляя документы в оглавлении некоторых страниц верхнего уровня, и меня это не удовлетворило. - person EugZol; 24.08.2016