ReadTheDocs Sphinx 构建失败但在本地工作答案

【问题标题】：ReadTheDocs Sphinx Build Failing but working locallyReadTheDocs Sphinx 构建失败但在本地工作
【发布时间】：2018-03-10 05:21:42
【问题描述】：

正如标题所说，为我的包构建文档在本地可以正常工作，但不能在服务器上工作。我收到以下错误：

Traceback (most recent call last):   File "/home/docs/checkouts/readthedocs.org/user_builds/crbm/envs/latest/lib/python2.7/site-packages/sphinx/cmdline.py", line 295, in main
    opts.warningiserror, opts.tags, opts.verbosity, opts.jobs)   File "/home/docs/checkouts/readthedocs.org/user_builds/crbm/envs/latest/lib/python2.7/site-packages/sphinx/application.py", line 163, in __init__
    confoverrides or {}, self.tags)   File "/home/docs/checkouts/readthedocs.org/user_builds/crbm/envs/latest/lib/python2.7/site-packages/sphinx/config.py", line 134, in __init__
    execfile_(filename, config)   File "/home/docs/checkouts/readthedocs.org/user_builds/crbm/envs/latest/lib/python2.7/site-packages/sphinx/util/pycompat.py", line 129, in execfile_
    exec_(code, _globals)   File "/home/docs/checkouts/readthedocs.org/user_builds/crbm/envs/latest/lib/python2.7/site-packages/six.py", line 709, in exec_
    exec("""exec _code_ in _globs_, _locs_""")   File "<string>", line 1, in <module>   File "conf.py", line 23, in <module>
    import secomo   File "/home/docs/checkouts/readthedocs.org/user_builds/crbm/checkouts/latest/secomo/__init__.py", line 1, in <module>
    from .convRBM import CRBM   File "/home/docs/checkouts/readthedocs.org/user_builds/crbm/checkouts/latest/secomo/convRBM.py", line 2, in <module>
    import theano   File "/home/docs/checkouts/readthedocs.org/user_builds/crbm/envs/latest/lib/python2.7/site-packages/Theano-0.10.0b3-py2.7.egg/theano/__init__.py", line 110, in <module>
    from theano.compile import (   File "/home/docs/checkouts/readthedocs.org/user_builds/crbm/envs/latest/lib/python2.7/site-packages/Theano-0.10.0b3-py2.7.egg/theano/compile/__init__.py", line 12, in <module>
    from theano.compile.mode import *   File "/home/docs/checkouts/readthedocs.org/user_builds/crbm/envs/latest/lib/python2.7/site-packages/Theano-0.10.0b3-py2.7.egg/theano/compile/mode.py", line 11, in <module>
    import theano.gof.vm   File "/home/docs/checkouts/readthedocs.org/user_builds/crbm/envs/latest/lib/python2.7/site-packages/Theano-0.10.0b3-py2.7.egg/theano/gof/vm.py", line 673, in <module>
    from . import lazylinker_c   File "/home/docs/checkouts/readthedocs.org/user_builds/crbm/envs/latest/lib/python2.7/site-packages/Theano-0.10.0b3-py2.7.egg/theano/gof/lazylinker_c.py", line 127, in <module>
    preargs=args)   File "/home/docs/checkouts/readthedocs.org/user_builds/crbm/envs/latest/lib/python2.7/site-packages/Theano-0.10.0b3-py2.7.egg/theano/gof/cmodule.py", line 2353, in compile_str
    (status, compile_stderr.replace('\n', '. '))) Exception: Compilation failed (return status=1): /usr/bin/ld: /home/docs/.pyenv/versions/2.7.13/lib/libpython2.7.a(abstract.o): relocation R_X86_64_32S against `_Py_NotImplementedStruct' can not be used when making a shared object; recompile with -fPIC. /home/docs/.pyenv/versions/2.7.13/lib/libpython2.7.a: error adding symbols: Bad value. collect2: error: ld returned 1 exit status. 

Exception occurred:   File "/home/docs/checkouts/readthedocs.org/user_builds/crbm/envs/latest/lib/python2.7/site-packages/Theano-0.10.0b3-py2.7.egg/theano/gof/cmodule.py", line 2353, in compile_str
    (status, compile_stderr.replace('\n', '. '))) Exception: Compilation failed (return status=1): /usr/bin/ld: /home/docs/.pyenv/versions/2.7.13/lib/libpython2.7.a(abstract.o): relocation R_X86_64_32S against `_Py_NotImplementedStruct' can not be used when making a shared object; recompile with -fPIC. /home/docs/.pyenv/versions/2.7.13/lib/libpython2.7.a: error adding symbols: Bad value. collect2: error: ld returned 1 exit status. The full traceback has been saved in /tmp/sphinx-err-I1fypA.log, if you want to report the issue to the developers. Please also report this if it was a user error, so that a better error message can be provided next time. A bug report can be filed in the tracker at <https://github.com/sphinx-doc/sphinx/issues>. Thanks!

You can find the C code in this temporary file: /tmp/theano_compilation_error_JSxqVj

据我从this 帖子中了解，似乎 pyenv 中的 python 构建的某些标志是造成错误的原因。

由于同样的原因，Lasagne 构建似乎也是 failing 的事实支持了这一点。

但是，我能做些什么呢？这真的是 Theano 中的一个错误，还是与 readthedocs.org 的设置有关，并且他们没有使用 --enable-shared 标志编译 python？

谢谢！

罗马

【问题讨论】：

我搜索了 GitHub 存储库并找到了 appears to be a related issue 的内容。也许这会对你有所帮助？
我阅读了这个问题，但我们实际上根本不依赖 tensorflow（尽管 Theano 基本上在做同样的事情，并且 TF 已经取代了它）。而且我认为 Theano 实际上适用于 RTD。顺便提一句。为什么我的问题被否决了？只是好奇。

标签： python build theano python-sphinx read-the-docs

【解决方案1】：

好的，伙计们。

很抱歉，这似乎是 RTD 的问题。在我发布这个问题两个小时后，他们系统上的构建开始工作。抱歉，我真的不确定错误是在我这边还是 RTD 故障。

最好的，

罗马

【讨论】：