Sphinx: Resume lista numeracja po sekcji uwaga

Question

Rozważmy następujący wykaz w ReStructuredText:

Broken list example 
------------------- 

#. First do spam 
#. Then do ``eggs`` 

    .. note:: 

    Nobody expects the Spanish Inquisistion 

#. The list restarts after the note 

Gdy lista jest skompilowany w Sphinx liczba po notatki zostaną przywrócone 1:

Każdy pomysł, jak kontynuować listę numerowaną po sekcji note?

Answer 1

Nieciągłość listy jest spowodowana tym, że note jest samodzielnym elementem, a nie dzieckiem drugiego elementu listy numerowanej. Aby zapobiec nieciągłości listy, należy rozpoczynać dyrektywę note z tym samym wcięciem (w tym przypadku 3 spacje), co tekst planowanego elementu listy numerowanej. Więc zamiast swojego próbki reStructuredText, spróbuj tego:

Fixed list example 
------------------ 

#. First do spam 
#. Then do ``eggs`` 

    .. note:: 

     Nobody expects the Spanish Inquisistion 

#. Then do spam and ``eggs``. 

Jest to jedna z tych rzeczy o reStructuredText że to ani łatwe do wykrycia, ani szczególnie dobrze udokumentowane; patrz this question on nested lists for a closely-related problem.