2010-02-03 42 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/