Разделите содержание сфинкса на подразделы с подзаголовками
У меня есть главный документ Sphinx, который включает дочерние документы следующим образом:
.. toctree::
:maxdepth: 2
:numbered:
doc1
doc2
doc3
doc4
doc5
doc6
Я хотел бы разделить оглавление на части или подразделы, чтобы оно имело вид:
Part 1: Title of Part 1
<doc1 TOC>
<doc2 TOC>
Part 2: Title of Part 2
<doc3 TOC>
<doc4 TOC>
Part 3: Title of Part 3
<doc5 TOC>
<doc6 TOC>
Мой текущий подход заключается в создании псевдо-дочерних документов, которые перечисляют фактические документы в их оглавлении, например, "part1.rst" будет иметь:
.. toctree::
:maxdepth: 2
:numbered:
doc1
doc2
а затем в основном документе:
.. toctree::
:maxdepth: 3
:numbered:
part1
part2
part3
Проблема в том, что при нажатии на ссылку «part1» вы попадаете на страницу без реального содержимого («part1.rst»).
Есть ли другой подход?
В качестве альтернативы, есть ли способ подавить запись для "part1.rst" от создания ссылки на страницу?