Génération automatique de documents html avec faq2html


Faq2html est un petit programme en Perl5 permettant de générer des fichiers html à partir d'articles archivés sur les sites FTP d'archives Usenet. Il utilise les modules MailTools que vous pouvez récupérer sur les archives CPAN (Comprehensive Perl Archive Network).

Ce programme utilise trois variables globales :

De plus, il utilise un expression régulière $donttranslate dans laquelle vous pouvez indiquer les noms de fichiers à ne pas transformer. Dans le fichier livré en exemple, on ne traduit la FAQ LATEX, ni les fichiers des répertoires 'minis-faq' et 'mini-faqs' puisqu'il s'agit d'erreurs de frappe dans l'Archive-Name, erreurs corrigées depuis (mais les fichiers subsistent sur les serveurs FTP d'archives). On peut spécifier les répertoires n'apparaissant pas dans l'index dans l'expression régulière $dontdisplay.

Enfin, il est possible de modifier le bas de page ajouté dans tous es articles transformés en modifiant la variable $footer, ainsi que le bas de page de l'index en modifiant la variable $footeridx.

Lorsque vous exécutez le fichier, il supprime le répertoire $htmldir, puis parcourt le répertoire $localdir récursivement, en transformant les fichiers trouvés. Il met les fichiers transformés dans le répertoire $htmldir en respectant la structure arborescente de l'archive des articles. A la fin de la transformation de tous les articles, le programme crée un index général répertoriant les articles traduits.

faq2html utilise aussi des feuillets de styles (CSS) stockés dans le répértoire styles/ et diferencie si un article est une charte (ou conseil d'utilisation) ou si c'est une FAQ. Les deux types de documents ayant des aspects differents, en HTML.

Si vous voulez récupérer le programme, allez ici.

Ce programme est ©opyright Sylvain Niervèze <sn@penelope.frmug.org>, 1998. Vous pouvez le distribuer selon les mêmes modalités que Perl lui-même, et vous êtes encouragé à m'envoyer les améliorations que vous pourriez lui apporter.

Raphaël Giromini et Benjamin Lerman ont apporté quelques corrections à ce programme de manière à ce que les FAQs soient au format XHTML 1.0-strict.


Valid XHTML 1.0! [Retour au Sommaire] Valid CSS!