Django文檔製作(Windows XP)

標籤：django文檔   django文檔make   django文檔製作   

    大家好，我是成都ld,最近學習了下python和Django。我使用的是pydev+eclipse的組合進行的開發，當然，剛開始學習，由於python的方法傳回值是沒有標明的，所以開發變得有些蛋疼，不得不去查看方法的源碼，不知道其他朋友是如何乾的~~

    言歸正傳，今天主要介紹Django文檔製作，網上說了很多方法，其實我也只是摸著石頭過河，完全自己琢磨，走一步看一步,也不知道對不對，文檔做出來了，暫時就這樣吧~~。

    第一步：首先我下載的是django的1.6.5的版本，django的目錄裡面有個docs的目錄，我滿心歡喜的以為這裡面就是django的文檔，對，的確是文檔，但是需要自己make~~~

    第二步: 在CMD下執行docs目錄裡面的make.bat，根據提示，執行make.bat html。OK，第一個錯誤出來，缺少Sphinx-build。

    第三步: 那就下載一個Sphinx，這裡有個小插曲，不知道咋回事在哪下載了個Sphinx1.1的版本。於是開始安裝Sphinx1.1，安裝好了之後，重複第二步，錯誤依然是缺少Sphinx-build。

    第四步: 我就納悶了，不是才安裝了嗎，於是我就懷疑是不是環境變數沒設定好，導致找不到Sphinx-build。在環境變數中添加：Path = python安裝目錄/Scripts。重複第二步，OK，perfect，問題解決。但是又出現新的問題：執行過程中缺少sphinx model

    第五步: 於是乎，我嘗試著將Sphinx目錄中的sphinx package拷到python的lib目錄下。重複第二步，OK，第四步問題解決，但是新的問題出現：node.py檔案夾裡面的某個方法，錯誤的意思是：某個參數沒有某個方法，大概是這個意思，具體的錯誤我沒。我猜想可能是Sphinx版本不對。

    第六步：我就繼續百度：Sphinx python發現個Sphinx1.2.2的版本，然後安裝之後，重複第二步，錯誤解決，在docs的目錄_build目錄中已經產生HTML文檔~~~

我將Django1.6.5 html協助文檔壓縮包上傳到百度文庫，歡迎大家下載：

http://pan.baidu.com/s/1jG1d3b4(這個是singlehtml參數make的，不用解釋大家應該很明白)

http://pan.baidu.com/s/1pJAwGqf（這個是html參數make的）

本文出自 “好學、善思” 部落格，請務必保留此出處http://porterxie.blog.51cto.com/1787765/1532457