无法以我想要的格式在 reStructuredtext (Sphinx/readthedocs) 中制作项目符号列表？

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的一个bug，目前被用作readthedocs的默认主题，所以你应该在它的github页面上填写一个问题。在此期间，您可以使用以下解决方案:

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

这里的坏事情是您必须手动编号枚举列表，而且项目列表的缩进也不是真正正确，但它可以工作并且使用sphinx_rtd_theme构建文档而没有错误。

或者你可以切换到另一个主题(例如default)，在那里这种类型的标记会被正确解析。