Как разместить включенный первый контент из toctree после родительского контента в латексе Sphinx - PullRequest
0 голосов
/ 15 апреля 2020

Я пишу документацию sphinx для использования при генерации html и латекса.

Некоторые из моих rst файлов имеют следующую структуру:

My chapter title
=====================

.. toctree::
   :hidden:
   :maxdepth: 2

   folder/subchapter1
   folder/subchapter2


Chapter introduction
--------------------------
Brief introduction...

Это работает как положено в моем html выводе - но для моей сборки из латекса я получаю следующий порядок при построении моего pdf:

My chapter title
subchapter1
[contents of subchapter 1]
subchapter2
[contents of subchapter 2]
Chapter introduction
Brief introduction...

Предполагаемый порядок будет таким, как показано ниже:

My chapter title
Chapter introduction
Brief introduction...
subchapter1
[contents of subchapter 1]
subchapter2
[contents of subchapter 2]

Есть ли какой-нибудь способ сказать сфинксу через conf.py, что это должен быть порядок?

1 Ответ

0 голосов
/ 15 апреля 2020

Я обнаружил, что решением было просто переместить дерево вниз под содержимым.

...