5.4 Les filtres

Les filtres, ou convertisseurs, permettent de traduire un document en HTML. Ils permettent, d'une part, la récupération des documents existant déjà dans un certain format, et, d'autre part, l'utilisation de logiciels de traitement de texte évolués pour écrire un document destiné à être mis en ligne sur un serveur W3. Vous pouvez également consulter le document de référence sur le serveur du CERN.

5.4.1 LaTeX vers HTML

LaTeX2HTML est un convertisseur de textes écrits en LaTeX vers HTML. C'est lui qui a été utilisé pour l'obtention d'une version HTML du présent article.

Ses principales fonctionnalités sont les suivantes :

• la création d'un fichier HTML par section, sous-section... la profondeur est personnalisable ;
• la navigation par page à l'aide d'icônes ;
• la traduction des footnotes, figures ...
• l'introduction de commandes de traductions conditionnelles (latexonly pour ne pas traduire en HTML, rawhtml pour que LaTeX ne génère pas de DVI) ;
• ...

LaTeX2HTML permet de diffuser une documentation avec supports papier et électronique à partir d'un seul fichier source LaTeX.

Le manuel complet est ici.

LaTeX2HTML est disponible ici .

Pour utiliser LaTeX2HTML, les produits suivants sont nécessaires :

• LaTeX;
• Perl version 4.0 Patch Level 36 (ou postérieure);
• dvips version 5.516 (ou postérieure);
• Ghostscript version 2.6.1 ou postérieure;
• pbmplus.

Après avoir installé latex2html.tar dans un répertoire local, il convient d'effectuer les opérations suivantes :

• éditer le fichier latex2html.config pour indiquer l'endroit où se trouvent LaTeX2HTML, pbmplus... ;
• lancer la suite de tests install-test, elle s'assure de la disponibilité du tout ;
• installer le fichier dot.latex2html-init dans le répertoire d'accueil des usagers désirant utiliser le convertisseur (en le nommant .latex2html-init). Ce fichier va permettre à l'utilisateur de personnaliser certains paramètres ;
• installer le fichier html.sty dans le répertoire où se trouvent les autres fichiers de style ;
• installer les icônes (du répertoire icons) dans un endroit visible par le serveur WWW local et l'indiquer dans le fichier latex2html.config.

LaTeX2HTML permet de positionner ses options de fonctionnement sur la ligne de commande ou dans le fichier .latex2html-init (voir le manuel de référence cité en section 5.4.1). En indiquant les options dans .latex2html-init, l'appel de LaTeX2HTML peut être le suivant :

latex2html document.tex

Cet appel va créer (dans le répertoire courant) un répertoire nommé document qui va contenir le résultat de la traduction, notamment un fichier nommé document.html. Pendant la phase de mise au point le résultat peut être visionné avec l'option open local (du moins avec le client xmosaic). Une fois le document au point, le répertoire document peut être installé dans un répertoire accessible par le serveur WWW local. Parmi les principaux paramètres accessibles dans .latex2html-init citons les suivants :

• MAX_SPLIT_DEPTH pour indiquer le seuil de découpage des sections, sous-sections... en fichiers html distincts. La valeur par défaut est 8, en indiquant 0 on produit un seul fichier ;
• MAX_LINK_DEPTH pour indiquer le niveau de la ``table des matières'' produite dans chaque fichier html. À partir d'un niveau de sectionnement, on précise ici le détail dans la visibilité directe de la descendance. La valeur par défaut est 4, il convient de trouver un équilibre eentre sa valeur et celle de MAX_SPLIT_DEPTH ;
• TITLE précise le titre du document ;
• ADDRESS pour signer chaque fichier html produit ;
• ...

La fonctionnalité majeure de LaTeX2HTML est d'autoriser la production d'un support électronique de qualité sans négliger le support papier. Pour cela, il est necessaire de permettre au rédacteur de rédiger un seul fichier source sans négliger les différences entre les deux supports. LaTeX2HTML règle ce problème par des commandes de soumission conditionnelle qui sont les suivantes :

