2016-08-23 7 views
2

Скажем, у меня есть следующий index.rst:сфинкс: список локальных разделов первой, связанные страницы последней в оглавлении

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

.. toctree:: 
    :glob: 

    nested/index 

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

И nested/index.rst:

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

Я хочу TOC быть похожим:

  • Некоторые глобальные темы
    • Глобальное введение темы
    • Некоторые подтема

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

  • Некоторые глобальные темы
    • Некоторые подтема
    • Global тема введение

Как сделать локальные разделы первыми и связаны с ними страницы после них?

+0

И, конечно, положить 'toctree' в нижней части страницы [заставляет это гнездо под введением] (http://stackoverflow.com/q/25276415/102441) вместо этого ... – Eric

+0

I ' ve сделал PR по этому поводу, но он не исправит ваш случай (нет ': hidden:' по выбору. Если вы хотите, чтобы это изменилось, сделайте аргумент в https://github.com/sphinx-doc/sphinx/pull/3622. – Eric

ответ

0

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

.. contents:: 
    :local: 

.. toctree::  
    :glob: 
    nested/index 

Это даст вам:

  • Некоторые глобальные темы
    • Глобальная тема Введение
  • Некоторые суб -topic
+0

Нет, это не понравится моей документации. Мой пример упрощен, на самом деле у меня многоуровневое вложение. Я думаю, что я получаю результат, похожий на ваш, просто вручную перечисляя документы в TOC верхнего уровня страницы и не был доволен им. – EugZol