如何在sphinx restructedtext中实现自动多级列表编号？

Question

如何在sphinx reStructuredText中实现自动多级列表编号？

假设文档中的某处有一个待办事项列表： （这里编号是手动的）

1. Do something #1

    1.1 Do something #2

        1.1.1 Do something #3

而且，后续PDF打印有要求是单个文档，页眉之间还可能有一些文字。

我尝试通过

toctree

来实现它，但我只从第三方文件中获得标题，并且以指向各个文档页面的链接的形式获得。

我尝试使用

content

- 但由于绑定到标题级别，无法获得本地部分的正常编号。

Answer 1

对自动编号列表使用标准 rST 语法：

#. Do something #1
    #. Do something #2
        #. Do something #3
#. Do somtething #4

您将生成一个自动编号的多级列表。输出中显示的数字取决于输出格式、作者和风格。 对于 HTML，自定义 CSS 计数器可用于获取“复合枚举器”，如手动示例中所示。 Docutils 的

rst2latex

带有

--compound-enumerators

命令行选项。