2010-02-03 14 views

Antwort

14

Djangos Dokumentation wird unter Verwendung von Sphinx und included in their source tree erstellt.

Führen Sie von einer ausgecheckten Kopie von Djangos Quelle einfach make im docs-Verzeichnis aus. Sie können eine Anleitung finden, um die Quelle hier zu erhalten: http://www.djangoproject.com/download/

+1

Ich bin nicht mit Linux. –

+1

Das 'Makefile' ist nur zur Bequemlichkeit da. Wenn Sie Sphinx installiert haben, können Sie einfach die ausführbare Datei 'sphinx-build' direkt dort aufrufen, wo Sie es machen würden. 'sphinx-build help' listet die Argumente auf, und Sie können das' Makefile' betrachten, um zu sehen, was Django verwenden würde: http: //code.djangoproject.com/browser/django/trunk/docs/Makefile –

+0

Du könntest auch immer Cygwin benutzen, aber ich nehme an, das ist nicht das was du machen willst;) –

1

"Okay, ich habe es nur manuell mit Sphinx-Build getan. Es war eine ziemlich schlechte Erfahrung."

Hmm. Ich habe es gerade versucht und es war eine ziemlich glatte Erfahrung (und ich habe das noch nie gemacht). Hier ist das Linux-Rezept:

  1. "cd" in das Verzeichnis, in dem Sie Ihre Django 1.2.x Download extrahiert wurde (in meinem Fall "~/downloads/Django-1.2.1")
  2. cd docs
  3. make Latex PAPER = a4
  4. cd _build/Latex
  5. machen all-pdf

Und das Endergebnis ist, 1000 Seiten-Wälzer von Django Güte!

+9

Eine "ziemlich glatte Erfahrung" wäre es, auf der Website von Django auf den Link "Download-Dokumentation" zu klicken. –

+0

Einverstanden. Warum poste das nicht als Anfrage an die Mailingliste oder an das Trackingsystem? – gamesbook

+1

Wenn Sie googlen: "django 1.2 documentation filetype: pdf" (so habe ich diesen Thread gefunden :)), dann ist es wahrscheinlich, dass Sie im Internet etwas finden (obwohl ich festgestellt habe, dass ich mich etwas umsehen musste). hier ist 1.2: http://pub.xupisco.net/django_docs-1.2.pdf – toast38coza

0

Um eine PDF-Version in Ubuntu zu erstellen, müssen Sie 700-900 MB Latex-Pakete herunterladen. Auch wenn Sie sich nicht in einem Entwicklungsland befinden, ist es hilfreich, eine lokale Kopie von Dokumenten zu führen. Nur für den Fall ist die Django-Website oder wenn Sie auf etwas verweisen müssen, während traveling.Django docs geschrieben in ReStructuredText (RST) und Sie müssen Sphinx-Tool HTML-Version http://sramana.github.com/dod/

14

Offline-Dokumentation für Django 1.2 erzeugen , 1.3 und 1.4 in verschiedenen Formaten:

http://readthedocs.org/projects/django/downloads/

+2

Es gibt einen direkten Link auf der docs.djangoproject.com Seitenleiste das letzte Mal, als ich es betrachtete! (und ein freundliches Zeichen von "zur Verfügung gestellt von Read The Docs") – alanjds

Verwandte Themen