Readthedocs使用过时的代码版本构建

时间:2018-01-29 15:24:32

标签: python python-sphinx read-the-docs

在Read-The-Docs中运行autodoc时,我的项目失败并出现此错误:

Compiling sources ...error: [Errno 2] No such file or directory: 'gfortran'

我已经了解到gfortran在RTDF中不可用,所以我想尝试避免在运行Sphinx时导致错误的命令 - 类似

if not 'sphinx' in sys.modules

,如this question中所述。

但是,当我想在RTFD上构建文档时,仍会出现错误。我甚至评论了包含命令的整行,但没有成功。显然,RTFD不会使用它应该构建的存储库分支中的当前代码,因为它仍然会从不在代码中的命令引发错误。我也尝试擦过版本,但没有帮助。

我真的不知道发生了什么事。 RTFD构建命令是

python3.5 -mvirtualenv --system-site-packages --no-download /home/docs/checkouts/readthedocs.org/user_builds/smuthi/envs/doc

python /home/docs/checkouts/readthedocs.org/user_builds/smuthi/envs/doc/bin/pip install --use-wheel --upgrade --cache-dir /home/docs/checkouts/readthedocs.org/user_builds/smuthi/.cache/pip -I Pygments==2.2.0 setuptools==37.0.0 docutils==0.13.1 mock==1.0.1 pillow==2.6.1 alabaster>=0.7,<0.8,!=0.7.5 commonmark==0.5.4 recommonmark==0.4.0 sphinx==1.6.5 sphinx-rtd-theme<0.3 readthedocs-sphinx-ext<0.6

install --exists-action=w --cache-dir /home/docs/checkouts/readthedocs.org/user_builds/smuthi/.cache/pip -rdocs/requirements.txt

我不知道这意味着什么,但它包含--use-wheelcache等内容。我的代码的早期版本确实在PyPi上有一个内置版本,但目前没有。

这可能是原因,即RTFD是从PyPi而不是从GitLab存储库安装的,是否使用旧轮子?

有没有人经历过类似的事情? 有没有人知道出了什么问题?

1 个答案:

答案 0 :(得分:0)

问题在于我将包本身放在docs/requirements.txt文件中,这样在构建时,包确实是从PyPi安装的。从需求中删除后,文档构建正确。