在ReadTheDocs上构建Sphinx文档

Question

有办法让阅读docs.org为运行在googleappengine上的Django项目（托管在git上）构建一个基于sphinx的文档？在

我继续得到这个错误：

Sphinx Standard Error
The Google App Engine SDK could not be found!

我创建了以下需求文件：

^{pr2}$

但是ReadTheDocs无法解包googleappengine

Downloading/unpacking django (from -r docs/requirements.txt (line 1))
    Running setup.py egg_info for package django

Downloading/unpacking ez-setup (from -r docs/requirements.txt (line 2))
   Downloading ez_setup-0.9.tar.gz
   Running setup.py egg_info for package ez-setup

Downloading/unpacking google-appengine (from -r docs/requirements.txt (line 3))
   Running setup.py egg_info for package google-appengine
   Traceback (most recent call last):
       File "<string>", line 16, in <module>
       File  "/home/docs/checkouts/readthedocs.org/user_builds/****/envs/latest/build/google-appengine/setup.py", line 2, in <module>
       import ez_setup
   ImportError: No module named ez_setup
   Complete output from command python setup.py egg_info:
   Traceback (most recent call last):

File "<string>", line 16, in <module>

File "/home/docs/checkouts/readthedocs.org/user_builds/***/envs/latest/build/google-appengine/setup.py", line 2, in <module>

import ez_setup
ImportError: No module named ez_setup

Answer 1

ez_setup不是你通常依赖的东西。它是一个单独的ez_setup.py文件，以前它捆绑在setup.py旁边，以帮助那些没有安装setuptools（或distribute）的人。在你的设置.py大概是：

try:
    import setuptools
except Import Error:
    # run ez_setup

但是你使用的是virtualenv，现在你几乎可以指望人们拥有virtualenv/setuptools/distribute。因此您可以删除所有的ez_setup引用，特别是从您的requirements.txt中删除。在

我认为您正在安装的ez_setup模块干扰了appengine自己的setup.py中的某些内容。在