大家好，我是成都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