大家好,我是成都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的)
Django文档制作(Windows XP)