Guide d'installation de TeTex (plain TeX) en français

Guide d'installation de TeTeX (plain TeX) en Français

Version 1.0 du document.
Patrice KARATCHENTZEFF

Ce document est placé sous la licence GPL (GNU Public Licence) et peut donc être redistribué sans contrainte autre que celle de redistribuer le nouveau document sous la même licence. Pour plus, d'information, cliquer ici.

Ayez quand même la gentillesse d'en informer l'auteur dans ce cas et de garder son nom dans les prochains documents comme auteur original.

Ne pas hésiter à me contacter pour toute idée et/ou commentaire (ou corrections, l'erreur est humaine :-)). Ce document en est sa première version et ne pourra évoluer que grâce à la participation de tous.

Version dvi de ce document : doc_TeTeX.dvi.gz - 14,8 ko

Version postcript : doc_TeTeX.ps.gz - 69,7 ko

Ces deux documents ont été comprimés à l'aide de gzip. Pour les décomprimer, faire

gzip -d doc_TeTeX.xxx.gz

ou

gunzip doc_TeTeX.xxx.gz

où xxx est << dvi >> ou << ps >> suivant les versions téléchargées. Le dvi (DeVice Independant) est visualisable avec xdvi et le postscript avec ghostview.

Introduction

Ce document a pour but d'expliquer comment installer TeTeX (version 0.4p18-11) sur un système Linux basé sur une RedHat 5.0 ou ultérieure de façon à obtenir un TeX francisé. Par francisé, j'entend pouvoir utiliser plain TeX avec une hyphénation française et une saisie << normale >>, à savoir de pouvoir taper ses accents directement sans devoir utiliser le très puissant mais peu pratique outil de composition des accents (\ puis accent puis lettre) mis à notre disposition par TeX .

Il est vrai que tout ceci existe sous LaTeX mais le présent document ne s'adresse justement qu'à ceux qui ne désirent pas abandonner plain TeX. Les raisons sont nombreuses et ne seront pas développées ici. Les raisons qui m'ont poussées à écrire ce document sont les suivantes. Utilisateur d'une Slackware depuis mes débuts sous Linux, j'utilisais alors MLTeX , une version complètement francisée de TeX que j'utilisais déjà sous MS-DOS auparavant.

Puis pour des raisons de facilité de gestion évidente, j'ai abandonné la Slackware au profit de la RedHat. J'ai alors voulu utilisé le TeX qui s'annonce comme le futur standard sous Linux, à savoir TeTeX. Malheureusement, si TeTeX s'annonçait comme supportant un grand nombre de langues, dont le français, l'installation et la mise en oeuvre ne furent pas de tout repos. Et surtout, la documentation ne me fut pas d'un grand secours (1) avec un gestionnaire de fichier.

1. À qui s'adresse ce document ?

Ce document s'adresse à toute personne désirant installer plain TeX sur un système Linux avec comme distribution une RedHat version 5.0 ou ultérieure. Il faut noter que la méthode décrite ci-dessous n'est pas fondamentalement particulière aux distributions RedHat ; toute personne ayant un peu l'habitude d'une autre distribution ( Slackware, Debian ,... etc.) pourra l'adapter sans trop de difficultés.

Pour ce faire, le niveau recquis du lecteur est le suivant: savoir se débrouiller avec les commandes Unix de base (déplacement, création et suppression de répertoire, gestion des droits sur un fichier, etc...) et savoir manipuler un éditer de texte en mode console (i-e sans être sous X). De plus, il doit avoir des droits de root pour l'installation générale. Il doit être évidemment possible d'installer en local l'application mais cela demande une réelle adaptation.

!!! Important !!!

L'auteur décline toute responsabilité (et culpabilité !) quant à l'utilisation de ce document. Il est délivré << tel quel >> dans l'espoir qu'il pourra rendre service mais l'auteur n'assure aucune garantie quant au résultat. Le lecteur assumera intégralement <>tous les déboires que pourraient lui occasionner une utilisation malheureuse du présent document.

Bon, ça devait être dit: c'est le préservatif du documentaliste :-). On peut maintenant s'attaquer aux choses sérieuses.

Enfin, la configuration minimale est la suivante: système Linux basé sur la distribution RedHat 5.0 ou ultérieure et le système Xwindow installé. (2)

2. Installation de TeTeX

2.1 Recompilation des sources

Bien que TeTeX soit fourni avec les binaires sous forme de rpm, je recommande fortement de recompiler les sources de façon à optimiser son installation. De plus, j'avais rencontré quelques difficultés avec les binaires originaux, la recompilation m'a permis de résoudre une partie de mes problèmes. Que les utilisateurs non chevronnés de Linux ne se paniquent pas; il n'est nul besoin d'être un expert du langage C (ni même d'en connaître le moindre mot) pour effectuer cette opération. On va suivre pas à pas les différentes démarches et tout devrait fonctionner tout seul. C'est la raison pour laquelle une RedHat est particulièrement agréable: elle permet de faciliter grandement les démarches d'un néophyte en Unix pour les installations ou les recompilations.

Tout d'abord, il faut récupérer les sources de TeTeX au format rpm. Il s'agit du fichier suivant (3) :

tetex-0.4pl8-11.src.rpm

Il est nécessaire d'avoir précédemment installé les outils de compilation ( make, gcc,...etc.) Tout ceci est disponible avec n'importe quelle distribution sous forme de binaires et s'installe tout seul à l'aide de rpm .

L'installation des sources de TeTeX peut alors commencer. Pour ce faire, en tant que super-utilisateur, décompacter le fichier source :

rpm -ivh tetex-0.4pl8-11.src.rpm

Si cette opération ne s'effectue pas correctement, compléter les bibliothèques manquantes et recommencer l'opération jusqu'à son succès.

Puis se déplacer dans le répertoire des sources :

cd /usr/src/redhat/SPECS

où l'on doit normalement trouver le fichier tetex-0.4pl8.spec . Il ne reste alors plus qu'à compiler le-dit fichier; pour ce faire, il suffit de taper la commande suivante :

rpm -bb tetex-0.4pl8-11.spec

À partir de là, il ne reste plus qu'à être patient; en effet, sur mon ordinateur (Cyrix P166+, 32 Mo de mémoire vive), il faut plus d'une demi-heure pour arriver au bout! À titre de comparaison, la compilation de mon noyau me prend moins de dix minutes (4) et celle de Emacs moins de vingt minutes...

Donc, ne pas hésiter à aller faire autre chose, surtout si la machine est un peu faiblarde côté processeur ou mémoire. Ne pas avoir de regret car de toute façon le jeu en vaut la chandelle.

Lorsque la compilation est terminée, il ne reste plus qu'à installer tout ce qui vient d'être fait. Il suffit alors de taper les commandes suivantes :

cd ../RPMS/i386} rpm -ivh tetex-0.4pl8-11.rpm

Le répertoire i386 est bien entendu à adapter suivant le processeur. Que les inquiets ne paniquent pas; ceux qui ne savent pas quel est leur processeur utilisent certainement un compatible Intel et ne doivent s'occuper de rien. Les autres sont suffisamment fûtés pour avoir installé un système Linux sur autre chose comme plateforme et sauront adapter sans difficulté...

TeTeX est maintenant compilé et installé. Ce ne fut pas si terrible... Ceux qui se refusent toutefois à << sauter le pas >> pour recompiler un logiciel peuvent toujours installer le binaire sous forme de rpm comme suit :

rpm -ivh tetex-0.4pl8-11.i386.rpm

Dans tous les cas, TeTeX doit maintenant fonctionner. Il ne reste plus qu'à franciser le logiciel.

2.2 Francisation de TeTeX

Par défaut, TeTeX est configuré pour les anglo-saxons. C'est malheureux mais c'est comme cela... Toutefois, comme TeTeX supporte un très grand nombre de langues, dont le français, un outil est proposé pour le configurer assez facilement.

Cet outil s'appelle texconfig . Par défaut, il est installé dans /usr/bin et donc ne devrait pas poser de problème de PATH . De plus, il a été conçu pour fonctionner en mode console ou dans un xterm . Il lui suffit d'avoir simplement un espace d'au moins 24 lignes et 80 colonnes.

Après avoir lancer (avec succès) texconfig , il devrait apparaître un menu ressemblant à peu près à ceci :

EXIT	exit
PREF	personal preferences
CONF	show configuration
REHASH	rebuild ls-R database
HYPHEN	hyphenation table (tex/latex)
MODE	default mode (xdvi/dvips/mf)
XDVI	xdvi configuration
DVIPS	dvips configuration
FONT	directories for font creation
DOC	rebuild html documentation
FAQ	frequently asked question + answers
LOG	view logfile

Pour sélectionner un menu, agir avec les flèches de direction puis valider avec le retour charriot. Dans un premier temps, il vaut mieux sélectionner le menu personal preference de façon à choisir un éditeur de texte. Par défaut, vi est proposé. Les allergiques comprendront... Les autres s'en contenteront.

Tout ceci pour arriver au sous-menu hyphenation table pour choisir une hyphénation française et ainsi obtenir un TeTeX français. Après avoir sélectionné le menu HYPHEN , on arrive en édition (avec l'éditeur précédemment choisi :-) sur le fichier language.dat . Le lecteur pourra alors se rendre compte que l'hyphénation par défaut est l'anglais et... l'allemand. Pôvre langue française... Pour réparer cet << oubli >> malheureux, il suffit de décommenter la ligne 36 du fichier (celle correspondant à << french >> pour ceux qui utilise des éditeurs de texte aux capacités réduites...). Pendant que l'on y est, on peut recommenter la ligne 37, celle correspondant à << german >>. Tout le monde ne pratique pas la langue de Goethe...

Deux remarques au passage: le commentaire est un commentaire TeX: il s'agit du pourcent (%). Lorsque TeX rencontre ce signe, il ignore tout ce qui suit jusqu'au premier retour à la ligne. Donc pour décommenter le français, il faut supprimer le caractère % devant french . Pour commenter l'allemand, il suffit d'ajouter % devant german , devant signifiant bien-sûr en tête de ligne. Enfin, il ne faut pas décommenter l'hyphénation anglaise , même si on ne l'utilise pas proprement dit. Le << moteur >> de TeX a besoin de façon impérative du mode anglais. D'ailleurs, il ne travaille qu'en anglais: le génial Knuth n'a pas pensé qu'il existait d'autre langue que l'anglais... :-(

Enfin, le lecteur un peu curieux pourra personnaliser son environnement à souhait. Les menus sont suffisamment parlant, même en anglais.

À ce stade, TeTeX est fonctionnel et traite les textes comme des textes français, à condition bien-sûr de le déclarer en tête de fichier source comme suit:

\input francais.sty

Voilà, à ce stade, on a un TeX qui reconnait un texte comme étant français et qui coupe correctement les mots et présente avec un style bien français. Mais il demeure un inconvénient: les accents ne sont pas gérés directement par TeTeX... Seule la composition fonctionne; et cela n'est pas très pratique. On va essayer d'arranger cela de la façon la plus propre possible. Sinon, ce document aurait un intérêt des plus limités :-)

2.3 Reconnaissance de l'accentuation par TeTeX

Pour s'affanchir des problèmes d'accent, le plus simple est d'écrire une table une fois pour toute. Lorsque TeX compilera le fichier source, il remplacera alors de lui même tous les accents par sa séquence de composition. En fait, rien ne change (ou presque...) pour TeX mais on y gagne grandement et en lisibilité du source et en confort de frappe.

Plutôt que de réinventer la roue, il suffit de récupérer un fichier de conversion existant déjà. J'ai choisi (arbitrairement) celui de LATeX 2e. Et comme je lui ai retiré son en-tête, je l'ai renommé France_accents, ce qui fait preuve d'une originalité certaine :-).

Le fichier est le suivant : France_accents

Ce fut un peu long mais le principe d'un document exhaustif tient justement dans son exhaustivité (5) !

Le principe de la man\oe uvre est simple: on va créer un répertoire hors de l'installation de TeTeX dans lequel on mettra notre fichier de conversion. par la même occasion, on pourra mettre tous les fichiers de macros personnelles dans ce répertoire. Ainsi, à chaque fois que l'on mettra une version plus récente de TeTeX à jour, l'ensemble des fichiers personnels ne sera pas touché.

Pour ce faire, il faut modifier le fichier suivant (avec son éditeur favori :-). Par contre, dans ce cas précis, il est nécessaire d'être super-utilisateur...) :

/usr/lib/texmf/texmf.cnf

Après édition, aller à la ligne numéro 26 ; elle doit se présenter ainsi (6) :

23 % Set this to the name of your local tree. You can have none, one or
24 % even more local texmf trees. Just make sure to list them in the TEXMFS
25 % variable.
26 TEXMFL          = /usr/local/tex/texmf/macros}   

La ligne 26 est normalement commenté (avec le %) et le chemin est différent. L'exemple ci-dessus est le résultat des modifications que j'ai apportées au fichier original. Donc, comme dans l'exemple précédent, pour ajouter un chemin aux chemins déjà utilisés par TeX, il suffit de décommenter la ligne 26 i-e supprimer le signe %). Puis modifier le chemin ou laisser le chemin par défaut (7).

Il ne reste alors plus qu'à décommenter la ligne 37 du fichier texmf.cnf et commenter la ligne 33 :

28 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
29 % List all your texmf trees in TEXMFS. So far, only TEXMF can be protected
30 % by !!, since ls-R only supports one texmf tree so far.
31 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
32 % No local tree:
33 %TEXMFS         = !!\$TEXMF
34 % Search local tree *after* the standard tree:
35 %TEXMFS         = {!!\$TEXMF,\$TEXMFL}
36 % Search local tree *before* the standard tree:
37 TEXMFS          = {\$TEXMFL,!!\$TEXMF}    

En fait, on peut décommenter au choix la ligne 35 ou 37: dans le premier cas, les fichiers personnels seront lus en second , donc après les fichiers de TeTeX. Dans le second cas, ils seront lus avant. Pour ceux qui ne voient pas pourquoi un tel choix est proposé, il vaut mieux choisir de décommenter la ligne 37 (8).

On a bientôt terminé: il s'agit maintenant d'intégrer ces modifications dans le plain TeX: pour cela, il faut modifier la ligne 66

65 TEXINPUTS.ps2pk         = $KPSE_DOT:$TEXMFS/{tex,fonts/afm,dvips}//
66 TEXINPUTS.tex           = $KPSE_DOT:$TEXMFS/tex{/plain,/generic,}//
67 TEXINPUTS.texinfo       = $KPSE_DOT:$TEXMFS/tex/{texinfo,plain,generic}//     

comme suit :

65 TEXINPUTS.ps2pk         = $KPSE_DOT:$TEXMFS/{tex,fonts/afm,dvips}//
66 TEXINPUTS.tex           = $KPSE_DOT:$TEXMFS:$TEXMFS/tex{/plain,/generic,}//
67 TEXINPUTS.texinfo       = $KPSE_DOT:$TEXMFS/tex/{texinfo,plain,generic}//     

On a donc simplement ajouté $TEXMFS (qui est la concaténation des variables TEXMFL et TEXMF de la ligne 37) au chemin de plain TeX.

On sauvegarde alors et on quitte. TeTeX est maintenant complètement francisé, avec une saisie en 8 bits dans le fichier source (9) .

Il ne faut bien-entendu pas omettre d'appeler le fichier d'accentuation en début de document. Pour ce faire, il suffit de l'appeler juste après le fichier de francisation de TeTeX :

\input francais.sty

\input France_accents

Bien-sûr, chacun fait à ce niveau comme il lui plait: on peut aussi le lier aux autres fichiers personnels. Je l'ai personnellement lié directement à mon fichier de macros appelé macros.tex (original, n'est-ce pas ?) et qui est appelé systématiquement lorsque je fabrique un document TeX. La seule contrainte est de ne pas oublier de placer le fichier France_accents (où quelque soit le nom que l'on lui a donné) dans le répertoire local que l'on a créé :-)).

