Le teTeX HOWTO : le guide local de teTeX pour Linux: Annexe B : installation de la distribution CTAN de teTeX
9. Annexe B : installation de la distribution CTAN de teTeX
La distribution générique de teTeX n'est pas plus difficile à
installer que les paquetages Linux. Cf. la section
Distribution générique CTAN, ci-dessous.
Vous devriez envisager d'installer la distribution générique de teTeX
à partir des archives CTAN si :
- Votre système n'est pas basé sur l'une des distributions
standardisées de Linux.
- Vous ne disposez pas des privilèges de root sur votre système.
- Vous souhaitez, ou il vous faut absolument, la dernière version
de teTeX ou LaTeX.
- Vous n'avez pas assez d'espace disque disponible pour une
installation complète.
- Vous voulez installer teTeX ailleurs que dans le répertoire
/usr .
- Vous voulez partager votre installation teTeX avec d'autres
variantes d'UNIX ou d'autres plates-formes sur le réseau. Dans ce cas,
vous devriez sérieusement envisager une installation à partir de la
distribution source. Cf. section
Installation de la distrbution source, plus loin.
- Vous voulez disposer des dernières versions des polices Type 1
du domaine public, qui sont considérablement meilleures que les
polices accompagnant les versions antérieures.
Une installation complète de la distribution binaire nécessite de 40 à
50 Mo d'espace disque, et la construction de la distribution à partir
du code source requiert environ 75 Mo, il faut donc vous assurer de
disposer de cet espace disque avant de commencer. Il n'est pas
nécessaire d'avoir installé le compilateur GCC ou le système X Window
(bien que X soit d'une aide précieuse puisqu'il permet la
prévisualisation des documents à l'écran). Tout ce qu'il vous faut est
un éditeur capable de produire du texte en ASCII pur (cf. section
2). Peut-on faire plus simple ?
Vous pouvez télécharger les fichiers à partir de l'un des sites CTAN
recensés dans la section
Annexe A. Dans
les exemples ci-dessous, les fichiers sont originaires de l'archive
CTAN située à
ftp.tex.ac.uk.
9.1 Installation de la distribution binaire
Installation minimale
En premier lieu, faites un FTP sur
ftp.tex.ac.uk et un cd vers le répertoire
Récupérez les fichiers
et placez-les dans le répertoire-racine de l'endroit ou vous voulez
installer teTeX, par exemple /var/teTeX si vous souhaitez
installer teTeX dans le répertoire /var .
Imprimez le fichier INSTALL.bin . Gardez-le sous la main car
il décrit comment installer une version minimale de
teTeX. L'installation minimale ne demande que 10 à 15 Mo mais, si
possible, il est recommandé d'installer l'ensemble du paquetage
teTeX. Pour une installation minimale, vous aurez besoin des fichiers
Vous aurez également besoin de l'une des deux archives contenant les
programmes exécutables de teTeX. Récupérez le fichier
si votre système utilise les bibliothèques partagées au format Linux
ELF, ld.so dans une version au moins égale à 1.73, et clibs
dans une version au moins égale à 5.09. Si ce n'est pas le cas,
récupérez l'archive
compilé pour des systèmes utilisant les bibliothèques statiques au
format a.out, plus anciennes.
Puis, suivant en cela les instructions du fichier
INSTALL.bin , exécutez la commande
à partir du répertoire-racine de l'installation teTeX. (Assurez vous
que les archives teTeX s'y trouvent également). Après quelques
instants, le programme d'installation vous avertira s'il manque
certains paquetages teTeX. Si toutefois vous prévoyez une installation
minimale de teTeX, vous pouvez ignorer ces avertissements et passer à
la suite. Pour configurer le système teTeX élémentaire, reportez-vous
à la section
Configuration d'un système élémentaire, ci-dessous.
Pour installer les paquetages restants, voyez la section suivante.
Installation complète
Pour effectuer une installation complète de teTeX, récupérez les
fichiers d'archives recensés dans la section précédente, puis les
fichiers suivants :
Tous ces fichiers devraient être placés dans le répertoire-racine de
l'arborescence où teTeX doit résider. Comme pour l'installation
minimale, exécutez la commande
9.2 Configuration d'un système élémentaire
Le script install.sh , après avoir déterminé l'ensemble des
archives teTeX disponibles, vous offrira un menu d'options. Le seul
paramètre que vous avez à définir à ce moment-là est le
répertoire-racine de l'endroit où vous voulez installer teTeX, en
sélectionnant l'option « D ». Bien sûr, vous
devez sélectionner un répertoire pour lequel vous avez les droits
d'écriture dans le répertoire père. Par exemple, si vous installez
teTeX dans votre home directory, vous spécifierez le répertoire
d'installation de teTeX comme
et, après être retourné au menu principal, sélectionnerez
« I » pour poursuivre l'installation. Notez que ce
répertoire ne doit pas exister : le script install.sh doit
pouvoir le créer.
Une option que vous pourriez envisager de modifier est la définition
d'un répertoire pour la génération des polices. Même si vous prévoyez
de n'utiliser que des polices vectorielles Postscript Type 1, il
vous arrivera à l'occasion de travailler sur un fichier basé sur des
polices Computer Modern. L'activation de cette option vous demande
d'entrer le nom du répertoire à utiliser. Vous devez disposer des
droits d'écriture dans son répertoire-père. En se basant sur l'exemple
précédent, vous pourriez spécifier
ou bien, si vous souhaitez rendre les polices générées accessibles à
tous les utilisateurs du système, spécifiez un répertoire comme
Je vous recommanderai cependant de ne pas utiliser le répertoire
par défaut pour cette option, /var/tmp/texfonts , car les
polices générées pourraient être effacées au prochain redémarrage, et
elles devraient être régénérées lorsqu'elles seraient à nouveau nécessaires.
Après que vous aurez sélectionné l'option « I »
et que install.sh aura installé les archives, positionné les
droits d'accès divers et généré les liens et les fichiers de format,
le programme se terminera avec un message vous indiquant de rajouter
le répertoire des binaires teTeX à votre variable d'environnement
$PATH , et les répertoires où se trouvent les pages
man et info à vos variables d'environnement
$MANPATH et $INFOPATH . Par exemple,
ajoutez les directives
à votre ~/.bash_profile si vous utilisez bash
comme interpréteur de commandes, ou à votre ~/.profile
si vous en utilisez un autre pour vos connexions.
Déconnectez-vous, puis reconnectez-vous pour que les variables
d'environnement puissent être prises en compte. Puis, lancez la commande
pour vous assurer que l'installation est correcte.
Ensuite, vous pouvez configurer teTeX pour votre matériel
spécifique : reportez-vous à la section
Détails de configuration après l'installation, ci-dessous.
9.3 Installation de la distribution source CTAN
Pour installer teTeX V. 0.4 à partir du code source, faites un
ftp sur un site CTAN comme
ftp://ftp.tex.ac.uk et récupérez les fichiers
Parcourez les instructions dans INSTALL.src , puis faites
su pour devenir root et déballez les fichiers dans un
répertoire pour lequel vous avez les droits de lecture-écriture-exécution.
Souvenez-vous d'utiliser l'argument p pour faire le
tar , et de désactiver l'option noclobber du
bash . Cela est possible grâce à la commande suivante, à
l'encontre du bon sens,
Remarquez que l'argument +o de la commande set
désactive une variable, à l'inverse de ce que l'on pourrait croire.
Le fichier teTeX-lib-0.4pl8.tar.gz va créer le répertoire
./teTeX . Le fichier teTeX-src-0.4pl7.tar.gz va créer
le répertoire teTeX-src-0.4 . Imprimez le fichier
INSTALL.src et gardez-le à proximité pour les étapes
suivantes. Faites un cd vers le répertoire
./teTeX-src-0.4 , et, comme indiqué dans les instructions du
fichier INSTALL.src , éditez le fichier
./Makefile . Vous devrez positionner la variable
TETEXDIR avec le chemin absolu vers le répertoire père du
répertoire teTeX. Il s'agit donc du sous-répertoire teTeX du
répertoire où vous avez déballé les archives des sources et des
bibliothèques. Par exemple, si vous avez déballé les archives dans
votre home directory, vous positionnerez TETEXDIR à
Les autres options du Makefile sont assez génériques. Avec
GCC version 2.7.2 ou plus, vous ne devriez pas être obligé de faire
plus d'ajustements à moins d'avoir une configuration non standard pour
le compilateur et les bibliothèques, ou de souhaiter le que
compilateur fasse plus d'optimisations ou pour toute autre
raison. Vérifiez que les variables USE_DIALOG ,
USE_NCURSES , et HAVE_NCURSES sont correctement
positionnées pour votre système, car le programme dialog a
besoin de la bibliothèque ncurses pour être installé. Une
bibliothèque ncurses est comprise dans la distribution source,
par conséquent, les valeurs par défaut du Makefile devraient
fonctionner correctement. Si vous n'arrivez pas à compiler ou à faire
l'édition de liens de ncurses , le programme
texconfig peut également être lancé à partir de la ligne de
commande.
Si vous avez tout bon jusqu'ici, vous devriez pouvoir taper make
world dans la racine de l'arborescence des sources et vous
détendre jusqu'à ce que les exécutables teTeX soient construits. Cela
peut prendre quelques heures.
Après que la compilation a pris fin, positionnez les variables
d'environnement $PATH, $MANPATH , et
$INFOPATH pour y inclure les répertoires de teTeX. Les
directives à ajouter au fichier ~/.bash_profile , dans
l'exemple ci-dessus, seraient
La variable $PATH diffère entre les distributions
source et binaire. Remarquez que le chemin vers les binaires est
teTeX/bin/i386-linux au lieu de simplement teTeX/bin
comme dans la distribution binaire.
À ce stade, vous pouvez lancer texconfig confall pour vous
assurer que les chemins ont été positionnés correctement, et
poursuivre la configuration de teTeX comme pour la distribution
binaire. Cf. section
Détails de configuration après l'installation, ci-dessous.
9.4 Détails de configuration après l'installation
La première chose que vous voudrez faire est de regarder le fichier
README de Thomas Esser. Il contient un tas d'indices sur la
manière de configurer teTeX pour votre périphérique de sortie
(imprimante par exemple). Le fichier README se trouve dans le
répertoire
Parcourez le fichier à l'aide de la commande (le chemin dans les
exemples qui suivent est celui de la distribution Slackware) :
ou imprimez-le avec la commande
en supposant que votre imprimante est connectée à
/dev/lp0 . Remplacez-le par le fichier correspondant au pilote
auquel votre imprimante est attachée le cas échéant.
Ou, encore mieux, imprimez-le avec la commande lpr :
Vous devriez avoir installé le démon d'impression qui est inclus dans
votre distribution Linux. Si ce n'est pas le cas, faites-le
maintenant, en suivant les instructions qui accompagnent ce paquetage.
Imprimez la teTeX-FAQ. Gardez la FAQ sous la main car elle
contient des indications utiles pour la configuration des pilotes de
sortie pour teTeX adaptée à votre imprimante. Nous y viendrons dans un
moment. Dans des versions plus récentes de teTeX, la
teTeX-FAQ peut être visualisée à l'aide de l'utilitaire
texconfig .
Ensuite, vous souhaiterez définir un répertoire où stocker vos propres
fichiers de formats TeX. teTeX parcourt les répertoires figurant dans
la variable d'environnement $TEXINPUTS pour des
fichiers d'entrée pour TeX disponibles en local.
Ajoutez
au fichier système /etc/profile . Chaque utilisateur peut
positionner son propre répertoire $TEXINPUTS local, en
ajoutant la ligne dans son ~/.profile ou
~/.bash_profile si bash est l'interpréteur de
commandes par défaut. La variable d'environnement
$TEXINPUTS indique à teTeX de chercher les fichiers de
style TeX des utilisateurs dans les répertoires
~/texinputs sous les home directory de chacun des
utilisateurs. Il est indispensable de mettre un deux-points avant
et après ce répertoire. teTeX va ajouter ses propres répertoires de
recherche aux vôtres. Vous voudrez que teTeX recherche en premier lieu
les fichiers de format locaux, pour qu'il utilise les versions locales
des fichiers standardisés que vous avez édités.
Ajoutez le répertoire /usr/lib/teTeX/bin aux chemins définis
pour le système si vous installez teTeX en tant que root. Encore une
fois, si vous installez un exemplaire personnel de teTeX, ajoutez le
répertoire où se situent les binaires teTeX en tête de votre
$PATH en insérant la ligne suivante dans votre
~/.profile ou votre ~/.bash_profile :
À présent, connectez-vous sous root et lancez
texconfig comme il est dit dans la teTeX-FAQ et
choisissez l'imprimante attachée à votre système. Assurez-vous de
configurer teTeX aussi bien pour la bonne imprimante que pour la bonne
résolution d'impression.
Enfin, lancez le programme texhash . Cela garantit que la base
de données interne de teTeX est bien à jour. Cette base de données
n'est autre que le fichier ls-lR . Vous devez lancer
texhash à chaque fois que vous modifiez la configuration du
système, sans quoi teTeX sera incapable de prendre en compte vos
changements.
[22 février 2002, JDNet]
|