logo标签列表

我该在哪里下载Django文档？

pythondjangodocumentation
24

Django网站看起来不错，但出于某些原因我找不到下载文档的地方：

http://docs.djangoproject.com/en/1.1/

（是的，我需要1.1版本的文档）

有人知道在哪里吗？

3
https://readthedocs.org/projects/django/downloads/ - fmalina
右侧边栏底部的 https://docs.djangoproject.com/en/stable - maciek
6个回答
20
3
Makefile 只是为了方便而存在。如果您已安装了 Sphinx，可以直接在需要 make 的位置调用 sphinx-build 可执行文件。sphinx-build help 将列出参数，并且您可以查看 Makefile 以查看 Django 将使用哪些内容：http://code.djangoproject.com/browser/django/trunk/docs/Makefile - Michael Greene
另外，您始终可以使用Cygwin，但我假设那不是您想要做的;) - Michael Greene
1
好的，我刚刚使用sphinx-build手动完成了它。这是一个非常糟糕的体验。（我不得不弄清楚makefile的工作原理，那里似乎有一个小错误，我设法修复了它。）我只想说，我认为这样做以获取离线文档副本并不是很符合Pythonic的风格。我希望有人能提供更好的解决方案。 - Ram Rachum
请注意，在Django 1.3中，Windows默认的“make html”会失败，因为Makefile似乎没有为文档指定源目录；您可以使用“sphinx-build . _build”来生成默认文档。 - Gnudiff
Cygwin默认安装不包括“make”...是的，你可以添加它，但如果涉及安装整个C语言，这将严重膨胀你的Cygwin文件（例如1+ GB）...似乎有点疯狂，只是为了创建文档。尽管如此，这很遗憾：我总是喜欢从源代码生成我的离线文档。在Windows上，我建议使用maciek的解决方案。 - mike rodent
显示剩余2条评论
18
2
我上次查看docs.djangoproject.com时，侧边栏上直接提供了一个链接！（并且友善地标注了“由Read The Docs提供”） - alanjds
这个版本很糟糕，一个16MB的HTML文件需要加载很长时间。@maciek的回答下载了一个更好的（原始的）（非计算机解析和重新生成的版本）。 - run_the_race
9
链接是404。 - run_the_race
4
我在Django官网上找不到，非常感谢！我在ReadtheDocs上找到的版本是一个16MB的巨大HTML文件，需要很长时间才能加载，这个版本非常完美！ - run_the_race
2

"好的，我刚才手动使用sphinx-build进行了操作。 这是一次非常糟糕的体验。"

嗯，我刚刚尝试过，这是一次非常顺畅的体验（而且我以前从未做过这个）。以下是Linux的步骤：

  1. 进入已提取Django 1.2.x下载文件的目录（在我的情况下为“〜/downloads/Django-1.2.1”）
  2. cd 到 docs 目录
  3. 运行 make latex PAPER=a4 命令
  4. cd 到 _build/latex 目录
  5. 运行 make all-pdf 命令

最终结果是一本1000页的Django指南！

10
在 Django 的网站上，点击“下载文档”链接将会是一个“相当顺畅的体验”。 - Ram Rachum
同意。为什么不将此作为请求发布到邮件列表或跟踪系统上呢？ - gamesbook
1
如果你谷歌搜索：“django 1.2文档 filetype:pdf”（这就是我找到这个帖子的方法：）），你很可能会在互联网上找到一些东西（虽然我发现我确实需要多找一些）。这里是1.2版本的链接：http://pub.xupisco.net/django_docs-1.2.pdf。 - toast38coza
1
在Ubuntu中生成PDF版本，您需要下载700-900 MB的Latex软件包。即使您不在发展中国家，保留文档的本地副本也很有用。以防Django网站宕机或旅行时需要参考某些内容。Django文档是用ReStructuredText（RST）编写的，您需要Sphinx工具来生成HTML版本。http://sramana.github.com/dod/
网页内容由stack overflow 提供, 点击上面的
可以查看英文原文，
原文链接