Readthedocs/Sphinx不从rst文件呈现项目符号列表

我有一组 rst 文件,我正在使用 sphinx 在 readthedocs 中构建这些文件。这些文件有多个项目符号列表,但它们没有正确呈现。

文本出现,但没有项目符号或嵌套/缩进。

为了确保它不是我的文件,我从 sphinx_rtd_theme 页面(https://github.com/readthedocs/sphinx_rtd_theme/blob/b07560bf97dad3a4266f6145bd4b662ac708ab00/docs/desmo)直接复制粘贴。

这是 rst 应该呈现的内容(::marker对于 html 文件中的每个列表项)

这就是我使用本地 sphinx / rtd 设置构建相同的 rst 时得到的结果

在我的 conf.py 或其他文件中有什么我需要修复的吗?

回答

在刷新我们用于发布我们的一个软件包的 conda 环境后,我们遇到了同样的问题(列表中的项目符号消失)。此处列出的其他解决方案(到目前为止)对我不起作用,但降级docutils <0.17确实如此。

我们正在使用nbsphinx(我们的一些文档说明了笔记本的操作),并且最近由于相关的包版本(jinja2sphinxdocutils)而出现了一些问题。根据问题/评论(例如这个和那个),我们使用了这些软件包的各种旧版本。

但在撰写本文时,由于所有维护者的辛勤工作,我们能够移除除docutils. FWIW,对于我们当前的需求,我们使用的相关软件包子集是:

docutils                  0.16                     py38_1  
jinja2                    3.0.0              pyhd3eb1b0_0  
nbsphinx                  0.8.6              pyhd8ed1ab_1    conda-forge
sphinx                    4.0.1              pyhd3eb1b0_0  
sphinx_rtd_theme          0.4.3                      py_0  


以上是Readthedocs/Sphinx不从rst文件呈现项目符号列表的全部内容。
THE END
分享
二维码
< <上一篇
下一篇>>