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 :
/usr.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.
En premier lieu, faites un FTP sur
ftp.tex.ac.uk et un cd vers le répertoire
ctan/tex-archive/systems/unix/teTeX/distrib/Récupérez les fichiers
INSTALL.bin install.shet 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
ctan/tex-archive/systems/unix/teTeX/distrib/base/latex-base.tar.gz ctan/tex-archive/systems/unix/teTeX/distrib/base/tetex-base.tar.gzVous aurez également besoin de l'une des deux archives contenant les programmes exécutables de teTeX. Récupérez le fichier
ctan/tex-archive/systems/unix/teTeX/distrib/binaries/i386-linux.tar.gzsi 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
ctan/tex-archive/systems/unix/teTeX/distrib/binaries/i386-linuxaout.tar.gzcompilé 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
sh ./install.shà 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.
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 :
ctan/tex-archive/systems/unix/teTeX/distrib/doc/ams-doc.tar.gz ctan/tex-archive/systems/unix/teTeX/distrib/doc/bibtex-doc.tar.gz ctan/tex-archive/systems/unix/teTeX/distrib/doc/eplain-doc.tar.gz ctan/tex-archive/systems/unix/teTeX/distrib/doc/fonts-doc.tar.gz ctan/tex-archive/systems/unix/teTeX/distrib/doc/general-doc.tar.gz ctan/tex-archive/systems/unix/teTeX/distrib/doc/generic-doc.tar.gz ctan/tex-archive/systems/unix/teTeX/distrib/doc/latex-doc.tar.gz ctan/tex-archive/systems/unix/teTeX/distrib/doc/makeindex-doc.tar.gz ctan/tex-archive/systems/unix/teTeX/distrib/doc/metapost-doc.tar.gz ctan/tex-archive/systems/unix/teTeX/distrib/doc/programs-doc.tar.gz ctan/tex-archive/systems/unix/teTeX/distrib/fonts/ams-fonts.tar.gz ctan/tex-archive/systems/unix/teTeX/distrib/fonts/dc-fonts.tar.gz ctan/tex-archive/systems/unix/teTeX/distrib/fonts/ec-fonts.tar.gz ctan/tex-archive/systems/unix/teTeX/distrib/fonts/misc-fonts.tar.gz ctan/tex-archive/systems/unix/teTeX/distrib/fonts/postscript-fonts.tar.gz ctan/tex-archive/systems/unix/teTeX/distrib/fonts/sauter-fonts.tar.gz ctan/tex-archive/systems/unix/teTeX/distrib/goodies/amstex.tar.gz ctan/tex-archive/systems/unix/teTeX/distrib/goodies/bibtex.tar.gz ctan/tex-archive/systems/unix/teTeX/distrib/goodies/eplain.tar.gz ctan/tex-archive/systems/unix/teTeX/distrib/goodies/latex-extra.tar.gz ctan/tex-archive/systems/unix/teTeX/distrib/goodies/metapost.tar.gz ctan/tex-archive/systems/unix/teTeX/distrib/goodies/pictex.tar.gz ctan/tex-archive/systems/unix/teTeX/distrib/goodies/pstricks.tar.gz ctan/tex-archive/systems/unix/teTeX/distrib/goodies/texdraw.tar.gz ctan/tex-archive/systems/unix/teTeX/distrib/goodies/xypic.tar.gzTous 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
sh ./install.sh
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
/home/john.q.public/teTeXet, 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
/home/john.q.public/texfontsou bien, si vous souhaitez rendre les polices générées accessibles à tous les utilisateurs du système, spécifiez un répertoire comme
/var/texfontsJe 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
export PATH=$PATH:"/home/john.q.public/teTeX/bin" export MANPATH=$MANPATH":/home/john.q.public/teTeX/man" export INFOPATH$=INFOPATH":/home/john.q.public/teTeX/info"à 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
texconfig confallpour 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.
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
ctan/tex-archive/systems/unix/teTeX/distrib/INSTALL.src ctan/tex-archive/systems/unix/teTeX/distrib/sources/README.texmf-src ctan/tex-archive/systems/unix/teTeX/distrib/sources/teTeX-lib-0.4pl8.tar.gz ctan/tex-archive/systems/unix/teTeX/distrib/sources/teTeX-src-0.4pl7.tar.gz
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,
set +o noclobberRemarquez 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 à
/home/john.q.public/teTeXLes 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
export PATH=$PATH":/home/john.q.public/teTeX/bin/i386-linux" export MANPATH=$MANPATH":/home/john.q.public/teTeX/man" export INFOPATH=$INFOPATH":/home/john.q.public/teTeX/info"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.
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
/usr/lib/teTeX/texmf/doc/tetexParcourez le fichier à l'aide de la commande (le chemin dans les exemples qui suivent est celui de la distribution Slackware) :
less /usr/lib/teTeX/texmf/doc/tetex/READMEou imprimez-le avec la commande
cat /usr/lib/teTeX/texmf/doc/tetex/README >/dev/lp0en 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 :
lpr /usr/lib/teTeX/texmf/doc/tetex/READMEVous 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
export TEXINPUTS=".:~/texinputs:"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 :
export PATH="~/tetex/bin:"$PATHÀ 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.