Django的文档使用Sphinx构建,并且包含在其源代码树中。
从已检出的Django源代码副本中,在docs目录中运行make
即可。您可以在此处找到获取源代码的说明:http://www.djangoproject.com/download/
Makefile
只是为了方便而存在。如果您已安装了 Sphinx,可以直接在需要 make
的位置调用 sphinx-build
可执行文件。sphinx-build help
将列出参数,并且您可以查看 Makefile
以查看 Django 将使用哪些内容:http://code.djangoproject.com/browser/django/trunk/docs/Makefile - Michael GreeneDjango 1.2、1.3和1.4的离线文档,提供各种格式下载:
"好的,我刚才手动使用sphinx-build进行了操作。 这是一次非常糟糕的体验。"
嗯,我刚刚尝试过,这是一次非常顺畅的体验(而且我以前从未做过这个)。以下是Linux的步骤:
最终结果是一本1000页的Django指南!