davidbgk
/
larlet-fr-david
Beobachten 1
Favorisieren 0
Fork 0
Code Releases 0 Aktivität
Repository with sources and generator of https://larlet.fr/david/ https://larlet.fr/david/
Du kannst nicht mehr als 25 Themen auswählen Themen müssen mit entweder einem Buchstaben oder einer Ziffer beginnen. Sie können Bindestriche („-“) enthalten und bis zu 35 Zeichen lang sein.
244 Commits
1 Branch
Struktur: f16aada5e3
Branches Tags
${ item.name }
Erstelle Branch ${ searchTerm }
von „f16aada5e3“
${ noResults }
larlet-fr-david/david/biologeek/archives/20081204-la-documentation-d.../article.md

article.md 2.7KB
Originalformat Normale Ansicht Verlauf

Add initial content
vor 4 Jahren
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
 123456789101112131415161718192021222324252627282930313233343536 
  1. title:      La documentation Django en local (html et pdf)

  2. slug:       la-documentation-django-en-local-html-et-pdf

  3. date:       2008-12-04 15:34:19

  4. type:       thought

  5. vignette:   

  6. contextual_title1:  Interfaces et promotion du Web Sémantique

  7. contextual_url1:    20081203-interfaces-et-promotion-du-web-semantique

  8. contextual_title2:  24ways, le calendrier de l'Avent des geeks web

  9. contextual_url2:    20081201-24ways-le-calendrier-de-lavant-des-geeks-web

  10. contextual_title3:  Loi de Geek

  11. contextual_url3:    20081126-loi-de-geek

  12. 

  13. 

  14. 

  15. Le [billet de NiKo m'a rappelé que Glooze](http://prendreuncafe.com/blog/post/2008/12/04/Fayotage) voulait avoir un pdf de la documentation de Django, ça prend 3 minutes (ou 3 heures, ça dépend de votre connexion et de votre processeur).

  16. 

  17. ##Pré-requis

  18. 

  19. * installer [sphinx](http://sphinx.pocoo.org/) (easy_install sphinx ou avec votre méthode préférée) ;

  20. * installer latex (avec [MacTeX](http://tug.org/mactex/) ou avec [une bonne doc](http://www.valhalla.fr/2007/10/08/latex-sur-mac-installation/) si vous êtes sous mac, dans les deux cas c'est looooong).

  21. 

  22. Si vous êtes sous une distribution GNU/Linux ça devrait être plus rapide avec votre gestionnaire de paquets préféré, oui OS X a bien du retard à ce niveau là...

  23. 

  24. ## 3 étapes

  25. 

  26. * récupérer [les sources de Django](http://www.djangoproject.com/download/) et les décompresser ;

  27. * aller dans le dossier docs et lancer la commande sphinx-build appropriée, pour la version html : **sphinx-build . build_html**

  28. 

  29. * et pour la version pdf : **sphinx-build -b latex . build_latex**

  30. 

  31. * générer le pdf à partir du latex : **latex build_latex/django.tex django.pdf**

  32. 

  33. Et voilà, vous avez un pdf de la documentation Django qui fait 700 pages et qui n'est pas super bien mis en forme (notamment le code...) mais ça peut dépanner. Si vraiment ça vous passionne, vous pouvez faire votre propre feuille de styles qui s'applique lors de la conversion mais bon j'ai déjà du mal à voir un intérêt au pdf... la version html est beaucoup mieux !

  34. 

  35. À ce sujet, [Python 3 est sorti aujourd'hui](http://www.python.org/download/releases/3.0/), on va voir s'il est envisageable de sortir une version non compatible (nativement) avec la précédente sans tuer un langage, en tout cas les gros projets commencent à [définir des roadmaps](http://groups.google.com/group/django-developers/browse_thread/thread/dcf70c736c204594/a0686368119096b9). La migration est grandement facilitée par l'[utilitaire 2to3](http://docs.python.org/dev/3.0/library/2to3.html#to3-reference) et par les warnings affichés lors de l'utilisation de votre code avec Python 2.6, ça devrait pas être si terrible ;-).

  36.