Page suivantePage précédenteTable des matières

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 :

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

ctan/tex-archive/systems/unix/teTeX/distrib/
Récupérez les fichiers
INSTALL.bin
install.sh
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

ctan/tex-archive/systems/unix/teTeX/distrib/base/latex-base.tar.gz
ctan/tex-archive/systems/unix/teTeX/distrib/base/tetex-base.tar.gz
Vous 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.gz
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
ctan/tex-archive/systems/unix/teTeX/distrib/binaries/i386-linuxaout.tar.gz
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

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.

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 :

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.gz
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
sh ./install.sh

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

/home/john.q.public/teTeX
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

/home/john.q.public/texfonts
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
/var/texfonts
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

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 confall
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

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 noclobber
Remarquez que l'argument +o de la commande setdé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/teTeX
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

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.

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

/usr/lib/teTeX/texmf/doc/tetex
Parcourez 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/README
ou imprimez-le avec la commande
cat /usr/lib/teTeX/texmf/doc/tetex/README>/dev/lp0
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 :

lpr /usr/lib/teTeX/texmf/doc/tetex/README
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

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.


Page suivantePage précédenteTable des matières