Date Tags Django

Afin de rentabiliser le temps que je perds dans les transports parisiens, et ayant envi de découvrir Django, me suis dit qu'il me faudrait bien la documentation de Django sur mon p'tit iPodTouch.

Donc je me suis farci le site http://www.djangoproject.com/ en long en large et en travers à la recherche d'un PDF, mais en vain.

En faisant une petite recherche sur google, je me jette sur un vieux billet de 2008, qui indique la marche à suivre pour ... se générer la documentation soi-même.

Ok, je vais pas m'arrêter là, suis motivé :-)

hop installation des outils easy_install et du support latex

apt-get install python-setuptools
apt-get install python-plastex
apt-get install python-sphinx
apt-get install texlive-full (necessaire sinon erreur à la compilation latex=>pdf)

Mais au moment de la compilation sur ma debian (5.0) via :

sphinx-build -b latex . build_latex

l'avion crash en plein vol ...

The process fails when it tries to do an import:
from sphinx.directives.desc import option_desc_re

Bon, pour ne pas passer pour un enquiquineur de première sur la ML django-fr, je m'en retourne voir google, et nouvelle trouvaille

J'apprends là bas qu'il faut une mise à jour issue tout droit du trunk django, et qui consiste donc à copier le fichier djangodocs.py en lieu et place de celle de la 1.2.1.... et rebuilder

Reste donc enfin à produire le pdf :)

latex build_latex/django.tex django.pdf

Et là miracle, ca repète :)

tex capacity exceeded, sorry [save=5000]

rebelote google tout çaaaaaaaaaaaa, on doit donc éditer

/usr/share/texmf/web2c/texmf.cnf

et changer la valeur de save_size

retestage :

latex build_latex/django.tex django.pdf
Output written on django.pdf (1032 pages, 5261614 bytes)

Aaaaaaaaaaaaah enfin je peux le transférer dans iBooks sur l'iPodTouch

Quel périple juste pour un PDF, gageons que la suite sera moins "rigolote" .

Ben en fait c'est pas génial :/ dans le PDF, le code écrit en noir sur fond noir ça le fait pas du tout.

EDIT : après un retour à la doc du projet lui même j'ai fini par faire plus simple et ça marche :

Donc on se rend dans le dossier "doc" et on tape juste :

make latex

puis

cd _build/latex
make all-pdf

pour obtenir

Output written on django.pdf (1057 pages ...)

et cette fois ci on a le code illustrant la doc tout à fait lisible :)

La Doc Django 1.2.1 en PDF est doc là :)

EDIT2 : c'est bien lisible dans iBooks :D à moi le mille feuilles dans le RER :-)


Comments

comments powered by Disqus