如何在Sphinx中使用自动编号创建嵌套列表？

Question

我正在使用Sphinx为Python程序编写文档。 我想创建一个有序列表，带有嵌套列表，并带有自动编号。

我想获得这样的东西：

  

这是一个编号列表

     

  
1. 这是列表中的第一项
  
2. 这是第二个      
     
   • 第二项有一个包含两个项目的嵌套列表
     
   • 这是嵌套列表的最后一项
     
  
3. 父列表继续第三项
  

如果我明确地使用数字作为编号列表，那么一切都很好。当我想使用自动编号时，问题就出现了，因为我想保持灵活性。列表很长，将来可能会改变，我不想在引入新项目时更改所有数字。

我尝试使用以下代码：

Here it follows a numbered list

#. This is the first item of the list
#. This is the second one

  * The second item has a nested list with two items
  * this is the last item of the nested list

#. The parent list continues with its third item

我得到的结果如下：

  

这是一个编号列表

     

  
1. 这是列表中的第一项
  

2. 这是第二个

        
     
   • 第二项有一个包含两个项目的嵌套列表
     
   • 这是嵌套列表的最后一项
     
        

0.1。父列表继续其第三个项目

[我必须为第3项添加一些字符，这里是一个点，或者stackoverflow中的markdown系统显示3！]

正如您可以看到嵌套列表从头开始重新编号后的编号。

Answer 1

您必须正确缩进嵌套项目符号列表的两项以匹配父项列表的文本，因此只需添加如下空格：

#. This is the first item of the list
#. This is the second one

   * The second item has a nested list with two items
   * this is the last item of the nested list

#. The parent list continues with its third item

完整解释here