Question

当我尝试手动构建文档或者通过推送到GitHub仓库触发构建时，我在readthedocs上收到以下错误：

python2.7 -mvirtualenv --no-site-packages --no-download /home/docs/checkouts/readthedocs.org/user_builds/my_project_name/envs/latest
New python executable in /home/docs/checkouts/readthedocs.org/user_builds/my_project_name/envs/latest/bin/python2.7
Traceback (most recent call last):
  File "/usr/lib/python2.7/runpy.py", line 162, in _run_module_as_main
    "__main__", fname, loader, pkg_name)
  File "/usr/lib/python2.7/runpy.py", line 72, in _run_code
    exec code in run_globals
  File "/usr/local/lib/python2.7/dist-packages/virtualenv.py", line 2328, in <module>
    main()
  File "/usr/local/lib/python2.7/dist-packages/virtualenv.py", line 713, in main
    symlink=options.symlink)
  File "/usr/local/lib/python2.7/dist-packages/virtualenv.py", line 925, in create_environment
    site_packages=site_packages, clear=clear, symlink=symlink))
  File "/usr/local/lib/python2.7/dist-packages/virtualenv.py", line 1231, in install_python
    shutil.copyfile(executable, py_executable)
  File "/usr/lib/python2.7/shutil.py", line 83, in copyfile
    with open(dst, 'wb') as fdst:
IOError: [Errno 40] Too many levels of symbolic links: '/home/docs/checkouts/readthedocs.org/user_builds/my_project_name/envs/latest/bin/python2.7'
Command time: 0s Return: 1

构建似乎自发地停止工作并恢复到之前工作的旧版本的文档没有帮助。我正在运行

sphinx-autobuild . _build_html

构建文档。

Answer 1

Oracle在jdk1.8.0_121中将javadoc编译器更加严格，这破坏了构建。

从发行说明：http://www.oracle.com/technetwork/java/javase/8u121-relnotes-3315208.html

javadoc工具现在将拒绝任何出现的JavaScript代码   javadoc文档注释和命令行选项，除非
指定了命令行选项--allow-script-in-comments
使用--allow-script-in-comments选项，javadoc工具将会   保留文档注释和命令行中的JavaScript代码   选项。如果JavaScript代码，javadoc工具将给出错误   找到并且未设置命令行选项。

JDK-8138725（不公开）

Answer 2

这个问题似乎是readthedocs.org在构建图像方面遇到的问题，并在此GitHub问题中进行了讨论

readthedocs.org GitHub issue #2640

readthedocs构建失败，但本地sphinx构建工作

2 个答案: