Рассмотрим следующий список в ReStructuredText:
Broken list example
-------------------
#. First do spam
#. Then do ``eggs``
.. note::
Nobody expects the Spanish Inquisistion
#. The list restarts after the note
Когда список составляется в Sphinx, число после примечания сбрасывается на 1:
Есть идеи, как продолжить нумерованный список после раздела note?
Непрерывность списка вызвана тем, что note является отдельным элементом, а не дочерним элементом второго элемента нумерованного списка. Чтобы предотвратить прерывание списка, начните директиву note с того же отступа (в данном случае, 3 пробелов), что и текст предполагаемого родительского элемента нумерованного списка. Поэтому вместо вашего образца reStructuredText попробуйте следующее:
Fixed list example
------------------
#. First do spam
#. Then do ``eggs``
.. note::
Nobody expects the Spanish Inquisistion
#. Then do spam and ``eggs``.
Это одна из тех особенностей reStructuredText, которые нелегко заметить и не особенно хорошо задокументированы; см. этот вопрос о вложенных списках для тесно связанной проблемы .
