我曾经在 readthedocs.io 服务器上保存一个项目文档。这是CoFEA Initiative 的链接
自 4 月 3 日以来,由于发布了新版本的 docutils 库,它看起来有点破损(例如,主徽标向左对齐,而它应该居中)。docutils 的最新版本是 0.17,这个特定的 Sphinx 主题在 0.16 版本之前工作得很好。
日志文件显示了它不工作的原因。首先,readthedocs服务器安装最新版本的docutils
Collecting docutils>=0.11
Downloading docutils-0.17-py2.py3-none-any.whl (575 kB)
Run Code Online (Sandbox Code Playgroud)
然后 Sphinx 主题尝试根据中定义的内容下载并安装特定版本的 docutilssetup.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
Run Code Online (Sandbox Code Playgroud)
我认为发生的情况是,当调用 Sphinx 命令时,它使用的是版本 0.17 而不是 0.16。
有没有办法强制为 Sphinx 使用 docutils 0.16 版本?