2010-02-03 23 views

Respuesta

14

La documentación de Django se genera utilizando Sphinx y included in their source tree.

A partir de una copia extraída de la fuente de Django, simplemente ejecute make en el directorio de documentos. Puede encontrar instrucciones para obtener la fuente aquí: http://www.djangoproject.com/download/

+1

No estoy usando Linux. –

+1

El 'Makefile' solo está ahí por conveniencia. Si tiene instalado Sphinx, puede invocar el ejecutable 'sphinx-build' directamente donde lo haría. 'sphinx-build help' listará los argumentos, y puedes mirar el' Makefile' para ver lo que Django usaría: http: //code.djangoproject.com/browser/django/trunk/docs/Makefile –

+0

Además, siempre puedes usar Cygwin, pero supongo que eso no es lo que quieres hacer;) –

1

"De acuerdo, lo hice manualmente con sphinx-build. Fue una experiencia bastante mala".

Hmm. Lo intenté y fue una experiencia bastante fluida (y nunca he hecho esto antes). Aquí está la receta de Linux:

  1. "cd" al directorio donde se ha extraído de su 1.2.x descarga Django (en mi caso "~/descargas/Django-1.2.1")
  2. cd docs
  3. PAPEL látex maquillaje = a4
  4. cd _build/látex
  5. hacer todo pdf

Y el resultado final es de 1000 páginas tomo de Django bondad!

+9

Una "experiencia bastante fluida" sería hacer clic en el enlace "descargar documentación" en el sitio web de Django. –

+0

De acuerdo. ¿Por qué no publicar esto como una solicitud en la lista de correo o en el sistema de seguimiento? – gamesbook

+1

Si busca en google: "django 1.2 documentation filetype: pdf" (así es como encontré este hilo :)) es muy probable que encuentre algo en internet (aunque descubrí que necesitaba mirar un poco). aquí está 1.2: http://pub.xupisco.net/django_docs-1.2.pdf – toast38coza

0

Para generar una versión de PDF en Ubuntu, necesita descargar 700-900 MB de paquetes de látex. Incluso si no se encuentra en un país en desarrollo, es útil mantener una copia local de los documentos. Por si acaso el sitio Django está inactivo o cuando se necesita hacer referencia a algo mientras docs traveling.Django están escritos en reStructuredText (RST) y necesita herramienta para generar Sphinx versión HTML http://sramana.github.com/dod/

14

Desconectado La documentación de Django 1.2 , 1.3 y 1.4 en varios formatos:

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

+2

¡Hay un enlace directo en la barra lateral de docs.djangoproject.com la última vez que lo miré! (y una bondadosa marca de "proporcionada por Read The Docs") – alanjds

Cuestiones relacionadas