Guide pratique de TEX Live
TEX Live 2008

Karl Berry
http://tug.org/texlive/
Version française
Daniel Flipo (GUTenberg)

Juillet 2008

Table des matières

1 Introduction
 1.1 TEX Live et TEX Collection
 1.2 Support pour différents systèmes d’exploitation
 1.3 Utilisation élémentaire de TEX Live
 1.4 Obtenir de l’aide
2 Structure de TEX Collection
 2.1 TEX Collection : TEX Live, proTEXt, MacTEX
 2.2 Répertoires situés à la racine de TEX Live
 2.3 Description des arborescences « texmf » de TEX Live
 2.4 Les extensions de TEX
 2.5 Quelques autres programmes intéressants dans TEX Live
 2.6 Fontes incluses dans TEX Live
3 Installation
 3.1 Démarrage de l’installation
  3.1.1 Installation sous Unix
  3.1.2 Installation sous Mac OS X
  3.1.3 Installation sous Windows
  3.1.4 Installation en mode texte
  3.1.5 Installation en mode graphique
 3.2 Choix des options d’installation
  3.2.1 Choix des binaires (Unix seulement)
  3.2.2 Choix des composants de l’installation
  3.2.3 Répertoires d’installation
  3.2.4 Options
  3.2.5 Utilisation de TEX Live à partir du DVD (mode texte uniquement)
 3.3 Options en ligne de commande
 3.4 Terminer l’installation
  3.4.1 Windows
  3.4.2 Cas où des liens symboliques sont créés
  3.4.3 Variables d’environnement Unix
  3.4.4 Variables d’environnement : configuration multi-utilisateur
  3.4.5 Exécution à partir du DVD
  3.4.6 ConTEXt Mark IV
  3.4.7 Ajout de fichiers locaux ou personnels
  3.4.8 Ajout de fontes externes à TEX Live
 3.5 Tester l’installation
4 Utilisation de TEX Live en réseau
5 TEX Live sur une machine hôte (DVD ou USB)
6 Maintenance de l’installation avec tlmgr
 6.1 tlmgr en mode graphique
 6.2 Exemples d’utilisation de tlmgr en ligne de commande
7 Spécificités Windows
 7.1 Installation
 7.2 Programmes supplémentaires
 7.3 Visualiseur Dviout
 7.4 Téléchargement de logiciels supplémentaires
 7.5 Répertoire personnel
 7.6 Base de registre Windows
 7.7 Droits d’accès sous Windows
8 Guide d’utilisation du système Web2C
 8.1 Kpathsea et la recherche de fichiers
  8.1.1 Les différentes sources
  8.1.2 Fichiers de configuration
  8.1.3 Expansion d’un chemin de recherche
  8.1.4 Expansion par défaut
  8.1.5 Expansion spécifiée par les accolades
  8.1.6 Expansion des sous-répertoires
  8.1.7 Liste des caractères spéciaux et de leur signification : récapitulatif
 8.2 Les bases de données
  8.2.1 Le fichier base de données
  8.2.2 kpsewhich : programme de recherche dans une arborescence
  8.2.3 Exemples d’utilisation
  8.2.4 Opérations de débogage
 8.3 Options à l’exécution
9 Installation sur un nouveau système Unix
 9.1 Prérequis
 9.2 Configuration
 9.3 Exécuter make
10 Remerciements
11 Historique des versions successives
 11.1 Les éditions précédentes
  11.1.1 2003
  11.1.2 2004
  11.1.3 2005
  11.1.4 2006–2007
 11.2 L’édition 2008
 11.3 Versions futures

1 Introduction

1.1 TEX Live et TEX Collection

Ce document décrit les principales caractéristiques de la distribution TEX Live, une distribution complète de TEX pour Linux et autres Unix, Mac OS X et systèmes Windows.

Cette distribution peut être obtenue par téléchargement ou sur le DVD TEX Collection distribué par les groupes d’utilisateurs de TEX à leurs membres. La section 2.1 décrit brièvement le contenu de ce DVD. TEX Live comme TEX Collection sont produits grâce au travail des groupes d’utilisateurs de TEX. La description qui suit porte essentiellement sur TEX Live.

