2010-02-03 14 views

回答

14

Django的文档是使用Sphinxincluded in their source tree构建的。

从Django源代码的签出副本中,在docs目录中运行make。您可以在这里找到获取源代码的说明:http://www.djangoproject.com/download/

+1

我没有使用Linux操作系统。 – 2010-02-03 20:44:25

+1

'Makefile'只是为了方便。如果你安装了Sphinx,你可以直接调用'sphinx-build'可执行文件。 'sphinx-build help'会列出参数,你可以看一下'Makefile'来查看Django会使用什么:http://code.djangoproject。com/browser/django/trunk/docs/Makefile – 2010-02-03 20:49:57

+0

另外,你总是可以使用Cygwin,但我认为这不是你想要做的;) – 2010-02-03 20:50:32

1

“好吧,我只是用sphinx-build手动完成的,这是一个非常糟糕的经历。”

嗯。我只是尝试过,这是一个非常顺利的经历(我从来没有这样做过)。下面是Linux的食谱:

  1. “CD” 到你的Django 1.2.x的下载已经被提取(在我的情况 “〜/下载/ Django的1.2.1”)
  2. CD文档
  3. 目录
  4. 化妆乳胶纸= A4
  5. CD _build /乳胶
  6. 使所有-PDF

而最终的结果是Django的善良的1000页的大部头!

+9

“非常流畅的体验”将是在Django网站上点击“下载文档”链接。 – 2010-08-13 09:52:34

+0

同意。为什么不把它作为请求发送到邮件列表或跟踪系统? – gamesbook 2010-09-03 10:36:05

+1

如果你google:“django 1.2 documentation filetype:pdf”(这就是我发现这个主题:)),你很可能会在网上找到一些东西(尽管我发现我确实需要环顾一下)。 这里是1.2:http://pub.xupisco.net/django_docs-1.2.pdf – toast38coza 2010-12-09 14:26:36

0

要在Ubuntu中生成PDF版本,您需要下载700-900 MB的Latex软件包。 即使您不在发展中国家,保留文档的本地副本也很有用。万一Django的网站关闭或当你需要参考的东西,而traveling.Django文档都写在的ReStructuredText(RST),你需要狮身人面像工具来生成HTML版本 http://sramana.github.com/dod/