Мой индексный файл настроен так:
Doc Title
==============================
..toctree::
:maxdepth: 3
:numbered:
:caption: Contents
01_file1
01.3_file2
Если содержимое таким образом ...
01_file1.txt:
Level 1 section title
--------------------------------------------
Level 2 section title
............................................
Another Level 2 section title
............................................
и для 01.3_file2.txt:
A third Level 2 section title
............................................
Я ожидал бы этого, потому что Sphinx рассматривает все как один документ:
1. Level 1 section title
1.1 Level 2 section title
1.2 Another Level 2 section title
1.3 A third Level 2 section title
Но вместо этого я получаю это:
1. Level 1 section title
1.1 Level 2 section title
1.2 Another Level 2 section title
2. A third Level 2 section title
Я предполагаю, что это потому, что Sphinx (или, может быть, reST / Markdown?) Перезапускает неявные уровни заголовков с каждым новым текстовым файлом.Есть ли способ получить то, что я на самом деле хочу?
Цитирование reST документации ...
Вместо того, чтобы вводить фиксированное число и порядок заголовка разделастили оформления, порядок применения будет соответствовать порядку.Первый встреченный стиль будет самым внешним заголовком (например, HTML H1), второй стиль будет субтитром, третий будет субтитром и т. Д.