Venj的维基

在Windows下构建Django的本地文档总是一件麻烦事。不过有了Cygwin，一切都变得简单起来了。进行下面操作的前提是你已经安装了cygwin，并安装了开发包——比如make之流。

1. 首先去下载Setup Tools。记住，下载源码包，不要下载egg或exe；

2. 打开cygwin，cd到下载目录。如：/cygdrive/d/downloads/；解压缩之，cd进入解压缩出来的目录，执行：
python ./setup.py install

3. 然后你就有了easy_install这个超级方便的软件包安装工具了。运行：

easy_install Pygments docutils Sphinx

easy_install会自动安装上所有的依赖包。

4. 然后就是开始生成文档了：

cd Django-1.1.1/docs
make html

5. 等待片刻，你的本地Django HTML文档就乖乖的位于docs/_build/html目录下了。

6. 要构建CHM文档，只需运行：

make htmlhelp

如果你已经编译过HTML，那么，编译HTML HELP会非常快；然后去微软下载HTML Help Workshop。

安装完毕后，利用在_build/htmlhelp目录中的.HLP文件创建CHM就OK了。

• 下载我编译的Django文档的CHM文件（SkyDrive）