python-sphinx - 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 的事情之一，既不容易发现，也不是特别有据可查；有关密切相关的问题，请参阅嵌套列表上的这个问题。