3 Installation et utilisation sous Unix

L’exploitation du CD-ROM TeX Live s’effectue de trois manières :

  1. Vous pouvez monter le CD-ROM sur votre système, changer votre PATH en conséquence, puis tout exécuter à partir du CD-ROM. Cela prend très peu d’espace disque et vous donne un accès immédiat à tout le contenu du CD-ROM. C’est une solution parfaitement acceptable par exemple pour des PC sous linux bien que les performances obtenues ne soient pas optimales.
  2. Vous pouvez installer une partie du système sur votre disque dur. C’est la plupart du temps le meilleur choix si vous disposez d’un espace disque suffisant (10 megabytes au minimum, mais 100 megabytes pour le système recommandé).
  3. Vous pouvez installer un jeu de composants choisi pour travailler sur un système TeX déjà présent ou sur un TeX Live que vous auriez déjà installé.

Chaque choix est décrit en détail dans les paragraphes qui suivent.


ATTENTION : Ce CD-ROM est au format ISO 9660 (High Sierra), avec les extensions « Rock Ridge and Joliet ». Votre système doit être capable de reconnaître ce type d’extensions pour une utilisation optimale du CD-ROM. Consultez votre documentation concernant la commande mount pour voir si c’est le cas. Si votre réseau local est constitué de machines différentes, regardez si vous pouvez monter le CD-ROM sur une machine qui supporte Rock Ridge et utiliser ce point de montage pour les autres machines.

Les systèmes Linux, FreeBSD, Sun, SGI et DEC Alpha ne devraient pas poser de problèmes d’utilisation du CD-ROM. Nous apprécierions beaucoup de de recevoir des conseils détaillés de la part d’utilisateurs ayant réussi l’installation sur d’autres systèmes pour les futures versions de cette documentation.

La suite de ce document suppose que vous avez installé et monté le CD-ROM avec une compatibilité Rock Ridge parfaite.


3.1 Executer TeX Live à partir du CD-ROM

L’organisation de Web2c induit que vous pourrez exécuter les programmes simplement en indiquant dans votre PATH le sous-répertoire approprié dans le répertoire bin du CD-ROM. Les fichiers nécessaires seront alors tous visibles sans autres modifications. La liste des systèmes proposés et des sous-répertoires correspondants sont les suivants :
DEC Alphaev5 OSF 4.0d alphaev5-osf4.0d
HP9000 HPUX 10.10 hppa2.0-hpux10.20
Intel x86 with GNU/Linux i386-linux
Intel x86 with FreeBSD ELF 3.4 i386-freebsd
SGI IRIX 6.5 mips-irix6.5
IBM RS 6000 AIX 4.2.* rs6000-aix4.2.1.0
Sun Sparc Solaris 2.7 sparc-solaris2.7
Windows 9X/2000/NT win32
Vous serez peut être ennuyé lors de création de fontes ou de changement de configuration par le fait que vous ne pouvez pas modifier les fichiers sur le CD-ROM. Cependant vous pouvez maintenir en parallèle une structure modifiable de répertoires TeX sur votre disque dur qui sera visitée avant l’arborescence du CD-ROM. Le chemin choisi par défaut est texmf-localconfig sur le CD-ROM (chemin qui n’existe pas !), donc vous devez l’écraser en définissant la variable d’environnement VARTEXMF.

Ainsi, les utilisateurs d’un PC avec un processeur Intel et sous Linux avec un environnement sh ou bash peuvent monter le CD-ROM TeX Live au point /cdrom avec la commande :


>> mount -t iso9660 /dev/cdrom /cdrom
Ensuite ils doivent désigner le répertoire contenant les fichiers exécutables correspondants à l’architecture donnée en initialisant la variable PATH.

  PATH=/cdrom/bin/i386-linux:$PATH
  export PATH
  VARTEXMF=/usr/TeX.local
  export VARTEXMF

Par commodité, ces commandes peuvent aussi être exécutées à partir du fichiers .profile.

En cas de doute, demandez de l’aide à l’administrateur système de votre réseau pour monter le CD-ROM ou pour vous indiquer le répertoire à utiliser pour votre système.

Les fichiers nécessaires au fonctionnement seront installés sur le disque dur la première fois où ils seront appelés. Il est recommandé d’exécuter dès le début le fichier texconfig pour tout mettre en place et vérifier si tout marche bien.

3.2 Installer TeX Live à partir du disque dur

Toutes les étapes nécessaires pour installer tout ou partie de la distribution sont réalisées en montant le CD-ROM puis en tapant à partir du répertoire racine :

