【发布时间】：2021-07-01 01:54:11
【问题描述】：
我曾经在 readthedocs.io 服务器上保存一个项目文档。这是链接CoFEA Initiative
自 4 月 3 日以来，由于发布了新版本的 docutils 库，它看起来有点破损（例如，主徽标向左对齐，但应该居中）。 docutils 的最新版本是 0.17，这个特殊的 Sphinx 主题在 0.16 之前的版本中运行良好。
log file 显示了它为什么不起作用。首先，readthedocs服务器安装最新版本的docutils
Collecting docutils>=0.11
Downloading docutils-0.17-py2.py3-none-any.whl (575 kB)
然后 Sphinx 主题会尝试根据 setup.py 中定义的内容下载并安装特定版本的 docutils
Installed /home/docs/checkouts/readthedocs.org/user_builds/cofea/envs/latest/lib/python3.7/site-packages/ipygany-0.5.0-py3.7.egg
Searching for docutils==0.16
Reading https://pypi.org/simple/docutils/
Downloading https://files.pythonhosted.org/packages/81/44/8a15e45ffa96e6cf82956dd8d7af9e666357e16b0d93b253903475ee947f/docutils-0.16-py2.py3-none-any.whl#sha256=0c5b78adfbf7762415433f5515cd5c9e762339e23369dbe8000d84a4bf4ab3af
Best match: docutils 0.16
Processing docutils-0.16-py2.py3-none-any.whl
Installing docutils-0.16-py2.py3-none-any.whl to /home/docs/checkouts/readthedocs.org/user_builds/cofea/envs/latest/lib/python3.7/site-packages
我认为发生的情况是，当调用 Sphinx 命令时，它使用的是 0.17 版本而不是 0.16。
有没有办法强制对 Sphinx 使用 docutils 0.16 版本？
【问题讨论】：
-
您需要出示您的
setup.py、您的pyproject.toml、您的readthedocs.yaml等 -
@sinoroc 谢谢你回来找我。 setup.py 和 readthedocs.yaml 可以在github.com/spolanski/CoFEA 找到我之前没有看过 project.toml 文件，所以我需要检查一下
-
好的，不需要
pyproject.toml。但是你应该编辑你的问题以添加setup.py和.readthedocs.yml的内容，这样你就有了一个独立的问题。 -
我想我不明白这个问题。根据您所说的（通过链接的日志文件），docutils 0.16 是最后安装的，所以我猜这也是正在使用的这个版本。不？你确定最后导入的是0.17版本吗？您是否在本地尝试过进行比较？
-
对我来说令人惊讶的行为。我不明白为什么最后安装了 0.16 但导入了 0.17。 -- 或许可以尝试在
.readthedocs.yml中设置pip安装方法而不是setuptools。
标签： python-sphinx setup.py read-the-docs docutils