Question

我正在尝试在枚举列表中创建一个简单的嵌套项目符号列表。我有一个按数字顺序排列的列表，但是当我尝试在此列表中添加项目符号列表时，项目符号就是数字。看看：

我想要这个：

1. Sample 1
     * Sub bullet 1
     * Sub bullet 2
2. Sample 2
     * Sub bullet 1

在reStructuredtext中我做到了这一点：

#. Sample 1
     * ``sub bullet 1``
     * ``sub bullet 2``
#. Sample 2
     * ``sub bullet 1``

但是readthedocs的输出结果变为：

1. Sample 1
    1. Sub bullet 1
    2. Sub bullet 2
2. Sample 2
    1. Sub bullet 1

我做错了什么？我尝试使用缩进，前面和前面的空白行等，但无济于事。

Answer 1

这似乎是sphinx_rtd_theme中的一个错误，它目前被用作readthedocs的默认主题，所以你应该在它的github页面填写一个问题。在此期间，您可以使用此解决方法：

1. Sample 1

  * ``sub bullet 1``
  * ``sub bullet 2``

2. Sample 2

  * ``sub bullet 1``

这里的坏处是你必须手动编号你的枚举列表，子弹列表的缩进也不是真的正确，但它可以使用sphinx_rtd_theme工作和构建文档而没有错误。

或者您可以切换到正确解析此类标记的其他主题（例如默认）。