2010-02-03 14 views

Odpowiedz

14

Dokumentacja Django jest tworzona przy użyciu Sphinx i included in their source tree.

Z wyewidencjonowanej kopii źródła Django, po prostu uruchom make w katalogu docs. Instrukcje dotyczące pobierania źródła można znaleźć tutaj: http://www.djangoproject.com/download/

+1

nie używam Linuksa. –

+1

Plik 'Makefile' jest dostępny tylko dla wygody. Jeśli masz zainstalowany Sphinx, możesz po prostu wywołać plik 'sphinx-build' bezpośrednio w miejscu, w którym chciałbyś dokonać. 'sphinx-build help' wyświetli listę argumentów, a możesz zajrzeć do' Makefile', aby zobaczyć, czego użyje Django: http: //code.djangoproject.com/browser/django/trunk/docs/Makefile –

+0

Zawsze możesz też użyć Cygwin, ale zakładam, że nie jest to coś, co chcesz zrobić;) –

1

"W porządku, zrobiłem to ręcznie, używając sphinx-build. To było naprawdę złe doświadczenie."

Hmm. Po prostu próbowałem i było to całkiem przyjemne doświadczenie (i nigdy wcześniej tego nie robiłem). Oto przepis Linux:

  1. "cd" do katalogu, gdzie Django 1.2.x pobieranie zostało wyodrębnione (w moim przypadku "~/Downloads/Django-1.2.1")
  2. cd docs
  3. make lateks PAPER = A4
  4. cd _build/lateks
  5. make all-PDF

A wynik końcowy jest 1000 strona tom Django dobroci!

+9

"Bardzo łatwe" byłoby kliknięcie linku "pobierz dokumentację" na stronie Django. –

+0

Uzgodnione. Dlaczego nie wysłać tego jako prośbę do listy mailingowej lub do systemu śledzenia? – gamesbook

+1

Jeśli google: "django 1.2 dokumentacja filetype: pdf" (tak znalazłem ten wątek :)) prawdopodobnie znajdziesz coś w Internecie (chociaż odkryłem, że muszę trochę się rozejrzeć). Oto 1.2: http://pub.xupisco.net/django_docs-1.2.pdf – toast38coza

0

Aby wygenerować wersję PDF w systemie Ubuntu, należy pobrać 700-900 MB pakietów Latex. Nawet jeśli nie jesteś w kraju rozwijającym się, posiadanie lokalnej kopii dokumentów jest przydatne. Tylko w przypadku, gdy strona Django jest wyłączony lub gdy trzeba odwołać się do czegoś podczas docs traveling.Django są napisane w reStructuredText (RST) i trzeba Sphinx narzędzie do generowania wersji HTML http://sramana.github.com/dod/

14

Offline Dokumentacja dla Django 1,2 , 1,3 i 1,4 w różnych formatach:

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

+2

Istnieje bezpośredni odsyłacz na pasku bocznym docs.djangoproject.com, kiedy ostatni raz na niego patrzyłem! (i uprzejmym znakiem "dostarczonym przez Read The Docs") – alanjds

Powiązane problemy