SuivantPrec.Bas prec.BasNiv. sup.

11.2 Panneau Etc\TeX2rtf 

Le panneau Etc\Tex2rtf permet de tester et utiliser le programme TeX2rtf, de Julian Smart. Ce programme transforme un texte en LaTeX en l'un des quatre formats winhelp, rtf, html ou xlp (aide pour wxWindows de J. Smart).

L'adaptation de TeX2rtf pour le français est faite par les programmes tex2rtf.bat et tex2htm.bat, du répertoire astex\tex2rtf.

11.2.1 Description des boutons 

TEX2RTF : Lance le programme TeX2rtf en mode interactif.
Aide : Affiche l'aide en ligne de TeX2rtf.
Test1 : Lance TeX2rtf sur le fichier de test testwin.tex. Ce test permet de vérifier que les caractères accentués du français, écrits dans la page de codes Windows, sont traités correctement.
Editer T1 : Edite le fichier de test testwin.tex avec Notepad.
Test 2 : Lance TeX2rtf sur le fichier de test testdos.tex. Ce test permet de vérifier que les caractères accentués du français, écrits dans la page de codes DOS internationale (850), sont traités correctement.
Editer T2 : Edite le fichier de test testdos.tex avec Edit du DOS.
tex2rtf.ini : Edite le fichier d'initialisation tex2rtf.ini de TeX2rtf, utilisé pour traiter les fichiers de test testwin.tex et testdos.tex.
? Tex2rtf : Affiche l'aide sur le panneau Etc\TeX2rtf.

11.2.2 Test d'installation et prise en main 

Pour vérifier la bonne installation de TeX2rtf et voir quelques unes de ses possibilités :

  1.   Cliquez sur le bouton Test 1 du panneau Tex2rtf de l'assistant. Ceci crée un fichier d'aide testwin.hlp pour Windows à partir du fichier testwin.tex, puis affiche ce fichier d'aide.
  2.  Parcourez les rubriques de l'aide, et vérifiez que tous les caractères accentués, aussi bien minuscules que majuscules, sont écrits correctement.  
    ../../../images/assist/tex2rtf1.gif
    Fig. 11.1Exemple d'aide en ligne Windows créée à partir d'un document LaTeX avec TeX2rtf.

  3.  Cliquez sur le bouton Editer T1 du panneau Tex2rtf. Ceci ouvre le fichier testwin.tex avec Notepad.
  4.  Notez que la première rubrique de l'aide en ligne a pour titre Test de caractères accentués avec Tex2rtf, et vérifiez que ce titre correspond à la première commande \section de testwin.tex. Vérifiez que les deux autres rubriques de l'aide en ligne correspondent aux deux autres commandes \section de testwin.tex.
  5.  Modifiez le titre de la première section dans testwin.tex, par exemple en remplaçant
    \section{Test de caractères accentués avec Tex2rtf}
    par
    \section{Premier test de caractères accentués avec Tex2rtf}
  6.  Sauvegardez votre modification avec l'option Fichier | Enregistrer de Notepad, puis cliquez de nouveau sur le bouton Test 1 du panneau Tex2rtf de l'assistant : ceci crée une nouvelle fenêtre d'aide.
  7.  Vérifiez que le titre de la première rubrique d'aide est maintenant Premier test de caractères accentués avec TeX2rtf.
  8.  Cliquez sur le bouton tex2rtf.ini et remplacez la ligne 18
    winHelpTitle = "Démo TeX2rtf"
    par
    winHelpTitle = "Nouvelle démo TeX2rtf"
  9.  Sauvegardez votre modification avec l'option Fichier | Enregistrer de Edit, puis cliquez de nouveau sur le bouton Test 1 du panneau Tex2rtf de l'assistant.
  10.  Vérifiez que la nouvelle fenêtre d'aide qui s'affiche a maintenant pour titre Nouvelle démo TeX2rtf.

11.2.3 Créer une aide en ligne pour Windows avec TeX2rtf 

Si vous souhaitez créer une aide en ligne pour Windows avec TeX2rtf, il est essentiel de savoir que ce programme ne traduit qu'un sous-ensemble de commandes LaTeX. Il y a un sous-ensemble prédéfini (cf. documentation de TeX2rtf) que vous pouvez compléter à l'aide du fichier d'initialisation tex2rtf.ini.

Le plus simple pour commencer est sans doute de cliquer sur le bouton Editer T1 , de supprimer tout ce qui se trouve entre les commandes \tableofcontents et \end{document}, puis de taper votre propre texte. Cliquez souvent sur le bouton Test T1 , pour vous assurer que tout va bien.

Dès qu'une erreur survient, vérifiez la syntaxe de votre document en le compilant. Si la compilation est correcte, reportez-vous à la documentation de TeX2rtf pour vérifier si vous n'avez pas utilisé une commande inconnue de ce programme. Si oui, cherchez une commande autorisée qui ferait l'affaire, ou insérez une définition de remplacement dans le fichier d'initialisation. Sinon, vérifiez si la syntaxe de la commande n'est pas restreinte par TeX2rtf.

Pour utiliser votre éditeur de texte favori plutôt que Notepad :

  1.   Ouvrez la boîte de dialogues Options de l'assistant et cliquez sur l'onglet Panneau.
  2.   Cliquez sur le bouton Editer T1 du panneau Etc\TeX2rtf pour afficher les textes de ce bouton dans la boîte de dialogues, et remplacez notepad par le nom complet de votre éditeur, dans le champ Commande envoyée.
  3.   Sauvegardez votre modification en cliquant sur le bouton Sauver, puis fermez la boîte de dialogues.
Si vous souhaitez transformer plusieurs documents, il est commode de dupliquer les boutons Test 1 et Editer T1 , et de modifier les noms de fichiers et de répertoires dans les textes des boutons dupliqués.

11.2.4 Adapter des documents préexistants 

Si les tests se sont bien passés, peut-être souhaitez-vous mettre certains de vos documents LaTeX sous forme d'aide en ligne pour Windows ? S'il y a des formules mathématiques, cela est exclu. S'il n'y en a pas, il y a beaucoup de chances que votre premier essai ne donnera rien, parce que vous aurez utilisé des commandes LaTeX valides, mais non implémentées dans TeX2rtf.

Si beaucoup d'erreurs sont signalées, il est commode de tester la validité du document par petits bouts, par copier-coller entre la fenêtre d'édition du document complet et la fenêtre d'édition associée au bouton Editer T1 .

SuivantPrec.Bas prec.HautNiv. sup.