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

【问题标题】：readthedocs build failing but local sphinx build workingreadthedocs 构建失败，但本地 sphinx 构建工作
【发布时间】：2017-02-14 02:36:02
【问题描述】：

当我尝试手动构建文档或通过推送到 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

构建文档。

【问题讨论】：

标签： github python-sphinx read-the-docs

【解决方案1】：

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

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

javadoc 工具现在将拒绝在 javadoc 文档 cmets 和命令行选项，除非指定了命令行选项 --allow-script-in-cmets。

使用 --allow-script-in-cmets 选项，javadoc 工具将在文档 cmets 和命令行中保留 JavaScript 代码选项。如果 JavaScript 代码，javadoc 工具将给出错误已找到且未设置命令行选项。

JDK-8138725（不公开）

【讨论】：

【解决方案2】：

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

readthedocs.org GitHub issue #2640

【讨论】：