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

Question

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

我想要这个:

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

在重构文本中我这样做了:

#. 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 没有错误。

或者您可以切换到另一个主题(例如默认主题)，在该主题中可以正确解析此类标记。