Все создают тектри в первых файлах - PullRequest
Новая
       16

Все создают тектри в первых файлах

0 голосов
/ 22 марта 2019

У меня есть 2 первых файла: 

folder:
 |_file1.rst
 |_file2.rst

file1.rst: 

.. toctree::
   :maxdepth: 3


Name1
========

Name2
========

file2.rst: 

.. toctree::
   :maxdepth: 3


Name3
=========

Name4
=========

Как сделать так, чтобы в дереве сочетались заголовки из 1 и 2 файлов. и навигация была одинаковой в двух файлах

1 Ответ

0 голосов
/ 22 марта 2019

Мое понимание вашего вопроса состоит в том, что в настоящее время у вас есть два файла с их собственными "локальными" тектридами (которые ничего не делают случайно) и вы хотите третий документ, содержащий глобальные тектриды.Если это правильно, то вам просто нужно создать этот файл, указать его и указать, на какие документы ссылаться: 

.. toctree::
   :maxdepth: 2

   file1
   file2

Обратите внимание, что Sphinx заботится об уровне заголовков, а не самом документе., так как все ваши заголовки "toplevel", ваше глобальное toctree будет

  • Name1
  • Name2
  • Name3
  • Name4

не например,

  • file1
    • Name1
    • Name2
  • file2
    • Name3
    • Name4

Я не знаю, какой вы хотите, но если это последнее, вам нужно добавить в документ один заголовок «имя документа» верхнего уровня (обычно это заголовок, подчеркнутый и подчеркнутый, усилие по выделению текста невелико, так как это всего лишь один заголовок / строка, помеченная какпуть).

...