Skip to main content
 首页 » 编程设计

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

2025年05月04日11powertoolsteam

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

我想要这个:

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 

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

请您参考如下方法:

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

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

这里的坏处是您必须手动为您的枚举列表编号,而且项目符号列表的缩进并不是真正正确,但它可以正常工作并构建文档,而 sphinx_rtd_theme 没有错误。

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