• begin{latexonly} terminé par end{latexonly} pour indiquer des séquences qui ne seront pas traduites en HTML ;
• begin{rawhtml} terminé par end{rawhtml} pour spécifier des séquences directement écrites en HTML (à ne pas soumettre à LaTeX).

L'exemple suivant, tiré de la présente documentation, permet d'indiquer les URLs ou de créer un lien en fonction du support utilisé :

\begin{latexonly}
Une liste complète de ces séquences est accessible en indiquant la
référence suivante :

{\tt http://www.w3.org/hypertext/WWW/MarkUp/ISOlat1.html}.
\end{latexonly}

\begin{rawhtml}
Une liste complète de ces séquences est accessible
<A HREF="http://www.w3.org/hypertext/WWW/MarkUp/ISOlat1.html">
ici</A>.  
\end{rawhtml}

Cette technique peut aussi être utilisée pour insérer des images PostScript dans la version papier et des images GIF dans la version HTML. LateX2HTML sait faire la conversion de PostScript vers GIF mais la qualité du résultat est assez moyenne dans certain cas (appel de Ghostscript et pbmplus).

Pour utiliser ces fonctionnalités il faut inclure html.sty dans les options de style du document LaTeX de base.

5.4.2 FrameMaker vers HTML

Le seul convertisseur à peu près complet pour convertir un fichier FrameMaker en HTML est actuellement

Frame2html . Il est écrit en C et s'installe sous UNIX. Ses principales fonctionnalités sont les suivantes :

• utilise les hypertext de FrameMaker pour créer des hyper-liens ;
• supporte les références croisées ;
• crée un fichier HTML dans le cas d'un fichier FrameMaker ;
• crée autant de fichiers HTML que de fichiers FrameMaker dans le cas des livres FrameMaker, ainsi qu'un sommaire automatique ;
• convertit les images dans les fichiers FrameMaker en images GIF ;
• ...

Frame2html permet de diffuser une documentation avec supports papier et électronique à partir d'un seul fichier source FrameMaker.

Pour utiliser Frame2html, les produits suivants sont nécessaires :

• FrameMaker;
• Ghostscript;
• Perl;
• pbmplus;
• Flex;
• yacc.

Après avoir compilé et installé Frame2html, il est nécessaire de personnaliser le fichier mif2html.tags qui contient les correspondances entre les styles de paragraphes utilisés dans FrameMaker et ceux connus par le convertisseur. Un fichier FrameMaker est donné en exemple.

Soit un fichier FrameMaker document, la syntaxe de Frame2html est :

fm2html document [titre] [auteur]

où :

• title est le titre du document ;
• auteur est le nom de l'auteur.

Frame2html crée alors soit un fichier HTML soit plusieurs fichiers HTML (suivant que document est un fichier simple FrameMaker ou un livre). Le fichier de départ s'appellera document.html. Si le document contient des images ou des formules mathématiques, Frame2html va créer également les fichiers GIF correspondants. La conversion des images couleur n'est actuellement pas encore au point.

Un fois la version HTML obtenue, il suffit de la vérifier, par exemple avec Mosaic de façon locale (commande Open Local... du menu File), pour la mettre au point. Ceci fait, il ne reste qu'à mettre les fichiers correspondants dans un répertoire du serveur W3 local.

5.4.3 RTF vers HTML

La conversion de fichiers RTF en HTML est intéressante car elle permet la conversion vers HTML de fichiers Word et WordPerfect.

Le logiciel rtftohtml permet la conversion de documents au format RTF au format HTML.

Il peut s'installer sur UNIX ou sur Mac.

Une fois installé, on peut personnaliser la conversion grâce au fichier html-trans qui contient un ensemble de règles de conversion entre les styles de paragraphes et de caractères RTF vers ceux de HTML.