Сфинкс: Возобновить нумерацию списка после заметки

Question

Рассмотрим следующий список в 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 раздел?

Answer 1

Прерывистость списка вызвана 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, которую не так просто обнаружить, и она не особенно хорошо документирована; см. этот вопрос во вложенных списках для тесно связанной проблемы.