Readthedocs 使用过时版本的代码构建
Readthedocs builds with outdated version of code
当在 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-wheel
和 cache
之类的东西。我的代码的早期版本确实在 PyPi 上构建了分发版,但当前版本没有。
这可能是原因吗,即 RTFD 是否从 PyPi 安装而不是从 GitLab 存储库安装,它是否使用旧轮子?
有没有人经历过类似的事情?
有人知道出了什么问题吗?
问题是我在 docs/requirements.txt
文件中有包本身,因此在构建时,包确实是从 PyPi 安装的。从需求中删除后,文档构建正确。
当在 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-wheel
和 cache
之类的东西。我的代码的早期版本确实在 PyPi 上构建了分发版,但当前版本没有。
这可能是原因吗,即 RTFD 是否从 PyPi 安装而不是从 GitLab 存储库安装,它是否使用旧轮子?
有没有人经历过类似的事情? 有人知道出了什么问题吗?
问题是我在 docs/requirements.txt
文件中有包本身,因此在构建时,包确实是从 PyPi 安装的。从需求中删除后,文档构建正确。