Sphinx:在注释部分之后恢复列表编号
Sphinx: Resume list numbering after a note section
考虑 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
部分之后继续编号列表吗?
列表的不连续性是由于 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。
考虑 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
部分之后继续编号列表吗?
列表的不连续性是由于 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。