Sfinge: Riprendi lista la numerazione dopo una sezione nota

Question

consideri l'elenco seguente in ReStructuredText:

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

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

    .. note:: 

    Nobody expects the Spanish Inquisistion 

#. The list restarts after the note 

Quando l'elenco viene compilato in Sphinx, il numero dopo la nota vengono resettati a 1:

Qualche idea su come continuare l'elenco numerato dopo una sezione note?

Answer 1

La discontinuità dell'elenco è causata dal fatto che lo note è un elemento autonomo, non un figlio del secondo elemento dell'elenco numerato. Per evitare la discontinuità dell'elenco, avviare la direttiva note alla stessa indentazione (in questo caso, 3 spazi) come testo dell'elemento di elenco numerato padre desiderato. Così, invece di tuo reStructuredText campione, provate questo:

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

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

    .. note:: 

     Nobody expects the Spanish Inquisistion 

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

Questa è una di quelle cose su reStructuredText che è né facile da individuare, né particolarmente ben documentati; vedi this question on nested lists for a closely-related problem.