Sphinx: Резюме Нумерация списка после раздела нотой

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, что никогда ни легко обнаружить, ни особенно хорошо документированы; см. this question on nested lists for a closely-related problem.