La distribution TEX Live comprend les binaires pré-compilés de TEX, LaTeX2e, Metafont, MetaPost, BibTeX et de nombreux autres programmes ainsi qu’une bibliothèque étendue de macros, de fontes et de documentations. Elle traite aussi de la composition de textes dans la plupart des langues utilisées dans le monde.

Les composants de la distribution TEX Live sont régulièrement mis à jour sur le site CTAN, http://www.ctan.org.

On trouvera à la fin du document, section 11 (page 82), un bref historique des principales modifications apportées au fil du temps à la distribution TEX Live.

Les utilisateurs des éditions précédentes de TEX Live sont invités à lire, avant toute mise à jour, la section 11.2 page 89 qui présente les principaux changements intervenus cette année.

1.2 Support pour différents systèmes d’exploitation

TEX Live contient les exécutables pour les principales architectures Unix, en particulier Linux et Mac OS X. Les sources inclus dans la distribution devraient permettre de compiler les exécutables nécessaires aux autres systèmes d’exploitation.

En ce qui concerne Windows, seuls Windows 2000 et ses successeurs (XP, Vista) sont supportés ; les architectures antérieures (Windows 9x, ME et NT) ne le sont plus. Il n’y a pas d’exécutables 64-bit mais les versions 32-bit devraient fonctionner aussi sur les systèmes 64-bit.

Consulter la section 2.1 pour des solutions alternatives sous Windows et Mac OS X.

1.3 Utilisation élémentaire de TEX Live

Vous pouvez installer TEX Live de deux façons différentes : soit en utilisant l’installeur qui télécharge toute la distribution sur Internet, soit à partir du DVD ce qui ne nécessite pas de connexion au réseau.

Vous pouvez aussi exécuter TEX Live directement depuis le DVD (ou depuis une image iso du DVD si votre système le permet) sans (presque) rien installer sur le disque dur.

Ces trois utilisations sont décrites en détail dans les sections suivantes, voici quelques remarques générales pour débuter :

1.4 Obtenir de l’aide

