在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中的某些內容。