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

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

folder:
 |_file1.rst
 |_file2.rst

file1.rst:

.. toctree::
   :maxdepth: 3


Name1
========

Name2
========

file2.rst:

.. toctree::
   :maxdepth: 3


Name3
=========

Name4
=========

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


python python-sphinx toctree
person markus    schedule 22.03.2019    source источник
comment
Ваши токтреи пусты. Директива toctree должна содержать по крайней мере одну запись (имя другого первого файла), чтобы быть полезной.   -  person mzjn    schedule 22.03.2019
comment
file1.rst .. toctree ::: maxdepth: 3 file2 file2.rst .. toctree ::: maxdepth: 3 file1 не работает   -  person markus    schedule 22.03.2019
comment
Обновите свой вопрос своим примером в своем комментарии. Комментарии не форматируют блоки кода.   -  person Steve Piercy    schedule 22.03.2019
comment
Каков именно ваш желаемый результат?   -  person SuperKogito    schedule 22.03.2019

Ответы (1)


arrow_upward
0
arrow_downward

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

.. toctree::
   :maxdepth: 2

   file1
   file2

Обратите внимание, что Sphinx заботится об уровне заголовков, а не о самом документе, поэтому, поскольку все ваши заголовки находятся на верхнем уровне, ваше глобальное дерево токтридов будет

  • Имя1
  • Имя2
  • Имя3
  • Имя4

не например

  • file1
    • Name1
    • Имя2
  • file2
    • Name3
    • Имя4

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

person Masklinn    schedule 22.03.2019
comment
У меня есть два файла с первым расширением. могу я как-то объединить их в тектри. например, что оба файла в навигации были имя1 имя2 имя3 имя4. - person markus; 22.03.2019
comment
Я действительно не понимаю вашу ситуацию / вариант использования, неясно, какие входы и выходы вы ожидаете, поэтому оказание помощи является сложной задачей. Если у вас есть два файла с одинаковыми названиями и вы создаете дерево токтри, связывающее оба, вы получите последовательность всех заголовков, например. с приведенным выше кодом и файлами, о которых вы мне сейчас рассказываете, у вас будет 8 записей в дереве toctree name1, name2, name3, name4, name1, name2, name3, name4; первые 4 ссылки на файл1 и последние 4 ссылки на файл2. - person Masklinn; 22.03.2019