Convertir du Latex en html : début de solution

Publié le 11 janvier 2011 par Free_culture

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.