Dans un précédent article, je me posait la question du meilleur format à adopter pour une documentation. Les commentaires ont été assez nombreux et je vous en remercie. Créant mes documents majoritairement en Latex, j'ai opté comme première solution, la convertion de Latex en html. Les logiciels sont assez nombreux, et je doit vous dire que j'ai eu un peu de mal à trouvé un paquet qui fasse un peu le boulot tout seul.
A vrai dire, je ne l'ai pas trouvé, ou je n'arrivai pas a bien les paramétrer au niveau des options. Bref, j'allais abandonner de ce côté, ou du moins le remettre à plus tard quand je suis tombé sur cette page : http://jack.r.free.fr/index.php?lng=fr&page=makefile_latex.
Il propose sur ce site un Makefile que vous pouvez télécharger. Ce Makefile permet de convertir une source latex en dvi, postscript, pdf, texte et html en une ou plusieurs pages. Après téléchargement, il faudra le renommer Makefile. Il faudra ensuite éditer ce fichier pour adapter les variables DOC, IMAGEDIR, FINALDIR, LNG.
Fonctionnement
- make help
- Affiche l'aide
- make usage
- Affiche cette aide
- make dvi
- Génére un fichier dvi
- make ps
- Génére un fichier postscript pour imprimer
- make pdf
- Génére un fichier pdf
- make html
- Génére un fichier html unique
- make cuthtml
- Génére plusieurs fichiers html. Le principal est index.html
- make text
- Génére un fichier texte
- make clean
- Supprime tous les fichiers intermédiaires
- make proper
- Supprime tous les fichiers sauf les sources
- make all
- Génére toutes les sorties possibles (dvi, ps, pdf, html, cuthtml, text)
- make final
- Génére toutes les sorties possibles (dvi, ps, pdf, html, cuthtml, text) et les déplace dans le répertoire final
Licence
Ce logiciel est libre au sens de la 'GNU General Public License' (version 2) de la Free Software Foundation.
Seulement un début de solution
Pour l'instant le code généré est en HTML 4.0 et n'a pas de mise en forme particulière. Je vais essayer de le convertir avec tidy, qui pour l'instant me cause des problèmes au niveau des listings représentant des commandes, et de lui appliquer une mise en forme avec css qui sera un peu plus sympa.
En attendant, j'ai ici un bon début pour générer de la documentation en html sans trop de travail. J'essaierai les différentes solutions proposées plus tard.