在ReadTheDocs上构建Sphinx文档

Question

有一种方法可以让readthedocs.org为在Google应用引擎上运行的Django项目（托管在git上）构建一个基于狮身人面像的文档？

我不断收到此错误：

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

我创建了以下要求文件：

django 
ez_setup 
google-appengine 

但ReadTheDocs失败拆包谷歌-AppEngine上

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）的用户。在你的setup.py会是这样的：

try: 
    import setuptools 
except Import Error: 
    # run ez_setup 

但是，你正在使用的virtualenv，您可以在具有的virtualenv/setuptools的人相当多数量/时下分发。因此，您可以删除所有ez_setup参考文献，特别是从您的requirements.txt。

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