11.3 Panneau Etc\TeX4ht 

11.3.1 Description des boutons 

Doc  : Affiche l'aide en ligne de TeX4ht avec Netscape.

Doc DOS  : Affiche la documentation du port de TeX4ht sous DOS, réalisé par G. Klein. Il a été modifié pour la distribution AsTEX, afin de traiter correctement les caractères accentués du français (ce qui n'était pas le cas avec la version originale) et afin d'utiliser les programmes d'Image Magick plutôt que Display. Ce programme DOS peut provoquer des problèmes d'affichage sous Windows 9x/NT.

Ini TeX4ht  : Initialise TeX4ht pour la distribution AsTEX. Cette initialisation doit être faite une fois et une seule (avant d'utiliser TeX4ht pour la première fois).

Editer T1  : Ouvre le fichier de test ast\astex\tex4ht\demos\t4hdem1.tex avec Notepad. Ce fichier de test est en LaTeX2.

TeX4ht T1  : Lance TeX4ht sur le fichier de test t4hdem1.tex.

Voir T1.html  : Affiche, avec Nets- cape⁴ la sortie html du fichier de test t4hdem1.tex.

Editer T1.html  : Ouvre, avec Notepad, le fichier t4hdem1.htm créé par le bouton TeX4ht T1 .

Editer T2  : Ouvre le fichier de test ast\astex\tex4ht\demos\t4hplain.tex avec Notepad. Ce fichier de test est en Plain TeX. Il a été obtenu à partir du fichier de démo amstexpl.tex simplement en lui rajoutant l'en-tête ci-dessous :

\input TeX4ht.sty  \Preamble{html}  \EndPreamble

D'une manière générale, c'est la seule modification qu'il y a à apporter à un fichier en Plain TeX, pour pouvoir créer une sortie HTML.

TeX4ht T2  : Lance TeX4ht sur le fichier de test t4hplain.tex.

Voir T2.html  : Affiche, avec Netscape, la sortie html du fichier de test t4hplain.tex.

Config fontes  : permet de modifier le fichier de configuration des fontes. Pour accélérer la création des images pendant la phase de test, mettre l'option +minimize à on. Pour la version définitive, il est préférable de remettre cette option à off, sinon le bord de certaines images peut être mangé.

? TeX4ht : Affiche l'aide sur le panneau Etc\TeX4ht.

11.3.2 Test d'installation et prise en main 

Pour voir les possibilités de TeX4ht :

1.   Si vous venez juste d'installer la distribution et que vous n'avez encore jamais lancé TeX4ht, cliquez sur le bouton Ini TeX4ht .
2.   Cliquez sur le bouton TeX4ht T1 . Ceci lance le traitement par TeX4ht du document de test. Acceptez la création des fontes si cela vous est demandé, en tapant Y.
3.   Cliquez sur le bouton Voir T1.html pour afficher le résultat.
4.   Cliquez sur le bouton Editer T1 , ajoutez un texte de votre crû et modifiez la formule, par exemple en remplaçant gamma par alpha. Sauvegardez votre modification puis relancez les deux étapes précédentes pour voir le résultat de la modification.
5.   Dans la fenêtre de Netscape, faites passer le curseur sur la lettre dans le tableau, et vérifiez qu'une bulle s'affiche avec pour contenu G.
6.   Cliquez sur le bouton Editer T1.html et recherchez la chaîne ALT="G". Remplacez le G par Gamma et sauvegardez votre modification.
7.   Revenez dans la fenêtre de Netscape, cliquez sur le bouton Recharger et faites de nouveau passer le curseur sur la lettre . Notez qu'une bulle s'affiche maintenant avec pour contenu Gamma.

11.3.3 Quelques limitations de TeX4ht (mod. 27/04/2000) 

Le programme TeX4ht utilise Tex lui-même pour créer la sortie HTML. Il comprend donc presque toutes les macros TeX. Toutefois, il y a certaines constructions qu'il traite incorrectement. Cette section donne une liste de quelques problèmes et de leurs solutions, reprises du fichier ast\astex\doc\fr\common\t4hmac.tex.

1.   Lorsqu'une section se termine par un paragraphe normal, il peut être nécessaire de rajouter la commande \fin pour éviter que les boutons de navigation ne soient collés à la fin du texte⁵ . La commande \fin ajoute une fin de paragraphe <P> dans la sortie HTML, et rien dans la sortie dvi ordinaire.
2.   Il est souhaitable de remplacer les fins de ligne \\ par la commande \fdl, pour éviter que la fin de ligne ne soit ignorée. La commande \fdl rajoute une fin de ligne <BR> dans le fichier HTML, et la commande \\ dans la sortie dvi ordinaire.
3.   Il faut éviter d'utiliser des références dans les légendes de figures.
4.   Il ne faut pas utiliser la commande \\ dans un titre de section.
5.  Il ne faut pas utiliser \% dans un titre, mais plutôt la définition \pcent⁶  :

   \def\pcent{{\tt\char '045}}

6.  Un flottant juste après une formule peut aboutir à la création d'une formule vide. Le problème est signalé pendant la création de l'image gif, qui est de taille nulle. Le résultat final est l'inclusion d'une image A4 vide. Solution : introduire un blanc artificiellement après la formule, par exemple avec la correction italique \/.
7.  Il faut éviter d'utiliser la commande \afterpage pour résoudre des problèmes de placement de flottants, telle qu'indiquée dans le LaTeX Companion : elle produit une erreur TeX capacity exceeded.
8.  Le mot Plus ne peut pas être mis en début de paragraphe (il provoque une erreur Missing number, treated as zero.). Il faut écrire \hbox{Plus}.
9.  Il ne faut pas mettre de caractère % à la fin de la ligne d'en-tête, pour l'environnement longtable. Par exemple, la ligne :

   \begin{longtable}{lrr}%

   provoque une erreur.
10.  On ne peut pas utiliser la commande \verb dans un \item[] (cela remplace le texte par des messages d'erreur de LaTeX).
11.  On peut pas utiliser les caractères [ et ] dans un \item[] (cela supprime les passages à la ligne entre items).