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是独立元素而不是第二个编号列表元素的子元素引起的。要防止列表不连续，请在同一缩进处（在本例中为3个空格）启动note指令作为预期父编号列表元素的文本。因此，请尝试以下方法，而不是您的示例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。