时间戳

首页 > 解决方案 > Sphinx 主题的 Docutils 依赖于 readthedocs

python-sphinx - Sphinx 主题的 Docutils 依赖于 readthedocs

问题描述

我曾经在 readthedocs.io 服务器上保存一个项目文档。这是链接CoFEA 倡议

自 4 月 3 日以来，由于发布了新版本的 docutils 库，它看起来有点破损（例如，主 logo 向左对齐，而它应该居中）。最新版本的 docutils 是 0.17，这个特殊的 Sphinx 主题在 0.16 版本之前可以正常工作。

日志文件显示了它为什么不工作。首先，readthedocs服务器安装最新版本的docutils

Collecting docutils>=0.11
  Downloading docutils-0.17-py2.py3-none-any.whl (575 kB)

然后 Sphinx 主题会尝试根据setup.py

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 版本？

标签： python-sphinxsetup.pyread-the-docsdocutils

解决方案

我有一个类似的问题：

错误：sphinx-rtd-theme 0.5.2 要求 docutils<0.17，但您将拥有不兼容的 docutils 0.17.1。

安装命令中的顺序为我解决了这个问题。此命令在安装 docutils 0.17 时失败：

pip3 install sphinx sphinx-rtd-theme

这个成功安装了 docutils 0.16：

pip3 install sphinx-rtd-theme sphinx

推荐阅读