>> sh install-cd.sh
(Sur certains systèmes Unix, vous devrez utiliser sh5 ou bash). Le programme d’installation commence par accéder à la liste des collections et des composants du CD-ROM puis essaie de deviner le système présent dans votre ordinateur. Il devrait commencer par vous retourner les messages suivants :

  Initializing collections... Done initializing.
  Counting selected collections... Done counting.
  Calculating disk space requirements for collections...Done calculating that.
  Initializing system packages... Done initializing system.

Ensuite il vous montrera un écran de contrôle principal (Figure 1), qui vous permettra de choisir 4 options :

  1. le type du système tournant sur votre ordinateur ou celui que vous avez décidé d’installer;
  2. la collection que vous voulez installer et à quel niveau : de base, recommendé ou autre;
  3. les répertoires du disque dur où il faut installer les fichiers;
  4. quelques options supplémentaires;

Vous choisissez les options en entrant au clavier une lettre ou un nombre suivi de return. Dans l’exemple, le système ELF sous linux est détecté. Par défaut, la collection de niveau recommendé est celle choisie ainsi que le répertoire /usr/local d’installation. Notons que l’espace disque requis pour l’installation choisie est affiché. Si vous faites l’installation suggérée, vous avez besoin d’environ 100 megabytes d’espace disque tandis que l’installation de base n’en a besoin que de 10 et vous pouvez ensuite l’enrichir avec les composants qui vous sont nécessaires.

À partir du répertoire d’installation choisi, le programme d’installation déposera les fichiers binaires dans un sous-répertoire de bin et les fichiers de support dans une arborescence ayant texmf pour répertoire de base.



  ==================> TeX Live installation procedure <================
  
  ==> Note: Letters/digits in <angle brackets> indicate menu items <===
  ==>       for commands or configurable options                   <===
  
   Proposed platform: Intel x86 with GNU/Linux
   <P> over-ride system detection and choose platform
   <C> collections:    24 out of 35, disk space required: 193176 kB
   <S> systems:         1 out of  8, disk space required:   8355 kB
                               total disk space required: 201531 kB
   <L> install level (1: basic, 2: recommended, 3: all): 2
   <D> directories:
     TEXDIR      (The main TeX directory)        : /usr/TeX
     TEXMFLOCAL  (Directory for local styles etc): /usr/TeX/texmf-local
     VARTEXMF (Directory for local config)       : /usr/TeX/texmf-var
   <O> options:
      [ ] alternate directory for generated fonts ()
      [ ] create symlinks in standard directories
      [ ] do not install macro/font doc tree
      [ ] do not install macro/font source tree
   <I> start installation,  <H> help,  <Q> quit
  
  Enter command:

Figure 1: écran de contrôle principal

          name            selection         size
    <1>   bibtex    [recommended]     7597 kB
    <2>   doc       [recommended]    21152 kB
    <3>   dvips     [recommended]      430 kB
    <4>   etex      [recommended]      102 kB
    <5>   fonts     [recommended]    51447 kB
    <6>   formats   [recommended]    14651 kB
    <7>   generic   [recommended]      459 kB
    <8>   graphics  [recommended]     9674 kB
    <9>   lang      [recommended]    19618 kB
    <U>   latex     [recommended]    23429 kB
    <V>   metapost  [recommended]     1443 kB
    <W>   omega     [recommended]     4986 kB
    <X>   pdftex    [recommended]      471 kB
    <Y>   plain     [recommended]     1113 kB
    <Z>   texlive   [recommended]    10155 kB
                             SUM:   166829 kB
  ==============================================================
    global commands: select <N>one / <B>asic / R<E>commended / <A>ll
                     for all collections
    <R>   return to platform menu
    <Q>   quit

Figure 2: Sélection des collections



  Collection: Fonts
  ===================================================
  
  Fonts, including metrics, virtual fonts and sources
  
  ===================================================
    <N>  No packages
    <B>  Basic packages                 [  1023 kB]
    <E>  Basic + Recommended packages   [ 51447 kB]
    <A>  All packages                   [127417 kB]
  
  ===================================================
    <R>   return to collection menu
    <Q>   quit
  
  Enter command:

Figure 3: Choix par l’utilisateur dans une collection