La communauté TEX est à la fois active et conviviale ; la plupart des questions finissent par obtenir une réponse. Le support est pourtant informel, assuré par des volontaires et des lecteurs occasionnels, aussi est-il particulièrement important que vous fassiez votre propre travail de recherche avant de poser la question (si vous préférez un support commercial, vous pouvez renoncer à TEX Live et acheter un système payant ; voir une liste à http://tug.org/interest.html#vendors).

Voici une liste de ressources, classées selon l’ordre dans lequel nous recommandons de les utiliser :

Getting Started
– pour ceux qui débutent en TEX, la page web http://tug.org/begin.html contient une courte description du système.
FAQ TEX
– la FAQ TEX est un vaste recueil de réponses à toutes sortes de questions, de la plus élémentaire à la plus complexe. Elle est enregistrée sur le DVD dans texmf-doc/doc/english/FAQ-en/html/index.html et elle est disponible sur Internet à l’adresse http://www.tex.ac.uk/faq. Merci de consulter cette FAQ avant toute question.
Catalogue TEX
– si vous recherchez une extension, une fonte, un programme, etc., le mieux est de consulter le catalogue TEX ici : http://www.ctan.org/help/Catalogue/.
Ressources TEX sur le Web
– la page web http://tug.org/interest.html propose beaucoup de liens relatifs à TEX, en particulier concernant des livres, manuels et articles portant sur tous les aspects du système.
Archives des forums d’aide
– les principaux forums dédiés au support de TEX sont les groupes de news Usenet news:comp.text.tex (en anglais) et news:fr.comp.text.tex (en français) ainsi que les listes de diffusion texhax@tug.org (en anglais) et gut@ens.fr (en français). Les archives correspondantes contiennent des milliers de questions et réponses déjà traitées et permettent une recherche fructueuse. Voir http://groups.google.com/groups?group=fr.comp.text.tex et http://tug.org/mail-archives/texhax, respectivement. Une question posée sur un moteur de recherche, tel que http://google.com, peut aussi fournir des réponses pertinentes.
Poster une question
– si vous ne trouvez pas de réponse, vous pouvez poster la question à fr.comp.text.tex via Google ou votre lecteur de news, ou encore par messagerie à texhax@tug.org. Mais avant de le faire, merci de lire l’introduction de la FAQ donnant les conseils sur la façon de rédiger la question pour avoir des chances d’obtenir une réponse pertinente : http://www.tex.ac.uk/cgi-bin/texfaq2html?label=askquestion.
Support de TEX Live
– si vous voulez faire un rapport d’anomalie, émettre des suggestions ou des commentaires sur la distribution TEX Live, son installation ou sa documentation, utilisez la liste de diffusion tex-live@tug.org. Mais attention, si la question concerne l’utilisation d’un programme particulier inclus dans TEX Live, il vaut mieux que vous vous adressiez directement à la personne ou à la liste de diffusion qui maintient le programme. Il suffit souvent d’ajouter l’option --help lors de l’exécution du programme pour trouver à qui adresser le rapport.

L’autre aspect du sujet concerne l’aide à apporter aux personnes soumettant des questions. Les forums comp.text.tex, fr.comp.text.tex ainsi que les listes de diffusion texhax et gut sont ouverts à tous, aussi n’hésitez pas à vous y joindre, à commencer la lecture et à fournir de l’aide là où cela vous est possible.

2 Structure de TEX Collection

Nous décrivons ici le contenu de TEX Collection qui est un sur-ensemble de TEX Live.

2.1 TEX Collection : TEX Live, proTEXt, MacTEX

Le DVD TEX Collection contient les éléments suivants :

TEX Live
– un système TEX complet (TEX Live) qui peut au choix, être lancé à partir du DVD (sans installation) ou être installé sur le disque dur.
CTAN
– une image du site d’archives CTAN.
proTEXt
– une extension du système MiKTEX pour Windows qui en facilite l’installation. Cette distribution est totalement indépendante de TEX Live, elle nécessite un mode d’installation spécifique. Le site de ProTEXt se trouve ici : http://tug.org/protext.
MacTEX
– un programme d’installation spécifique de TEX Live pour Mac OS X et quelques applications propres au système Mac. Le site de MacTEX se trouve ici : http://www.tug.org/mactex/.
texmf-extra
– un répertoire contenant quelques extensions supplémentaires.

Les droits d’utilisation des fichiers présents dans CTAN, ProTEXt et texmf-extra diffèrent de ceux de TEX Live, pensez à lire les licences si vous envisagez de modifier ou de redistribuer certains de ces fichiers.

2.2 Répertoires situés à la racine de TEX Live

La distribution TEX Live est dans le sous-répertoire texlive du DVD TEX Collection. Les répertoires les plus importants situés à la racine de la distribution TEX Live sont énumérés ci-dessous :

bin

– programmes de la famille TEX, rangés dans des sous-répertoires selon les plates-formes.

readme.html

– une brève introduction et quelques liens utiles sous forme de pages html dans différentes langues.

source

– le code source de tous les programmes, incluant la distribution Web2C de TEX et Metafont.

support

– ensemble d’extensions et programmes auxiliaires (en particulier des éditeurs et des shells dédiés à TEX) ; ils ne sont pas installés par défaut.

texmf

– répertoire contenant les programmes et leur documentation ; ne contient ni les formats ni les extensions (la variable TEXMFMAIN de la section suivante pointe sur ce répertoire).

texmf-dist

– répertoire principal où se trouvent les extensions, les fontes, etc., avec leur documentation (la variable TEXMFDIST de la section suivante pointe sur ce répertoire).

texmf-doc

– répertoire contenant le reste de la documentation, le sous-répertoire doc est organisé par langue.

tlpkg

– scripts et programmes d’installation ; des versions de Perl et de Ghostscript (inaccessibles en dehors de TEX Live) ainsi qu’un nouveau visualiseur de fichiers PostScript ont été ajoutés pour Windows.

On trouve également, au même niveau que les répertoires mentionnés ci-dessus, les scripts d’installation et les fichiers README (disponibles dans différentes langues).

Le répertoire texmf-doc ne contient que de la documentation mais pas toute la documentation. Celle concernant les programmes (manuels, pages man et fichiers de type info est dans texmf/doc car les programmes correspondants sont dans texmf. De même, la documentation des extensions et formats est dans texmf-dist/doc. Les commandes texdoc ou texdoctk trouveront pour vous les documentations où qu’elles soient sur le disque. Le fichier doc.html du DVD contient une liste de liens bien utiles pour localiser les fichiers de documentation.

La documentation de TEX Live proprement dite est disponible dans le répertoire texmf-doc en plusieurs langues,

2.3 Description des arborescences « texmf » de TEX Live

Nous donnons ici la liste complète des variables prédéfinies qui contiennent les noms des différentes arborescences de type « texmf » et l’usage qui en est fait. La commande texconfig conf retourne les valeurs de ces variables, ce qui permet de savoir où se trouvent ces différentes arborescences dans une installation donnée.

TEXMFMAIN

– contient les éléments essentiels du système, comme les scripts (web2c/mktexdir, etc.), leur documentation mais pas les formats ni les fichiers de macros.–

TEXMFDIST

– contient les fichiers de macros (Plain, LATEX, ConTEXt, etc.,), les fontes, etc., de la distribution TEX Live ; rien ne devrait être ni ajouté ni supprimé dans cette arborescence.

TEXMFLOCAL

– c’est là que l’administrateur de la machine doit placer les classes et extensions locales, les fontes non disponibles dans TEX Live, etc.

TEXMFHOME

– contient les fichiers personnels (extensions, classes, fontes) de l’utilisateur ; ce répertoire est installé automatiquement dans le répertoire personnel de l’utilisateur.

TEXMFCONFIG

– c’est là que les scripts updmap et fmtutil recherchent leurs fichiers de configuration en priorité. texconfig y place les versions modifiées des fichiers de configuration. Sous TEXMFHOME par défaut.

TEXMFSYSCONFIG

– c’est là que les scripts updmap-sys et fmtutil-sys recherchent leurs fichiers de configuration en priorité. texconfig-sys y place les versions modifiées des fichiers de configuration.

TEXMFVAR

– c’est là que les scripts texconfig, updmap et fmtutil rangent les formats et les fichiers .map qu’ils produisent. Sous $HOME par défaut.

TEXMFSYSVAR

– c’est là que les scripts texconfig-sys, updmap-sys et fmtutil-sys rangent les formats et les fichiers .map qu’ils produisent.

La structure de l’arborescence TEX Live est par défaut la suivante :

racine multi-utilisateurs
(par exemple /usr/local/texlive, D:\texlive,...) qui contient éventuellement plusieurs distributions :
2007

– la distribution précédente,

...

2008

– la distribution actuelle,

bin

 

i386-linux

– exécutables Linux,

...

universal-darwin

– exécutables Mac OS X,

win32

– exécutables Windows,

texmf

– correspond à TEXMFMAIN,

texmf-dist

– correspond à TEXMFDIST,

texmf-doc

– correspond à TEXMFDOC,

texmf-var

– correspond à TEXMFSYSVAR,

texmf-config

– correspond à TEXMFSYSCONFIG,

texmf-local

– correspond à TEXMFLOCAL, normalement commun à plusieurs distributions TEX Live (2007, 2008, etc.),

répertoire personnel de l’utilisateur
$HOME ou %USERPROFILE% :
.texlive2007

– fichiers générés automatiquement par la distribution TEX Live précédente,

.texlive2008

– fichiers générés automatiquement par la distribution TEX Live actuelle,

texmf-var

– correspond à TEXMFVAR,

texmf-config

– correspond à TEXMFCONFIG,

texmf

– correspond à TEXMFHOME, répertoire regroupant tous les répertoires de macros personnelles : texmf/tex/latex par exemple pour les fichiers de macros LaTeX, etc.

2.4 Les extensions de TEX

TEX Live contient, à part TEX lui-même (le programme tex) qui est figé sauf rares corrections de bogues, plusieurs extensions de TEX.

e-TEX
ajoute un jeu de nouvelles primitives et les extensions TEX--XE T pour l’écriture de droite à gauche ; e-TEX est, en mode normal, 100% compatible avec TEX standard. Pour plus de détails consulter le fichier texmf-dist/doc/etex/base/etex_man.pdf du DVD.
pdfTEX
inclut les extensions e-TEX et produit, au choix, des fichiers au format Acrobat PDF ou au format DVI. C’est le moteur de base sur lequel sont construits tous les formats autres que plainTEX (voir http://www.pdftex.org/). Le manuel d’utilisation se trouve sur le DVD dans texmf/doc/pdftex/manual/. Le fichier texmf/doc/pdftex/pdftex/manual/samplepdf/samplepdf.tex donne des exemples d’utilisation.
LuaTEX
est le successeur de pdfTEX avec lequel il reste compatible. Il devrait également remplacer Aleph, voir ci-dessous. LuaTEX fait appel à l’interpréteur de commande Lua (voir http://www.lua.org/) qui apporte des solutions élégantes à beaucoup de problèmes épineux en TEX pur. La commande texlua, qui fonctionne comme un interpréteur Lua indépendant, est déjà utilisée en tant que telle dans TEX Live. Voir http://www.luatex.org/ et texmf-dist/doc/luatex/luatexref-t.pdf.
XeTEX
ajoute la possibilité d’utiliser en entrée le codage Unicode et en sortie les fontes OpenType et les fontes système de la machine, ceci grâce à des bibliothèques externes : voir http://scripts.sil.org/xetex.
Omega (Omega)
fonctionne en utilisant Unicode et des caractères 16 bits, ce qui lui permet de travailler directement et simultanément avec presque toutes les écritures du monde. L’extension supporte aussi le chargement dynamique d’OTP (Omega Translation Processes) qui permet à l’utilisateur d’appliquer sur des flux d’entrée quelconques des transformations complexes qu’il aura lui-même définies. Voir la documentation (pas vraiment à jour) dans texmf-dist/doc/omega/base/doc-1.8.tex.
Aleph
combine les fonctionnalités de Omega et de e-TEX. texmf-dist/doc/aleph/base contient une documentation de base.

2.5 Quelques autres programmes intéressants dans TEX Live

Voici quelques autres programmes couramment utilisés et présents dans TEX Live :

bibtex

– traitement de la bibliographie.

makeindex

– traitement des index.

dvips

– conversion DVI vers PostScript.

xdvi

– visualisation DVI pour le système X Window.

dvilj

– pilote DVI pour les imprimantes HP LaserJet.

dv2dt, dt2dv

– conversion DVI vers ou depuis du texte simple.

dviconcat, dviselect

– couper/Coller de pages à partir de fichiers DVI.

dvipdfmx

– conversion DVI vers PDF, une autre façon de produire des fichiers PDF, concurrente de pdfTEX mentionné ci-dessus ; voir aussi les extensions ps4pdf et pdftricks pour d’autres alternatives.

psselect, psnup, ...

– utilitaires PostScript.

lacheck

– vérification de syntaxe LATEX.

texexec, texmfstart

– processeurs ConTEXt et PDF.

tex4ht

– conversion TEX vers HTML et XML.

2.6 Fontes incluses dans TEX Live

La distribution TEX Live contient un grand nombre de fontes vectorielles de haute qualité : voir http://tug.org/fonts et texmf-doc/english/free-math-fonts-survey.

3 Installation

3.1 Démarrage de l’installation

La première chose à faire est de récupérer le DVD TEX Collection ou de télécharger le programme d’installation par le réseau. Le programme d’installation s’appelle install-tl pour Unix et install-tl.bat pour Windows.

Installeur réseau
– à télécharger sur CTAN dans systems/texlive/tlnet ; l’url http://mirror.ctan.org/systems/texlive/tlnet vous redirigera automatiquement vers le serveur d’archive le plus proche de chez vous. Deux versions sont disponibles, install-tl.zip utilisable sous Unix et sous Windows et install-unx.tar.gz pour Unix seulement (y compris Mac OS X). Après décompression de l’un de ces deux fichiers, les scripts install-tl et install-tl.bat se trouveront dans le sous-répertoire install-tl.
DVD TEX Collection
– aller dans le répertoire texlive. Sous Windows, l’installation démarrera probablement automatiquement quand vous insérerez le DVD, sinon, il faudra lancer le script d’installation install-tl ou install-tl.bat. Le DVD TEX Collection est distribué gratuitement aux membres des groupes d’utilisateurs de TEX (Gutenberg par exemple en France, voir la liste des groupes sur http://tug.org/usergroups.html). Il est également possible de l’acheter séparément (http://tug.org/store) ou de graver l’image ISO (http://tug.org/texlive/acquire.html).

Les sections suivantes détaillent le processus d’installation.


  ======================> TeX Live installation procedure <=====================
  
  =======> Note: Letters/digits in <angle brackets> indicate menu items <=======
  =======>       for commands or configurable options                   <=======
  
  
   Detected platform: Intel x86 with GNU/Linux
  
   <B> binary systems: 1 out of 16
  
   <S> Installation scheme (scheme-full)
  
   Customizing installation scheme:
     <C> standard collections
     <L> language collections
     83 collections out of 84, disk space required: 1666 MB
  
   <D> directories:
     TEXDIR (the main TeX directory):
       !! default location: /usr/local/texlive/2008
       !! is not writable, please select a different one!
     TEXMFLOCAL (directory for site-wide local files):
       /usr/local/texlive/texmf-local
     TEXMFSYSVAR (directory for variable and automatically generated data):
       /usr/local/texlive/2008/texmf-var
     TEXMFSYSCONFIG (directory for local config):
       /usr/local/texlive/2008/texmf-config
     TEXMFHOME (directory for user-specific files):
       ~/texmf
  
   <O> options:
     [ ] use letter size instead of A4 by default
     [X] create all format files
     [X] install macro/font doc tree
     [X] install macro/font source tree
     [ ] create symlinks in standard directories
  
   <V> Install for running from DVD
  
  Other actions:
   <I> start installation to HD
   <H> help
   <Q> quit
  
  Enter command:

Figure 1: Écran principal de configuration (GNU/Linux)



pict

Figure 2: Écran principal de configuration (Windows)


3.1.1 Installation sous Unix

Dans ce qui suit l’invite du shell est notée > ; les commandes de l’utilisateur sont en gras. Commandes à lancer dans un terminal sur tout système Unix pour travailler en mode texte :

> cd /chemin/de/installeur
> perl install-tl

Pour travailler en mode graphique :

> cd /chemin/de/installeur
> ./install-tl -gui

La liste complète des options est donnée par

> perl install-tl -help

Attention : le matériel installé doit normalement être accessible à tous les utilisateurs de la machine ; si celui qui installe n’est pas root, il devra s’assurer que son umask est adapté, par exemple umask 022 ou umask 002. Consulter la documentation système pour plus de précisions.

3.1.2 Installation sous Mac OS X

Une distribution spécifique, MacTEX (http://tug.org/mactex), a été mise au point pour Mac OS X. Nous recommandons de l’utiliser plutôt que d’installer la distribution TEX Live en suivant la procédure indiquée pour Unix.

En effet, MacTEX permet des ajustements spécifiques pour le système Mac OS X et facilite la cohabitation entre plusieurs distributions TEX (MacTEX, gwTEX, Fink, MacPorts, ...).

MacTEX est très proche de TEX Live, les arborescences principales sont en tous points identiques, quelques répertoires contenant de la documentation et des applications spécifiques au Mac sont ajoutés.

3.1.3 Installation sous Windows

Si vous utilisez l’installeur réseau ou si l’insertion du DVD ne lance pas l’installation automatiquement, double-cliquez sur install-tl.bat.

Il est également possible de travailler en ligne de commande ; dans ce qui suit l’invite du shell est notée >, les commandes de l’utilisateur sont notées en gras. Voici les commandes à lancer :

> install-tl
à condition d’être dans répertoire du script d’installation, sinon

> D:\texlive\install-tl
D : désigne le lecteur de DVD.

Pour travailler en mode texte :

> install-tl -no-gui
La liste complète des options est donnée par

> install-tl -help

3.1.4 Installation en mode texte

La figure 1 page 16 présente l’écran principal de configuration en mode texte sous Unix/Linux.

Taper une des lettres proposées (en respectant la casse) suivie de « Entrée » (retour-chariot), l’écran se mettra automatiquement à jour.

L’interface est volontairement rudimentaire afin de permettre son utilisation sur le plus grand nombre possible de systèmes même avec des versions très dépouillées de Perl (un sous-ensemble de commande Perl est fourni pour Windows).

3.1.5 Installation en mode graphique

La figure 2 page 19 présente l’écran principal de configuration en mode graphique sous Windows. Les différences entre les options disponibles en mode texte et en mode graphique s’expliquent par le changement de système (GNU/Linux pour le premier, Windows pour le second).

3.2 Choix des options d’installation

Les options proposées sont censées être assez explicites, voici cependant quelques précisions.

3.2.1 Choix des binaires (Unix seulement)


  Available sets of binaries:
  ===============================================================================
  
     a [ ] alpha-linux      DEC Alpha with GNU/Linux
     b [ ] amd64-freebsd    x86_64 with FreeBSD
     c [ ] hppa-hpux        HP-UX
     d [ ] i386-freebsd     Intel x86 with FreeBSD
     e [X] i386-linux       Intel x86 with GNU/Linux
     f [ ] i386-openbsd     Intel x86 with OpenBSD
     g [ ] i386-solaris     Intel x86 with Sun Solaris
     h [ ] mips-irix        SGI IRIX
     i [ ] powerpc-aix      PowerPC with AIX
     j [ ] powerpc-linux    PowerPC with GNU/Linux
     k [ ] sparc-linux      Sparc with GNU/Linux
     l [ ] sparc-solaris    Sparc with Solaris
     m [ ] universal-darwin universal binaries for MacOSX/Darwin
     o [ ] win32            Windows
     p [ ] x86_64-linux     x86_64 with GNU/Linux

Figure 3: Menu pour le choix des binaires


La figure 3 présente les choix de binaires possibles en mode texte. Seuls les binaires correspondant à l’architecture détectée seront installés par défaut. Rien n’empêche d’en sélectionner d’autres si nécessaire, ce qui peut être intéressant dans le cas de serveurs en réseau ou sur des machines en « double boot ».

3.2.2 Choix des composants de l’installation


  Select a scheme:
  ===============================================================================
  
   a [ ] TeX Live basic scheme
   b [ ] TeX Live scheme for ConTeXt
   c [X] TeX Live full scheme
   d [ ] GUST TeX Live scheme
   e [ ] GUTenberg TeX Live scheme
   f [ ] TeX Live medium scheme
   g [ ] TeX Live minimal scheme
   h [ ] TeX Live for Omega users
   i [ ] teTeX scheme
   j [ ] XML typesetting scheme

Figure 4: Menu « Scheme »


Dans le menu « Scheme » (voir figure 4) on choisit un schéma général de configuration qui détermine un ensemble de collections à installer. Par défaut, on procède à l’installation de tout ce qui est disponible (option scheme-full). Des installations plus ou moins complètes sont proposées : minimal pour effectuer des tests uniquement, basic pour un système de base, medium ou teTeX pour des systèmes intermédiaires. Pour les francophones, l’option GUTenberg est une bonne base de départ. Le choix pourra être affiné à l’étape suivante.


pict

Figure 5: Menu « Collections » (Linux)


Une fois choisi le schéma général, il est possible de d’ajouter ou de supprimer des composants, appelés ici collections. Il y a deux types de collections : les « Standard Collections » qui concernent les fontes, les extensions, les formats, etc. (voir figure 5) et les « Language Collections » qui permettent de préciser la liste des langues qui seront utilisables sur le système (indispensable !). Attention, si vous travaillez en mode texte, dans ces menus la casse des lettres est importante. En mode graphique, il suffit de cocher ou de décocher les cases en cliquant.

Il est possible de raffiner encore les choix mais il faudra alors utiliser le programme tlmgr ultérieurement, voir la section 6.

3.2.3 Répertoires d’installation

La racine de l’installation principale est donnée par TEXDIR qui vaut par défaut /usr/local/texlive/2008 sous Unix et %PROGRAMFILES%\texlive\2008 sous Windows. La liste des sous-répertoires de TEXDIR choisis par défaut est donnée à la section 2.3, page 10.

Il peut être nécessaire de changer la valeur de TEXDIR lorsque celui qui procède à l’installation n’a pas les droits d’écriture sur le répertoire TEXDIR (l’installation n’est pas réservée au super-utilisateur « root » ou « Administrateur »). Il est possible d’installer TEX Live dans le répertoire personnel d’un utilisateur, dans ce cas on peut choisir par exemple ~/texlive/2008.

Dans tous les cas, il est recommandé d’inclure l’année dans le chemin afin de pouvoir conserver plusieurs versions de TEX Live en parallèle. Rien n’empêche d’ajouter un lien symbolique (par exemple /usr/local/texlive-current) qui pointe sur la version actuellement utilisée. Ceci facilite les basculements d’une version à une autre.

Le répertoire TEXMFHOME (~/texmf par défaut) est destiné à regrouper les répertoires de macros personnelles. Le caractère ~ désignant le répertoire personnel est traité différemment, selon qu’il est utilisé dans TEXDIR – il s’agit alors du répertoire de l’installateur – ou dans TEXMFHOME, là ~ est traité dynamiquement utilisateur par utilisateur est vaut $HOME sous Unix et %USERPROFILE% sous Windows.

3.2.4 Options


  <P> use letter size instead of A4 by default: [ ]
  <F> create all format files:                  [X]
  <D> install font/macro doc tree:              [X]
  <S> install font/macro source tree:           [X]
  <L> create symlinks in standard directories:  [ ]
             binaries to:
             manpages to:
                 info to:

Figure 6: menu « Options » (Unix)


La figure 6 présente le menu « Options » en mode texte. Normalement il n’y a pas lieu de modifier les choix par défaut. Voici quelques précisions cependant.

use letter size instead of A4 by default
– la taille du papier pour l’impression est A4, il est possible de la changer ici, en letter par exemple.
create all format files
– création de tous les formats à l’installation. Bien que cette opération prenne un peu de temps, il est conseillé de ne pas la supprimer, sinon les formats seront créés au coup par coup dans les répertoires personnels des utilisateurs (sous TEXMFVAR). Les formats personnels ainsi créés ne bénéficieront pas des mises à jour éventuelles effectuées ultérieurement sur l’installation TEX Live, ce qui peut engendrer des incompatibilités.
create symlinks in standard directories
(Unix seulement) – cette option permet d’éviter de modifier les variables d’environnement PATH, MANPATH et INFOPATH. En revanche, elle peut perturber une installation TEX incluse dans votre distribution (Debian, RedHat, etc.). La modification des trois variables d’environnement ci-dessus est préférable.

Lorsque vous êtes satisfait des réglages faits, il vous reste à taper I pour lancer le processus d’installation. Lorsque celui-ci sera terminé, sautez à la section 3.4 pour voir s’il y a d’autres choses à faire.

3.2.5 Utilisation de TEX Live à partir du DVD (mode texte uniquement)

Taper ‘V’ pour choisir ce mode de fonctionnement, le menu qui s’affiche alors est présenté figure 7.


  ======================> TeX Live installation procedure <=====================
  
  =======> Note: Letters/digits in <angle brackets> indicate menu items <=======
  =======>       for commands or configurable options                   <=======
  
   <D> directories:
     TEXDIRW (Writable root):
       !! default location: /usr/local/texlive/2008