Notes de bas de page:

(1) Il faut avouer que la documentation existe pour LaTeX mais que le plain TeX est vraiment le parent pauvre de la grande famille TeX. C'est la raison pour laquelle j'ai écrit ce document: pour que le mal que je me suis donné à installer et optimiser TeTeX puisse aussi servir à d'autre... retour

(2) Il est théoriquement possible de faire fonctionner TeX sans X mais cela recquiert l'installation d'un prévisualiseur de fichier dvi en mode console qui n'est pas installé par défaut avec TeTeX. retour

(3) La méthode de récupération importe peu: pour ceux qui possèdent une distribution sur cédérom, il est disponible dans le répertoire SRPMS. Sinon, il est possible de le récupérer sur le réseau via ftp; attention toutefois, les quelques 18 Mo du fichiers risquent de vous entrainer dans un actionnariat forcé de France Télécom ... retour

(4) Bien évidement, dit comme cela, ça n'a pas beaucoup de sens: mon noyau est un noyau 2.0.35 avec grosso modo la moitié des options compilées en statique ou en modules. retour

(5) et puis la mise en page d'un document TeX en TeX est relativement pénible alors pour que ce travail ne soit pas perdu...! retour

(6) La numérotation a été ajoutée de façon à clarifier les explications... Il en va de même pour tous les exemples qui vont suivre. retour

(7) Pour ceux qui ne sont pas très familiers des systèmes Unix en général, et de Linux en particulier, il vaut mieux mettre des fichiers personnalisés dans /usr/local . C'est plus traditionnel qu'autre chose mais cela permet de faire les choses de façon << propre >>. On découple ainsi les fichiers fournis avec un paquetage /usr de ceux qui sont ajoutés a posteriori /usr/local . Ainsi, lors de la mise à jour, si l'architecture du paquetage est modifiée, les mofications personnelles ne sont pas perdues. retour

(8) En fait, pour les non-initiés, on peut ainsi agir sur les fichiers de configuration par défaut de TeX en appliquant ses propres fichiers en dernier. Il va de soit qu'il vaut alors mieux savoir ce que l'on fait et dans tous les cas en user avec parcimonie. retour

(9) par opposition à 7 bits qui correspondent aux 127 premiers caractères ASCII, seul norme internationnale reconnue. Les caractères ainsi formés ne possèdent hélas pas de signe d'accentuation. On reconnait ainsi encore par qui sont faits les << standards >> qui régissent le monde... retour

Copyleft 1999 P. KARATCHENTZEFF

Patrice KARATCHENTZEFF

Last modified: Sat Feb 13 18:57:13 CET 1999

Retour à contributions