Les cases à cocher au niveau des options vous permettent de décider d’un autre endroit pour la création et l’écriture des fontes (permet de restreindre l’accès en lecture seulement de l’arborescence principal pour l’ensemble des utilisateurs) et permettent également de générer des liens symboliques vers les pages man et GNU d'information. Si vous choisissez <C> pour les collections, vous verrez apparaître la liste des collections disponibles, le niveau d’installation choisi et la place disque requise (Figure 2). Vous pouvez moduler les niveaux d’installations pour chaque collection de none jusqu’à all. Vous pouvez soit effectuer un choix pour toute les collections d’un coup, soit choisir un niveau pour une collection particulière (Figure 3).

Lorsque votre sélection est effectuée, retournez à l’écran principal et sélectionnez le démarrage de l’installation. Le programme d’installation considèrera chaque collection pour le système demandé, pointera la liste des fichiers sur le CD-ROM et construira la liste principale des fichiers à transférer. Ceux-ci seront copiés sur votre disque dur. Si vous avez demandé l’installation d’un système, une séquence d’initialisation se déclenchera (création de fichiers de format...). Lorsqu’elle sera terminée, il vous restera à indiquer à votre système d’exploitation le chemin pour trouver le sous répertoire bin de TeX en modifiant votre path et vous pourrez alors utiliser TeX. Si vous le voulez, vous pouvez déplacer d’un cran i.e. de /usr/local/bin/alpha-osf4.0 à /usr/local/bin. Si vous le faites cependant vous devez éditer le fichier texmf/web2c/texmf.cnf (voir Annexe 9) et changer la ligne qui se lit :


    TEXMFMAIN = $SELFAUTOPARENT

en


    TEXMFMAIN = $SELFAUTODIR

Si vous transférez les fichiers exécutables dans un autre répertoire vous devez alors éditer TEXMFMAIN pour indiquer explicitement le répertoire de base de l’arborescence et donner à la variable TEXMFCNF de votre environnement à $TEXMFMAIN/texmf/web2c.

3.3 Installation individuelle de composants TeX Live sur le disque dur

Vous voudrez peut être utiliser le CD-ROM TeX Live soit pour mettre à jour une installation existante, soit pour ajouter des éléments à une installation effectuée à partir du CD-ROM. Le programme d’installation est prévu pour la première installation seulement et vous devrez alors utiliser le programme install-pkg.sh de votre CD-ROM. Une fois le CD-ROM monté, déplacez-vous sur son répertoire racine et entrez :


>> sh install-pkg.sh options

L’installation supporte 9 options qui correspondent à : choisir les composants individuels à installer pour les 4 premières, installer la totalité de la collection (i.e.,ams2), saisir le nom du répertoire où le CD-ROM est monté, saisir le nom du répertoire contenant la liste des fichiers (normalement les 2 dernières options sont détectées automatiquement).

--package=name
--collection=name
--cddir=name
--listdir=name

L’exécution est contrôlée par 4 options supplémentaires : avec les 2 premières, vous pouvez exclure la documentation et les fichiers sources de l’installation. La suivante empêche l’exécution de mktexlsr prévue par défaut pour achever la reconstruction des bases de données et la dernière ne fait rien mais envoie la liste des fichiers qui seront installés.

--nodoc
--nosrc
--nohash
--listonly

Finalement, vous pouvez demander à ce que le programme crée dans un répertoire donné une archive tar au lieu de transférer les fichiers.

--archive=name

Donc, si vous voulez voir la liste des fichiers qui seraient créés par l’installation du composant fancyhdr, votre commande et la sortie seraient les suivantes :


>> sh install-pkg.sh --package=fancyhdr --listonly

texmf/doc/latex/fancyhdr/fancyhdr.dvi
texmf/doc/latex/fancyhdr/fancyhdr.tex
texmf/lists/latex3/fancyhdr
texmf/source/latex/fancyhdr/README
texmf/source/latex/fancyhdr/fancyheadings.new
texmf/tex/latex/fancyhdr/extramarks.sty
texmf/tex/latex/fancyhdr/fancyhdr.sty
texmf/tex/latex/fancyhdr/fixmarks.sty
On peut donner d’autres exemples d’utilisation :

3.4 Le programme texconfig

Une fois que le programme d’installation a transféré tous les fichiers vers leur place définitive, vous pouvez configurer votre système pour l’adapter à vos propres besoins en utilisant le programme texconøg. Il peut être appelé après chaque modification de votre installation et fonctionne en mode texte ou graphique (ce qui nécessite le programme dialog, fourni dans les composants binaires). Il doit-être utilisé pour toute maintenance, que ce soit pour l’installation d’une nouvelle imprimante ou pour la reconstruction d’une base de donnée. Les deux modes de fontionnement bénéficient d’un fichier d’aide destiné a vous guider.