1. Ramiro Morales
  2. libro-django-es-1.0

Overview

HTTPS SSH

El libro de Django, salida vía Sphinx

Author: Ramiro Morales

Version original

El original de este trabajo se mantiene en http://trac.usla.org.ar/proyectos/django-book y es el resultado del trabajo de la comunidad de usuarios Django de habla hispana y Python Argentina.

Objetivos

  • Generar una versión del libro que sea agradable de leer y que haga posible una navegación ágil del contenido.
  • No diverger con respecto al original en lo referente al conmtenido incorporando cambios y realimentando los cambios relevantes.
  • Explorar mejores prácticas para poder editar material del tipo libro usandoi una herramienta de alto nivel como Sphinx sin que ello signifique sacrificar calidad de salida LaTeX o HTML.

Estado

Se realizó un procesamiento automático (más de 890 adiciones) del texto reST del original para dotarlo de pistas semánticas que permiten, por ejemplo, que los bloques con código de ejemplo tengan resaltado de sintaxis en color y que los enlaces inter-capítulos sean "clickeables".

Ver las sección Tareas pendientes más abajo.

Requisitos

Y sus dependencias

Instrucciones

Generación de versión HTML:

$ make html
$ $WEB_BROWSER _build/html/index.html

Generación de versión PDF via LaTeX:

$ make latex
$ cd _build/latex
$ make all-pdf

Si se dispone de rst2pdf de Roberto Alsina, se puede obtener también una salida PDF directamente sin pasar por LaTeX:

$ make pdf

En el árbol hay un archivo rst2pdf-sphixn06-py25-pip-reqs.txt para usar con pip instal -r ... y que instala las dependencias de rst2pdf.

Tareas pendientes

  • Apéndice B, tabla B-5, Sphinx no soporta directivas de enlace dentro de tablas
  • Mejorar estilo de admonitions, en particular de admonitions genéricas (casi listo)
  • Agregar sistema de comentarios (ver si el proyecto GSoC '09 de Sphinx que iba a trabajar sobre este tema tuvo algun resultado concreto)

Contacto

Si tienes parches o sugerencias para mejorar o corregir este trabajo escríbeme a ramiro+djbook en rmorales punto net