Django文檔製作(Windows XP)

    大家好,我是成都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的)


發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章