gpt4 book ai didi

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

转载 作者:行者123 更新时间:2023-12-04 12:07:15 25 4
gpt4 key购买 nike

我有一组 rst 文件,我正在使用 sphinx 在 readthedocs 中构建这些文件。这些文件有多个项目符号列表,但它们没有正确呈现。
文本出现,但没有项目符号或嵌套/缩进。
为了确保它不是我的文件,我从 sphinx_rtd_theme 页面( https://github.com/readthedocs/sphinx_rtd_theme/blob/b07560bf97dad3a4266f6145bd4b662ac708ab00/docs/demo/lists_tables.rst )直接复制粘贴
这是 rst 应该呈现的内容(对于 html 文件中的每个列表项,使用 ::marker)
enter image description here
这就是我使用本地 sphinx/rtd 设置构建相同的 rst 时得到的结果
enter image description here
在我的 conf.py 或其他文件中有什么我需要修复的吗?

最佳答案

在刷新我们用于发布我们的一个软件包的 conda 环境后,我们遇到了同样的问题(列表中的项目符号消失)。此处列出的其他解决方案(到目前为止)对我不起作用,但降级 docutils <0.17做过。
我们正在使用 nbsphinx (我们的一些文档说明了笔记本的操作),并且最近由于相关软件包版本( jinja2sphinxdocutils )而出现了一些问题。根据问题/评论(例如 this onethat one ),我们使用了这些软件包的各种旧版本。
但是在撰写本文时,由于所有维护者的辛勤工作,我们能够移除除 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

关于python-sphinx - Readthedocs/Sphinx 不从 rst 文件呈现项目符号列表,我们在Stack Overflow上找到一个类似的问题: https://stackoverflow.com/questions/67542699/

25 4 0
Copyright 2021 - 2024 cfsdn All Rights Reserved 蜀ICP备2022000587号
广告合作:1813099741@qq.com 6ren.com