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
       !! 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
  
   <V> set up for installing to hard disk
  
  Other actions:
   <I> start installation for running from DVD
   <H> help
   <Q> quit

Figure 7: Menu principal après choix de l’option « running from DVD »


Noter les changements : toutes les options concernant le choix du matériel à installer, les liens symboliques, ont disparu. Le menu « Directories » parle maintenant de TEXDIRW (racine accessible en écriture).

L’exécution de TEX Live à partir du DVD nécessite la création de quelques répertoires mais un minimum de fichiers sont installés sur le disque dur.

La configuration après installation pour Unix est un peu plus complexe, voir section 3.4.

Faute de temps, cette option n’a pu être intégrée à l’interface graphique. Elle reste utilisable en mode texte y compris sous Windows, voir section 3.3.

La section 5 décrit une autre façon d’utiliser TEX Live à partir du DVD. Elle ne nécessite aucune modification du système mais ne permet aucune personnalisation.

3.3 Options en ligne de commande

Taper

> install-tl -help
pour obtenir la liste de toutes les options disponibles. Voici les principales :

-gui

– exécution en mode graphique (si possible). Ceci nécessite le module Perl/Tk (http://tug.org/texlive/distro.html#perltk) ; si Perl/Tk n’est pas disponible, l’installation se poursuit en mode texte.

-no-gui

– exécution en mode texte, même sous Windows ; ceci est utile pour exécuter TEX Live à partir du DVD (option non disponible en mode graphique).

-lang LL

– impose la langue utilisée dans les menus lors de l’installation. Le code de langue comporte deux lettres. Sont actuellement disponibles les langues suivantes : : anglais (en, langue par défaut), allemand (de), français (fr), néerlandais (nl), polonais (pl), Slovène (sl) et vietnamien (vi). Le programme s’efforce de déterminer automatiquement la langue à utiliser et se rabat sur l’anglais en cas d’échec.

-profile profile

– à chaque exécution, le script d’installation écrit un compte-rendu dans le fichier texlive.profile du répertoire 2008/tlpkg ou tlpkg. L’option -profile demande au script de réutiliser le fichier texlive.profile. En voici un extrait :

  # texlive.profile written on Wed Jul  9 16:13:44 2008 UTC
  # It will NOT be updated and reflects only the
  # installation profile at installation time.
  selected_scheme scheme-basic
  TEXDIR /usr/local/texlive/2008
  TEXDIRW /usr/local/texlive/2008
  ...
  TEXMFSYSVAR /usr/local/texlive/2008/texmf-var
  collection-basic 1
  ...
  option_symlinks 0

Il est ainsi facile de reproduire un même scéma d’installation sur plusieurs machines.

-location url/path

– choix d’une source où récupérer le matériel à installer.

L’argument de l’option url/path peut être une url commençant par ftp :, http :, ou file :/ ou bien un chemin local.

Si l’argument correspond à un chemin local (ou une url de type file :/), le script recherche un sous-répertoire archive contenant des fichiers compressés .tar.lzma, ceux-ci seront utilisés en priorité.

Si l’argument est une url distante (http : ou ftp :) le ‘/’ final ainsi que la chaîne ‘/tlpkg’ sont ignorés. Par exemple, le choix du miroir CTAN http://mirrors.ircam.fr/pub/CTAN/systems/texlive/tlnet/2008/ est valide. La liste des miroirs CTAN est ici : http://ctan.org/mirrors.

Lorsqu’aucune option -location n’est spécifiée, le script d’installation choisit un miroir automatiquement, celui-ci servira pour tout le téléchargement.

3.4 Terminer l’installation

Selon les cas quelques opérations supplémentaires peuvent être nécessaires.

3.4.1 Windows

Sous Windows, le programme d’installation s’occupe de tout (normalement).

3.4.2 Cas où des liens symboliques sont créés

Si vous avez opté pour l’option créant des liens symboliques (voir section 3.2.4), il n’est pas nécessaire d’ajuster les variables d’environnement.

3.4.3 Variables d’environnement Unix

Le chemin des binaires correspondant à votre machine doit être ajouté à la variable PATH. À chaque architecture correspond un sous-répertoire de TEXDIR/bin, voir la liste à la figure 3 24.

Si vous voulez que votre système trouve les fichiers de documentation concernant TEX Live, il faut également ajuster les variables MANPATH et INFOPATH.

Pour les shells dits « Bourne-compatible » tels que bash sous GNU/Linux, le fichier à éditer peut être $HOME/.bash_profile ou $HOME/.profile et les lignes à ajouter sont de la forme suivante :

  PATH=/usr/local/texlive/2008/bin/i386-linux:$PATH; export PATH
  MANPATH=/usr/local/texlive/2008/texmf/doc/man:$MANPATH; export MANPATH
  INFOPATH=/usr/local/texlive/2008/texmf/doc/info:$INFOPATH; export INFOPATH

Pour les shells csh ou tcsh, le fichier à éditer est en principe $HOME/.cshrc et les lignes à ajouter sont de la forme suivante :

  setenv PATH /usr/local/texlive/2008/bin/i386-linux:$PATH
  setenv MANPATH /usr/local/texlive/2008/texmf/doc/man:$MANPATH
  setenv INFOPATH /usr/local/texlive/2008/texmf/doc/info:$INFOPATH

3.4.4 Variables d’environnement : configuration multi-utilisateur

Il est possible d’ajuster les variables PATH, MANPATH et INFOPATH globalement pour tous les utilisateurs présents et futurs sans avoir à éditer les fichiers personnels de chacun mais les façons de le faire sont trop différentes d’un système à l’autre pour être présentées ici.

Voici quelques pistes : pour MANPATH chercher un fichier /etc/manpath.config, s’il est présent lui ajouter des lignes du genre

  MANPATH_MAP /usr/local/texlive/2008/bin/i386-linux \
              /usr/local/texlive/2008/texmf/doc/man

Pour les deux autres, chercher un fichier/etc/environment, il est éventuellement possible d’y définir les valeurs des variables d’environnement telles que PATH et INFOPATH.

3.4.5 Exécution à partir du DVD

Les programmes de TEX Live consultent le fichier texmf.cnf pour savoir dans quelles arborescences se trouvent les fichiers dont ils ont besoin. Malheureusement, ceci ne fonctionne pas lorsque les programmes sont lancés à partir d’un DVD ; en effet certains chemins ne sont connus qu’à l’installation et ne peuvent être inscrits sur le DVD puisqu’il est accessible uniquement en lecture. Il faut donc créer un fichier texmf.cnf sur le disque et préciser où il se trouve grâce à la variable d’environnement TEXMFCNF. Ceci ne dispense pas de modifier la variable d’environnement PATH comme indiqué ci-dessus.

Le script d’installation affiche en fin de traitement, un message indiquant la valeur à donner à la variable TEXMFCNF. Si ce message vous a échappé, cette valeur est $TEXMFSYSVAR/web2c, qui vaut par défaut /usr/local/texlive/2008/texmf-var/web2c.

Voici les lignes à taper dans ce cas :

  TEXMFCNF=/usr/local/texlive/2008/texmf-var/web2c; export TEXMFCNF

ou pour [t]csh :

  setenv TEXMFCNF /usr/local/texlive/2008/texmf-var/web2c

3.4.6 ConTEXt Mark IV

L’ancien ConTEXt devrait fonctionner sans problème. La nouvelle version, appelée « Mark IV » demande un peu de configuration spécifique, voir http://wiki.contextgarden.net/Running_Mark_IV.

3.4.7 Ajout de fichiers locaux ou personnels

Comme cela a déjà été indiqué à la section 2.3, TEXMFLOCAL (par défaut /usr/local/texlive/texmf-local ou C:\Program Files\texlive\texmf-local) est la racine de l’arborescence prévue pour regrouper les fichiers de macros, les fontes et le matériel utilisable par l’ensemble des utilisateurs du système. D’autre part TEXMFHOME (par défaut $HOME/texmf (ou %USERPROFILE%\texmf) regroupe le matériel personnel de chaque utilisateur.

Dans les deux cas, les fichiers ajoutés doivent être placés, non pas en vrac à la racine de TEXMFLOCAL ou TEXMFHOME mais dans des sous-répertoires bien choisis (voir http://tug.org/tds ou lire le fichier texmf.cnf). Par exemple, une classe ou une extension LATEX ne sera trouvée que si elle est dans TEXMFLOCAL/tex/latex ou TEXMFHOME/tex/latex ou dans un sous-répertoire de ceux-ci.

Enfin, si les ajouts ont été faits sous TEXMFLOCAL, il y a lieu de régénérer les bases de données ls-R (commande mktexlsr ou bouton « Reinit file database » du programme tlmgr en mode graphique).

L’emplacement des répertoires TEXMFLOCAL et TEXMFHOME est fixe (il ne change pas d’une version à l’autre de TEX Live). Leur contenu est pris en compte par toutes les versions de TEX Live aussi est-il préférable de ne pas changer la valeur des variables TEXMFLOCAL et TEXMFHOME à l’installation.

3.4.8 Ajout de fontes externes à TEX Live

Cette question est malheureusement trop complexe pour être abordée ici. Renoncez-y sauf si connaissez bien les arcanes d’une installation TEX. Vérifiez en premier lieu ce qui existe déjà en libre : voir la section 2.6.

Une alternative possible est d’utiliser XeTEX (voir section 2.4) qui permet l’accès aux fontes disponibles sur le système sans aucune installation supplémentaire.

3.5 Tester l’installation

Une fois l’installation de TEX Live terminée, il faut la tester avant de créer des documents ou des fontes. Les tests doivent être faits par un utilisateur non privilégié (autre que root).

On donne ici quelques procédures de base pour vérifier que le nouveau système est opérationnel. On les décrit pour Unix ; pour Mac OS X ou Windows, il vaut mieux tester au travers d’une interface graphique mais les principes sont les mêmes.

  1. S’assurer en premier lieu que le programme tex fonctionne :

    > tex --version
    TeX 3.1415926 (Web2C 7.5.7)
    kpathsea version 3.5.7
    ...

    Si la réponse est command not found ou si le numéro de version est différent, il est fort probable que vous n’avez pas le bon répertoire de binaires dans votre PATH. Voir les informations sur l’environnement page 38.

  2. Traiter un fichier LATEX simple :

    > latex sample2e.tex
    This is pdfeTeXk, Version 3.1415926...
    ...
    Output written on sample2e.dvi (3 pages, 7484 bytes).
    Transcript written on sample2e.log.
    Si le fichier sample2e.tex ou d’autres ne sont pas trouvés, il y a probablement des interférences avec vos anciennes variables d’environnement ou fichiers de configuration. Pour analyser en détail votre problème, vous pouvez demander à TEX de dire exactement ce qu’il cherche et trouve ; voir la section 8.2.4 page 72.
  3. Prévisualiser les résultats en ligne :

    > xdvi sample2e.dvi
    Sous Windows, la commande équivalente est dviout. Une nouvelle fenêtre doit s’ouvrir et montrer un joli document expliquant les bases de LATEX (document dont la lecture attentive est recommandée si vous êtes débutant !). Vous devez travailler sous X pour que xdvi fonctionne. Sinon, votre variable d’environnement DISPLAY n’est pas correcte et vous aurez une erreur « Can’t open display ».
  4. Créer un fichier PostScript pour l’imprimer ou l’afficher :

    > dvips sample2e.dvi -o sample2e.ps
  5. Créer un fichier PDF au lieu de DVI ; cet exemple traite le fichier sample2e.tex et crée directement du PDF :

    > pdflatex sample2e.tex
  6. Prévisualiser le fichier PDF :

    > gv sample2e.pdf
    ou
    > xpdf sample2e.pdf

    Hélas, ni gv ni xpdf ne sont actuellement inclus dans TEX Live, aussi devez-vous les installer séparément si ce n’est déjà fait. Voir respectivement http://www.gnu.org/software/gv et http://www.foolabs.com/xpdf (il y a bien d’autres lecteurs de fichiers PDF).

  7. Autres fichiers de tests utiles en plus de sample2e.tex :

    small2e.tex

    à compiler avant sample2e si celui-ci pose des problèmes.

    testpage.tex

    teste que l’imprimante n’introduit pas de décalages.

    nfssfont.tex

    imprime des tables des fontes et des tests.

    testfont.tex

    aussi pour les tables de fontes mais en (plain)TEX.

    story.tex

    le fichier de test de (plain)TEX le plus canonique de tous. Il faut taper « \bye » à la commande * après « tex story.tex ».

    Pour exécuter ces tests procéder comme pour sample2e.tex.

Si vous êtes débutant ou si vous avez besoin d’aide pour réaliser des documents TEX ou LATEX, n’hésitez pas à consulter http://tug.org/begin.html. On vous recommande également l’introduction à LATEX de Tobias Oetiker dans sa version anglaise (la version française n’est plus à jour) disponible après installation sous texmf-doc/doc/english/lshort-english/lshort.pdf.

4 Utilisation de TEX Live en réseau

TEX Live a été conçu comme un système multi-utilisateurs capable de fonctionner en réseau. Un même serveur peut proposer la distribution TEX Live à différentes machines, éventuellement d’architectures différentes, il suffit que le serveur possède les répertoires de binaires adéquats.

La seule chose à faire par chaque utilisateur local ou distant est d’ajouter le chemin des exécutables correspondant à son architecture dans son PATH1.

Ceci fonctionne parce que les répertoires de recherche des fichiers utilisés par TEX Live (TEXMFMAIN, TEXMFDIST, TEXMFSYSVAR, TEXMFSYSCONFIG et TEXMFLOCAL sont définis relativement aux exécutables lors de l’installation (voir dans le fichier TEXMFMAIN/web2c/texmf.cnf le rôle de la variable $SELFAUTOPARENT).

Cette disposition permet aussi de faire une installation sur une machine et de la déplacer après coup sur un serveur, la seule chose à changer est le contenu de la variable PATH.

Ce qui précède vaut pour les utilisateurs d’Unix. Pour ceux qui sont sous Windows, le répertoire texmf-doc/source/texlive/texlive-common/w32client contient un exemple de script install-w32client qui permet de partager une installation TEX Live à travers un réseau local. Il se lance par l’intermédiaire du fichier « batch » install-w32client.bat qui se trouve dans le même répertoire.

De plus amples informations sur la configuration de TEX Live et sur la recherche de fichiers sont disponibles à la section 8.1.

5 TEX Live sur une machine hôte (DVD ou USB)

L’utilisation de TEX Live à partir du DVD décrite à la section 3.2.5 impose la création de quelques répertoires sur le disque dur, ce qui n’est pas gênant sur une machine personnelle. En revanche, lorsqu’on travaille sur une machine hôte, il est préférable de limiter les ajouts et modifications à faire sur le disque dur.

Les scripts tl-portable (pour Unix) et tl-portable.bat pour Windows, présents à la racine de TEX Live (ou dans le répertoire texlive du DVD TEX Collection) facilitent l’utilisation de TEX Live sur des machines hôtes. Lors de leur première exécution, ces scripts créent un répertoire ~/.tlportable2008 contenant divers fichiers de configuration qui permettront l’accès à la distribution TEX Live du DVD. Ceci peut prendre un peu de temps mais lors des exécutions suivantes le démarrage est presque immédiat. Rien n’est modifié sur la machine en dehors du répertoire ~/.tlportable2008.

Pour qu’un éditeur prenne en compte la distribution TEX Live du DVD, il suffit de le lancer par l’intermédiaire du script tl-portable.

Le script tl-portable est utile aussi pour créer une distribution TEX Live sur une clé USB. Pour ce faire, copier sur la clé les fichiers et les répertoires situés à la racine de TEX Live (au moins bin, texmf, texmf-dist et tlpkg). Si la clé est formatée en FAT32, attention aux liens symboliques (utiliser cp -L pour copier). Il est possible d’ajouter un répertoire texmf-local sur la clé, il sera pris en compte à l’exécution. Il reste à lancer le script tl-portable à la racine de la clé comme ci-dessus ; celle-ci étant accessible en écriture, lors des exécutions de TEX Live tous les fichiers seront créés sur elle et rien ne sera écrit sur le disque dur.

6 Maintenance de l’installation avec tlmgr


pict

Figure 8: tlmgr en mode graphique (après clic sur le bouton « Load »).



pict

Figure 9: tlmgr en mode graphique, onglet « configuration »


Un nouveau programme appelé tlmgr est installé avec la distribution TEX Live. Il fournit une interface conviviale pour la maintenance de la distribution. Les programmes updmap, fmtutil et texconfig ont été conservés et le seront à l’avenir bien que tlmgr soit appelé à devenir l’interface standard de configuration. tlmgr permet en particulier

Attention : tlmgr ne doit pas être utilisé lorsque TEX Live est exécuté à partir du DVD (sans installation sur le disque dur).

6.1 tlmgr en mode graphique

tlmgr est lancé en mode graphique par la commande

> tlmgr -gui
ou sous Windows dans le menu « Démarrer » : Démarrer Programmes TeX Live 2008 TeX Live Manager.

La première chose à faire est de cliquer sur le bouton « Load 2 » ce qui affiche la liste des collections, extensions, etc. ; le préfixe (i) indique celles qui sont déjà installées.

La figure 9 présente l’onglet « configuration ».

6.2 Exemples d’utilisation de tlmgr en ligne de commande

Premier exemple : ajout de la collection « xetex » et de l’extension « xkeyval » qui devront être téléchargées à partir d’un site spécifié. La commande

> tlmgr -location http://172.16.18.1/tldev install collection-xetex xkeyval
retourne
  install: collection-xetex
  install: arabxetex
  install: euenc
  install: bidi
  install: fontspec
  install: fontwrap
  install: ifxetex
  install: philokalia
  install: polyglossia
  install: xecyr
  install: xecyr.i386-linux
  install: xepersian
  install: xetex
  install: xetexconfig
  install: xetex.i386-linux
  running post install action for xetex
  install: xetex-def
  install: xetex-pstricks
  install: xetexfontinfo
  install: xltxtra
  install: xunicode
  install: xkeyval
  running mktexlsr
  mktexlsr: Updating /usr/local/texlive/2008/texmf/ls-R...
  mktexlsr: Updating /usr/local/texlive/2008/texmf-config/ls-R...
  mktexlsr: Updating /usr/local/texlive/2008/texmf-dist/ls-R...
  mktexlsr: Updating /usr/local/texlive/2008/texmf-doc/ls-R...
  mktexlsr: Updating /usr/local/texlive/2008/../texmf-local/ls-R...
  mktexlsr: Updating /usr/local/texlive/2008/texmf-var/ls-R...
  mktexlsr: Done.
  regenerating fmtutil.cnf
  running fmtutil-sys --missing
  ...
  Transcript written on xelatex.log.
  fmtutil: /usr/local/texlive/2008/texmf-var/web2c/xetex/xelatex.fmt installed.

Le programme tlmgr prend en compte les dépendances et effectue automatiquement toutes les opérations nécessaires comme la mise à jour des bases de données et la génération de formats (ici un nouveau format a été créé pour XeTEX).

Deuxième exemple : ajout d’une langue de travail (néerlandais) ; ceci provoque la régénération de plusieurs formats.

> tlmgr install collection-langdutch

La demande de description de l’extension « collection-wintools »

> tlmgr show collection-wintools
retourne
  Package:   collection-wintools
  Category:  Collection
  ShortDesc: Windows support programs
  LongDesc:  Utilities for Windows, since they are not readily available there:
   gzip, chktex, jpeg2ps, unzip, wget, xpdf.
  Installed: Yes

Mise à jour complète de l’installation avec les dernières versions disponibles :

> tlmgr update -all
ou juste pour voir ce qui se passerait en cas de mise à jour complète :

> tlmgr update -all -dry-run
ou bien

> tlmgr update -list

Documentation complète de tlmgr :

> tlmgr -help

7 Spécificités Windows

Le nouveau programme d’installation de TEX Live est conçu pour fonctionner aussi bien sous Unix que sous Windows. Ceci nous a obligés à nous limiter à Windows 2000 et à ses successeurs (XP, Vista), au détriment des anciennes versions (9x, ME et NT).

7.1 Installation

Sous Windows le programme d’installation effectue quelques tâches supplémentaires :

Menus et raccourcis
– un sous-menu « TEX Live » est ajouté au menu « Démarrer », il contient des entrées pour les programmes tlmgr, texdoctk, PS_View et pour de la documentation. Une icône PS_View est ajoutée sur le bureau, il suffit d’y déposer un fichier PostScript pour provoquer son affichage.
Variables d’environnement
– leurs valeurs sont préremplies automatiquement sans intervention de l’utilisateur.
Désinstallation
– une entrée est ajoutée pour TEX Live dans le menu « Ajout et suppression de programmes ».

7.2 Programmes supplémentaires


pict

Figure 10: PS_View : de très forts grossissements sont possibles !


L’installation de TEX Live ajoute quelques utilitaires non fournis en standard avec Windows :

Perl et Ghostscript
TEX Live installe des copies « cachées » de ces programmes : ce sont des versions spécifiques adaptées à TEX Live, elles sont invisibles hors de TEX Live et n’interfèrent donc en aucune façon avec d’autres versions éventuellement présentes sur la machine.
Outils en ligne de commande
– des versions pour Windows de programmes Unix sont installées, en particulier gzip, chktex, jpeg2ps, unzip, wget et quelques utilitaires de la suite xpdf (xpdf lui-même n’est pas disponible sous Windows mais le visualiseur PDF Sumatra en est dérivé, voir http://blog.kowalczyk.info/software/sumatrapdf).
fc-cache
– facilite l’accès aux fontes système pour XeTEX.
PS_View
– nouveau visualiseur PostScript sous licence libre, voir figure 10.
Répertoire support
– ce répertoire, déjà mentionné à la section 2.2, contient divers programmes éventuellement utiles comme des éditeurs adaptés aux fichiers TEX ou le visualiseur Dviout présenté à la section suivante. Ces programmes ne sont pas installés automatiquement par la commande install-tl.

7.3 Visualiseur Dviout

Cette année, la distribution TEX Live ne contient malheureusement pas de visualiseur DVI pour Windows. Le programme dviout de Toshio Oshima est disponible dans le répertoire support/dviout/, il est accompagné d’un fichier README (à lire attentivement) décrivant l’installation et la configuration de dviout pour TEX Live.

Lors des premières exécutions de dviout, de nombreuses fontes sont créées à la volée pour l’écran utilisé. Ceci prend un peu de temps mais se produit de plus en plus rarement au fur et à mesure des utilisations. Une bonne aide en ligne est disponible.

7.4 Téléchargement de logiciels supplémentaires

Voici quelques liens vers des sites proposant des outils intéressants :

Ghostscript
http://www.cs.wisc.edu/~ghost/ ;
Perl
http://www.activestate.com/ et CPAN http://www.cpan.org/ ;
ImageMagick
http://www.imagemagick.com pour l’affichage et la conversion d’images ;
NetPBM
http://netpbm.sourceforge.net/ un concurrent du précédent ;
Éditeurs orientés TEX
– le choix est large, en voici une sélection :

7.5 Répertoire personnel

L’équivalent du répertoire personnel noté $HOME sous Unix s’appelle %USERPROFILE% sous Windows. Cette variable vaut en général C:\Documents and Settings\<username> sous Windows XP et 2000 et C:\Utilisateurs\<username> sous Vista. La notation ~, utilisée dans texmf.cnf et dans Kpathsea en général pour désigner un répertoire personnel, est correctement interprétée sous Windows comme sous Unix.

7.6 Base de registre Windows

Windows stocke pratiquement tous les paramètres de configuration dans sa base de registres. Celle-ci contient un ensemble de clés organisées par niveau. Les clés les plus importantes pour l’installation de programmes sont HKEY_CURRENT_USER et HKEY_LOCAL_MACHINE, HKCU et HKLM en abrégé. La partie HKCU de la base de registres se trouve dans le répertoire personnel de l’utilisateur (voir section 7.5). La partie HKLM est normalement dans un sous-répertoire du répertoire Windows.

Certaines informations système peuvent s’obtenir à partir des variables d’environnement mais pour d’autres, la localisation des raccourcis par exemple, la consultation de la base de registre est indispensable. La modification des variables d’environnement nécessite l’accès à la base de registre.

7.7 Droits d’accès sous Windows

Dans les versions récentes de Windows, la distinction est faite entre « utilisateurs » et « administrateurs », ces derniers ayant accès en écriture à la totalité du système. En pratique on devrait plutôt parler d’utilisateurs « non privilégiés » et d’utilisateurs « normaux » car être « administrateur » est la règle et non l’exception.

Nous nous sommes efforcés de rendre l’installation de TEX Live possible aux utilisateurs non privilégiés.

Si celui qui fait l’installation est « administrateur », les raccourcis et les entrées des menus sont créés pour tous les utilisateurs ; sinon, seul celui qui a fait l’installation aura accès à ces éléments. L’option non-admin du programme install-tl permet à un « administrateur » de faire une installation comme utilisateur non privilégié.

Dans tous les cas, le répertoire proposé comme racine de l’installation est %PROGRAMFILES%. Le programme install-tl vérifie si le répertoire choisi comme racine est accessible en écriture pour celui qui procède à l’installation.

Lorsqu’une installation TEX est présente sur la machine, l’installation de TEX Live par un utilisateur non privilégié est problématique : cet utilisateur n’aura jamais accès aux exécutables TEX Live car la recherche s’effectue d’abord dans les répertoires système, puis dans les répertoires de l’utilisateur. Une parade sommaire a été prévue : les raccourcis intègrent dans ce cas le chemin complet des exécutables qu’ils représentent. La distribution TEX Live est ainsi utilisable en ligne de commande à partir de ces raccourcis.

8 Guide d’utilisation du système Web2C

Web2C est une collection intégrée de programmes relatifs à TEX, c.-à-d. TEX lui-même, Metafont, MetaPost, BibTeX, etc. C’est le cœur de TEX Live. Le site de référence est http://tug.org/web2c.

Un peu d’histoire : la première implémentation a été réalisée par Tomas Rokicki qui, en 1987, a développé un premier système TEX-to-C en adaptant les change files pour Unix (travail de Howard Trickey et Pavel Curtis principalement). Tim Morgan assura la maintenance du système, dont le nom fut remplacé durant cette période par Web-to-C. En 1990, Karl Berry reprit le travail, assisté par des dizaines de contributeurs et en 1997 il passa le relais à Olaf Weber qui le rendit à Karl en 2006.

Le système Web2C fonctionne sur Unix, sur les systèmes Windows 32 bits, sur Mac OS X et sur de nombreux autres systèmes d’exploitation. Il utilise les sources originales de Knuth pour TEX et les autres programmes de base écrits en WEB (système de programmation documentée) qui sont tous traduits en langage C. Les composants du noyau de TEX issus de ce processus sont :

bibtex
– gère les bibliographies.
dmp
troff vers MPX (dessins MetaPost).
dvicopy
– copie le fichier DVI en supprimant les fontes virtuelles.
dvitomp
– convertit le fichier DVI en MPX (dessins MetaPost).
dvitype
– convertit le fichier DVI en un texte lisible.
gftodvi
– visualisation de fontes génériques GF.
gftopk
– convertit les fontes génériques GF en fontes bitmap PK.
gftype
– convertit le fichier GF en un texte lisible.
makempx
– typographie des étiquettes MetaPost.
mf
– création de fontes.
mft
– mise en page de code source Metafont.
mpost
– création de diagrammes techniques.
mpto
– extraction d’étiquettes MetaPost.
newer
– comparaison de dates de modification (fichiers).
patgen
– création de motifs de césure.
pktogf
– convertit les fontes bitmap PK en fontes génériques GF.
pktype
– convertit les fontes PK en un texte lisible.
pltotf
– convertit les fichiers PL (lisibles) en TFM.
pooltype
– affiche les fichiers WEB pool.
tangle
WEB vers Pascal.
tex
– composition de textes.
tftopl
– convertit les fichiers TFM en PL (lisibles).
vftovp
– convertit les fontes virtuelles VF en VPL (lisibles).
vptovf
– convertit les fontes VPL en fontes virtuelles VF.
weave
WEB vers TEX.

La syntaxe et les fonctions précises de ces programmes sont décrites dans la documentation des composants individuels et dans le manuel Web2C lui-même. Toutefois, connaître un certain nombre de principes régissant l’ensemble de la famille de programmes peut aider à exploiter de façon optimale votre installation Web2C.

Presque tous ces programmes suivent les options standard de GNU :

--help
imprime le sommaire de l’utilisation,
--verbose
imprime le rapport détaillé du processus,
--version
imprime seulement le numéro de version.

Pour localiser les fichiers, les programmes Web2C utilisent la bibliothèque de recherche Kpathsea (http://tug.org/kpathsea). Cette bibliothèque utilise une combinaison de variables d’environnement et un certain nombre de fichiers de paramètres pour optimiser la recherche dans l’énorme arborescence TEX. Web2C peut exécuter une recherche dans plusieurs arborescences simultanément, ce qui est utile si l’on souhaite maintenir la distribution standard de TEX et les extensions locales dans deux arborescences distinctes. Afin d’accélérer la recherche de fichiers, la racine de chaque arborescence possède un fichier ls-R contenant une entrée donnant le nom et le chemin de chaque fichier situé sous la racine.

8.1 Kpathsea et la recherche de fichiers

Décrivons en premier lieu le mécanisme de recherche de la bibliothèque Kpathsea.

Nous appelons chemin de recherche une liste, séparée par « deux-points » ou « point-virgule », d’éléments, appelés éléments de chemin, qui sont des noms de répertoires. Un chemin de recherche peut provenir de plusieurs sources. Pour rechercher un fichier « my-file » le long d’un chemin « . :/dir », Kpathsea vérifie chaque élément du chemin : d’abord ./my-file, puis /dir/my-file et renvoie la première occurrence (voire toutes).

Afin d’optimiser l’adaptation à tous les systèmes d’exploitation, Kpathsea peut utiliser dans les noms de fichiers des séparateurs différents de deux-points (« : ») et barre oblique (« / ») pour les systèmes non-Unix.

Pour vérifier un élément de chemin particulier p, Kpathsea vérifie d’abord si une base de données existante (voir page 67) contient p, c.-à-d. si la base de données se trouve dans un répertoire qui est un préfixe de p. Si oui, la spécification du chemin est comparée avec le contenu de la base de données.

Si la base de données n’existe pas, si elle ne s’applique pas à cet élément de chemin ou si elle ne contient aucune correspondance, la recherche est lancée sur tout le système de fichiers (si cela n’a pas été interdit par une commande commençant par « ! ! » et si le fichier cherché est censé exister). Kpathsea construit la liste de répertoires qui correspondent à cet élément de chemin, puis cherche le fichier dans chaque élément de cette liste.

La condition « le fichier est censé exister » est liée aux fichiers « .vf » et aux fichiers d’entrée lus par la commande TEX \openin. De tels fichiers peuvent ne pas exister (par exemple cmr10.vf), il est donc inutile de les rechercher sur le disque. De plus, si vous n’actualisez pas le fichier ls-R lors de l’installation d’un nouveau fichier « .vf », il ne sera jamais trouvé. Chaque élément de chemin est alors vérifié : d’abord dans la base de données puis sur le disque. Si une occurrence est trouvée, la recherche s’arrête et le résultat est obtenu.

Bien que l’élément de chemin le plus simple et le plus fréquent soit un nom de répertoire, Kpathsea supporte d’autres types d’éléments dans les chemins de recherche : des valeurs par défaut différentes pour chaque programme, des noms de variables d’environnement, des valeurs de fichiers de configuration, les répertoires de l’utilisateur et la recherche récursive de sous-répertoires. Nous disons alors que Kpathsea étend un élément, c’est-à-dire que Kpathsea transforme toutes ces spécifications en noms de répertoires de base. Cette opération est décrite dans les sections suivantes.

Notons que si le nom de fichier cherché est absolu ou explicitement relatif, c’est-à-dire commençant par « / », « ./ » ou « ../ », Kpathsea ne vérifie que l’existence de ce fichier.

8.1.1 Les différentes sources

Un chemin de recherche peut provenir de plusieurs sources. Voici l’ordre dans lequel Kpathsea les utilise.

  1. Une variable d’environnement définie par l’utilisateur, par exemple TEXINPUTS. Les variables d’environnement avec une extension attachée (nom de programme) sont d’abord prises en compte : par exemple, si « latex » est le nom du programme exécuté, TEXINPUTS.latex passera avant TEXINPUTS.
  2. Un fichier de configuration de programme spécifique, par exemple une ligne « S /a :/b » dans le fichier config.ps de dvips.
  3. Un fichier de configuration texmf.cnf de Kpathsea contenant une ligne telle que
    « TEXINPUTS=/c :/d » (voir ci-dessous).
  4. La valeur par défaut obtenue à la compilation.

On peut voir chacune de ces valeurs pour un chemin de recherche donné en utilisant l’option de débogage (voir page 72).

8.1.2 Fichiers de configuration

Kpathsea lit dans les fichiers de configuration à l’exécution appelés texmf.cnf les chemins de recherche et d’autres définitions. Le chemin pour accéder à ces fichiers dans l’arborescence est stocké dans la variable TEXMFCNF (par défaut ces fichiers se trouvent dans le sous-répertoire texmf/web2c). Tous les fichiers texmf.cnf se trouvant dans le chemin de recherche vont être lus et les définitions provenant de fichiers précédents écraseront celles des fichiers suivants. Par exemple, avec un chemin tel que .:$TEXMF, les définitions du fichier ./texmf.cnf écrasent celles de $TEXMF/texmf.cnf.

Voici un fichier de configuration illustrant les points précédents

  TEXMF              = {$TEXMFLOCAL,!!$TEXMFMAIN}
  TEXINPUTS.latex    = .;$TEXMF/tex/{latex,generic;}//
  TEXINPUTS.fontinst = .;$TEXMF/tex//;$TEXMF/fonts/afm//
  % e-TeX related files
  TEXINPUTS.elatex   = .;$TEXMF/{etex,tex}/{latex,generic;}//
  TEXINPUTS.etex     = .;$TEXMF/{etex,tex}/{eplain,plain,generic;}//

8.1.3 Expansion d’un chemin de recherche

Kpathsea reconnaît certains caractères et constructions spéciales dans les chemins de recherche, semblables à ceux disponibles dans les shells Unix. Ainsi, le chemin complexe, ~$USER/{foo,bar}//baz étend la recherche vers tous les sous-répertoires situés sous les répertoires foo et bar dans le répertoire utilisateur $USER contenant un répertoire ou un fichier appelé baz. Ces expansions sont explicitées dans les sections suivantes.

8.1.4 Expansion par défaut

Si le chemin de recherche le plus prioritaire (voir section 8.1.1) contient un « : » supplémentaire (c.-à-d. en début ou fin de ligne ou double), Kpathsea insère à cet endroit le chemin suivant dont la priorité définie est immédiatement inférieure. Si ce chemin inséré possède un « : » supplémentaire, le même processus se répète pour le chemin prioritaire suivant. Par exemple, étant donné une variable d’environnement définie ainsi

> setenv TEXINPUTS /home/karl:
la valeur de TEXINPUTS d’après le fichier texmf.cnf étant

  .:$TEXMF//tex
alors la valeur finale utilisée pour la recherche sera

  /home/karl:.:$TEXMF//tex

Comme il est inutile d’insérer la valeur par défaut en plusieurs endroits, Kpathsea applique la substitution à seulement un « : » supplémentaire et laisse les autres inchangés : il cherche d’abord un « : » en début de ligne, puis en fin de ligne et enfin un double « : ».

8.1.5 Expansion spécifiée par les accolades

Option utile, l’expansion par le biais des accolades signifie, par exemple, que v{a,b}w va permettre la recherche dans vaw:vbw. Les définitions emboîtées sont autorisées. Ceci peut être utilisé pour établir des hiérarchies TEX multiples en attribuant une liste entre accolades à $TEXMF. Par exemple, dans texmf.cnf, on trouve une définition du type suivant (il y a en fait plus de répertoires) :

    TEXMF = {$TEXMFHOME,$TEXMFLOCAL,!!$TEXMFSYSVAR,!!$TEXMFMAIN}

Avec ceci, on peut écrire quelque chose comme

    TEXINPUTS = .;$TEXMF/tex//

ce qui signifie que, après avoir cherché dans le répertoire courant, les arborescences complètes $TEXMFHOME/tex suivie de $TEXMFLOCAL/tex (sur le disque) et ensuite les arborescences ! !$TEXMFVAR/tex et ! !$TEXMFMAIN/tex (définies dans le fichier de référence ls-R seulement) seront inspectées. C’est un moyen pratique permettant d’utiliser en parallèle deux distributions TEX, une « figée » (sur un CD, par exemple) et une autre régulièrement mise à jour avec de nouvelles versions quand elles deviennent disponibles. En utilisant la variable $TEXMF dans toutes les définitions, on est toujours sûr d’inspecter d’abord l’arborescence la plus récente.

8.1.6 Expansion des sous-répertoires

Deux barres « // » ou plus consécutives dans une partie d’un chemin suivant un répertoire d sont remplacées par tous les sous-répertoires de d : d’abord les sous-répertoires directement présents dans d, ensuite les sous-répertoires de ceux-ci et ainsi de suite. À chaque niveau, l’ordre dans lequel les répertoires sont inspectés est non-déterminé.

Dans le cas où l’on spécifie une partie de nom de fichier après le « // », seuls sont inclus les sous-répertoires auxquels le nom correspond. Par exemple, « /a//b » va correspondre aux répertoires /a/1/b, /a/2/b, /a/1/1/b et ainsi de suite, mais pas à /a/b/c ni /a/1.

Des « // » multiples et successifs dans un chemin sont possibles, mais « // » au début d’un chemin est ignoré.

8.1.7 Liste des caractères spéciaux et de leur signification : récapitulatif

La liste suivante récapitule la signification des caractères spéciaux dans les fichiers de configuration de Kpathsea.

 :

Séparateur dans un chemin de recherche ; au début ou à la fin d’un chemin, il remplace le chemin par défaut.

 ;

Séparateur dans les systèmes non-Unix (joue le rôle de :).

$

Substitue le contenu d’une variable.

~

Représente le répertoire racine de l’utilisateur.

{...}

Expansion par les accolades, par exemple a{1,2}b devient a1b:a2b.

//

La recherche concernera aussi les sous-répertoires (peut être inséré n’importe où dans un chemin sauf au début).

%

Début d’un commentaire.

\

Caractère de continuation de ligne (permet les entrées sur plusieurs lignes).

 ! !

Cherche seulement dans la base de données pour localiser le fichier et ne cherche pas sur le disque.

8.2 Les bases de données

Kpathsea a une certaine profondeur d’investigation pour minimiser les accès disque durant les recherches. Néanmoins, dans le cas de distributions comprenant beaucoup de répertoires, inspecter chaque répertoire possible pour un fichier donné peut durer excessivement longtemps (ceci est typiquement le cas quand plusieurs centaines de répertoires de polices de caractères doivent être parcourus). En conséquence, Kpathsea peut utiliser un fichier texte appelé ls-R — en fait une base de données construite au préalable — qui fait correspondre les fichiers à leur répertoire, ce qui permet d’éviter une recherche exhaustive sur le disque.

Un deuxième fichier appelé aliases (qui est également une base de données) permet de donner des noms différents aux fichiers listés dans ls-R. Ceci peut aider à adapter ses fichiers source aux conventions de DOS 8.3 pour les noms de fichiers.

8.2.1 Le fichier base de données

Comme nous l’avons expliqué ci-dessus, le nom du principal fichier-base de données doit être ls-R. Dans votre installation, vous pouvez en mettre un à la racine de chaque arborescence TEX que vous désirez voir inspecter ($TEXMF par défaut) ; la plupart des sites ont une seule arborescence TEX. Kpathsea cherche les fichiers ls-R dans le chemin spécifié dans la variable TEXMFDBS.

La meilleure façon de créer et mettre à jour le fichier ls-R est d’exécuter le script mktexlsr inclus dans la distribution. Il est appelé par les divers scripts mktex... En principe, ce script exécute uniquement la commande

cd /your/texmf/root && \ls -1LAR ./ >ls-R
en supposant que la commande ls de votre système produise le bon format de sortie (le ls de GNU convient parfaitement). Pour s’assurer que la base de données est toujours à jour, le meilleur moyen est de la reconstruire en utilisant la table des cron, de telle façon que le fichier ls-R prenne automatiquement en compte les changements dans les fichiers installés, par exemple après une installation ou une mise à jour d’un composant LATEX.

Si un fichier n’est pas trouvé dans la base de données, par défaut Kpathsea décide de le chercher sur le disque. Par contre, si un élément du chemin commence par « ! ! », seule la base de données sera inspectée pour cet élément, jamais le disque.

8.2.2 kpsewhich : programme de recherche dans une arborescence

Le programme kpsewhich effectue une recherche dans une arborescence indépendamment de toute application. On peut le considérer comme une sorte de find pour localiser des fichiers dans les arborescences TEX (ceci est largement utilisé dans les scripts mktex... de la distribution).

> kpsewhich option... filename...
Les options spécifiées dans option peuvent commencer soit par « - » soit par « -- » ; n’importe quelle abréviation claire est acceptée.

Kpathsea considère tout argument non optionnel dans la ligne de commande comme un nom de fichier et renvoie la première occurrence trouvée. Il n’y a pas d’option pour renvoyer tous les fichiers ayant un nom particulier (vous pouvez utiliser le find d’Unix pour cela).

Les options les plus importantes sont décrites ci-après.

--dpi=num


Définit la résolution à num ; ceci affecte seulement la recherche des fichiers « gf » et « pk ». « -D » est un synonyme pour assurer la compatibilité avec dvips. Le défaut est 600.

--format=name


Définit le format pour la recherche à name. Par défaut, le format est estimé en fonction du nom de fichier. Pour les formats qui n’ont pas de suffixe clair associé, comme les fichiers de support MetaPost et les fichiers de configuration dvips, vous devez spécifier le nom connu de Kpathsea, comme tex ou enc files. Exécutez la commande kpsewhich --help pour obtenir la liste précise.

--mode=string


Définit le nom du mode comme étant string ; ceci affecte seulement la recherche des « gf » et des « pk ». Pas d’option par défaut, n’importe quel mode sera trouvé.

--must-exist


Fait tout ce qui est possible pour trouver les fichiers, ce qui inclut une recherche sur le disque. Par défaut, seule la base de données ls-R est inspectée, dans un souci d’efficacité.

--path=string


Recherche dans le chemin string (séparé par deux-points comme d’habitude), au lieu de prendre le chemin à partir du nom de fichier. « // » et toutes les expansions habituelles sont supportées. Les options « --path » et « --format » s’excluent mutuellement.

--progname=name


Définit le nom de programme comme étant name. Ceci peut affecter les chemins de recherche via l’option .progname dans les fichiers de configuration. Le défaut est kpsewhich.

--show-path=name


Montre le chemin utilisé pour la recherche des fichiers de type name. On peut utiliser soit une extension de fichier (.pk, .vf, etc.), soit un nom de fichier, comme avec l’option « --format ».

--debug=num


Définit les options de débogage comme étant num.

8.2.3 Exemples d’utilisation

Jetons un coup d’œil à Kpathsea en action ; voici une recherche toute simple :

> kpsewhich  article.cls
/usr/local/texmf-dist/tex/latex/base/article.cls
Nous recherchons le fichier article.cls. Puisque le suffixe .cls est non-ambigu, nous n’avons pas besoin de spécifier que nous voulons rechercher un fichier de type tex (répertoires des fichiers sources de TEX). Nous le trouvons dans le sous-répertoire tex/latex/base du répertoire racine « TEXMF ». De même, le suffixe non-ambigu permet de trouver facilement les autres fichiers.

> kpsewhich array.sty
   /usr/local/texmf-dist/tex/latex/tools/array.sty
> kpsewhich latin1.def
   /usr/local/texmf-dist/tex/latex/base/latin1.def
> kpsewhich size10.clo
   /usr/local/texmf-dist/tex/latex/base/size10.clo
> kpsewhich small2e.tex
   /usr/local/texmf-dist/tex/latex/base/small2e.tex
> kpsewhich tugboat.bib
   /usr/local/texmf-dist/bibtex/bib/beebe/tugboat.bib

Le dernier exemple est une base de données bibliographiques pour BibTeX servant aux articles de TUGBoat.

> kpsewhich cmr10.pk
Les fichiers de glyphes de fontes bitmaps, de type .pk, sont utilisés pour l’affichage par des programmes comme dvips et xdvi. Rien n’est renvoyé dans ce cas puisque il n’y a pas de fichiers Computer Modern .pk pré-créés sur nos systèmes (nous utilisons les versions type 1 du TEX Live).

> kpsewhich wsuipa10.pk

  /usr/local/texmf-var/fonts/pk/ljfour/public/wsuipa/wsuipa10.600pk
Pour ces fontes (alphabet phonétique de l’université Washington), nous avons dû créer les fichiers .pk et, puisque le mode Metafont par défaut sur notre installation est ljfour avec une résolution de base de 600dpi (dots per inch), cette instance est trouvée.

> kpsewhich -dpi=300 wsuipa10.pk
Dans ce cas, lorsque l’on spécifie que nous recherchons une résolution de 300dpi (-dpi=300) nous voyons qu’aucune fonte pour cette résolution n’est disponible dans le système. En fait, un programme comme dvips ou xdvi ne s’en préoccuperait pas et créerait les fichiers .pk à la résolution demandée en utilisant le script mktexpk.

Intéressons-nous à présent aux fichiers d’en-tête et de configuration pour dvips. Regardons en premier le fichier tex.pro communément utilisé pour le support de TEX avant de regarder le fichier de configuration générique (config.ps) et la liste des fontes PostScript psfonts.map. Depuis l’édition 2004, les fichiers .map et les fichiers de codage ont changé de place dans l’arborescence texmf. Comme le suffixe .ps est ambigu, nous devons spécifier quel type particulier du fichier config.ps nous considérons (dvips config).

> kpsewhich tex.pro
   /usr/local/texmf/dvips/base/tex.pro
> kpsewhich --format="dvips config" config.ps
   /usr/local/texmf-var/dvips/config/config.ps
> kpsewhich psfonts.map
   /usr/local/texmf-var/fonts/map/dvips/updmap/psfonts.map

Regardons plus en détail les fichiers de support Times PostScript d’URW. Leur nom standard dans le schéma de nommage des fontes est « utm ». Le premier fichier que nous voyons est le fichier de configuration, qui contient le nom du fichier de la liste :

> kpsewhich --format="dvips config" config.utm
   /usr/local/texmf-dist/dvips/psnfss/config.utm
Le contenu de ce fichier est

  p +utm.map
qui pointe vers le fichier utm.map, que nous cherchons à localiser ensuite.

> kpsewhich utm.map
  /usr/local/texmf-dist/fonts/map/dvips/times/utm.map
Ce fichier liste les noms des fichiers des fontes PostScript de type 1 dans la collection URW. Son contenu ressemble à (nous ne montrons qu’une partie des lignes) :

utmb8r  NimbusRomNo9L-Medi    ... <utmb8a.pfb
utmbi8r NimbusRomNo9L-MediItal... <utmbi8a.pfb
utmr8r  NimbusRomNo9L-Regu    ... <utmr8a.pfb
utmri8r NimbusRomNo9L-ReguItal... <utmri8a.pfb
utmbo8r NimbusRomNo9L-Medi    ... <utmb8a.pfb
utmro8r NimbusRomNo9L-Regu    ... <utmr8a.pfb
Prenons par exemple le cas de Times Roman utmr8a.pfb et trouvons sa position dans l’arborescence texmf en utilisant une recherche applicable aux fichiers de fontes de type 1 :

> kpsewhich utmr8a.pfb
   /usr/local/texmf-dist/fonts/type1/urw/times/utmr8a.pfb

Il devrait être clair, d’après ces quelques exemples, qu’il est facile de trouver l’endroit où se cache un fichier donné. C’est particulièrement important si vous suspectez que c’est, pour une raison quelconque, une mauvaise version du fichier qui est utilisée, puisque kpsewhich va vous montrer le premier fichier trouvé.

8.2.4 Opérations de débogage

Il est quelquefois nécessaire de savoir comment un programme référence les fichiers. Pour permettre cela, Kpathsea offre plusieurs niveaux de débogage :

 1

Appels à stat (test d’existence de fichier). Lors d’une exécution utilisant une base de données ls-R à jour, ce niveau ne devrait donner presque aucune information en sortie.

 2

Références aux différentes tables (comme la base de données ls-R, les fichiers de correspondance de fontes, les fichiers de configuration).

 4

Opérations d’ouverture et de fermeture des fichiers.

 8

Information globale sur la localisation des types de fichiers recherchés par Kpathsea. Ceci est utile pour trouver où a été défini le chemin particulier pour un fichier.

16

Liste des répertoires pour chaque élément du chemin (utilisé uniquement en cas de recherche sur le disque).

32

Recherche de fichiers.

64

Valeur des variables.

Une valeur de -1 activera toutes les options ci-dessus ; en pratique, c’est habituellement la valeur la plus adaptée.

De la même façon, avec le programme dvips, en utilisant une combinaison d’options de débogage, on peut suivre en détail la localisation des différents fichiers. De plus, lorsqu’un fichier n’est pas trouvé, la trace du débogage montre les différents répertoires dans lesquels le programme va chercher tel ou tel fichier, donnant ainsi des indices sur le problème.

Généralement, comme la plupart des programmes appellent la bibliothèque Kpathsea en interne, on peut sélectionner une option de débogage en utilisant la variable d’environnement KPATHSEA_DEBUG et en la définissant égale à la valeur (ou à une combinaison de valeurs) décrite(s) dans la liste ci-dessus.

Note à l’intention des utilisateurs de Windows : il n’est pas facile de rediriger les messages d’erreur vers un fichier sur ces systèmes. À des fins de diagnostic, vous pouvez temporairement affecter KPATHSEA_DEBUG_OUTPUT=err.log pour capturer le flux standard d’erreur dans le fichier err.log.

Considérons comme exemple un petit fichier source LATEX, hello-world.tex, dont le contenu est le suivant.

    \documentclass{article}
    \begin{document}
    Hello World!
    \end{document}

Ce petit fichier utilise simplement la fonte cmr10, aussi allons voir comment dvips prépare le fichier PostScript (nous voulons utiliser la version type 1 des fontes Computer Modern, d’où l’option -Pcms).

> dvips -d4100 hello-world -Pcms -o
Dans ce cas, nous avons combiné le niveau 4 de débogage de dvips (chemins des fontes) avec l’option d’expansion des éléments du chemin de Kpathsea (voir dvips Reference Manual, texmf/doc/html/dvips/dvips_toc.html sur le DVD). La sortie (légèrement formatée) apparaît dans la figure 11.


debug:start search(file=texmf.cnf, must_exist=1, find_all=1,
  path=.:/usr/local/bin/texlive:/usr/local/bin:
       /usr/local/bin/texmf/web2c:/usr/local:
       /usr/local/texmf/web2c:/.:/./teTeX/TeX/texmf/web2c:).
kdebug:start search(file=ls-R, must_exist=1, find_all=1,
  path=~/tex:/usr/local/texmf).
kdebug:search(ls-R) =>/usr/local/texmf/ls-R
kdebug:start search(file=aliases, must_exist=1, find_all=1,
  path=~/tex:/usr/local/texmf).
kdebug:search(aliases) => /usr/local/texmf/aliases
kdebug:start search(file=config.ps, must_exist=0, find_all=0,
  path=.:~/tex:!!/usr/local/texmf/dvips//).
kdebug:search(config.ps) => /usr/local/texmf/dvips/config/config.ps
kdebug:start search(file=/root/.dvipsrc, must_exist=0, find_all=0,
  path=.:~/tex:!!/usr/local/texmf/dvips//).
search(file=/home/goossens/.dvipsrc, must_exist=1, find_all=0,
  path=.:~/tex/dvips//:!!/usr/local/texmf/dvips//).
kdebug:search($HOME/.dvipsrc) =>
kdebug:start search(file=config.cms, must_exist=0, find_all=0,
  path=.:~/tex/dvips//:!!/usr/local/texmf/dvips//).
kdebug:search(config.cms)
=>/usr/local/texmf/dvips/cms/config.cms
Figure 11: Recherche des fichiers de configuration
kdebug:start search(file=texc.pro, must\_exist=0, find\_all=0,
  path=.:~/tex/dvips//:!!/usr/local/texmf/dvips//:
       ~/tex/fonts/type1//:!!/usr/local/texmf/fonts/type1//).
kdebug:search(texc.pro) => /usr/local/texmf/dvips/base/texc.pro
Figure 12: Recherche du fichier prolog
kdebug:start search(file=cmr10.tfm, must\_exist=1, find\_all=0,
  path=.:~/tex/fonts/tfm//:!!/usr/local/texmf/fonts/tfm//:
       /var/tex/fonts/tfm//).
kdebug:search(cmr10.tfm) => /usr/local/texmf/fonts/tfm/public/cm/cmr10.tfm
kdebug:start search(file=texps.pro, must\_exist=0, find\_all=0,
   ...
<texps.pro>
kdebug:start search(file=cmr10.pfb, must\_exist=0, find\_all=0,
  path=.:~/tex/dvips//:!!/usr/local/texmf/dvips//:
       ~/tex/fonts/type1//:!!/usr/local/texmf/fonts/type1//).
kdebug:search(cmr10.pfb) => /usr/local/texmf/fonts/type1/public/cm/cmr10.pfb
<cmr10.pfb>[1]
Figure 13: Recherche du fichier de fontes

dvips commence par localiser ses fichiers de fonctionnement. D’abord, texmf.cnf est trouvé, ce qui donne les définitions pour les chemins de recherche servant à localiser les autres fichiers, ensuite le fichier base de données ls-R (pour optimiser la recherche des fichiers) et le fichier aliases, qui permet de déclarer plusieurs noms (par exemple un nom DOS de type 8.3 court et une version longue plus naturelle) pour le même fichier. Ensuite dvips continue en cherchant le fichier de configuration générique config.ps avant de rechercher le fichier de paramétrisation .dvipsrc (qui, dans notre cas, n’est pas trouvé). Enfin, dvips localise le fichier de configuration pour les fontes PostScript Computer Modern config.cms (ceci est lancé par l’option -Pcms de la commande dvips). Ce fichier contient la liste des fichiers qui définissent la relation entre les noms des fontes selon TEX, selon PostScript et dans le système de fichiers.

> more /usr/local/texmf/dvips/cms/config.cms
   p +ams.map
   p +cms.map
   p +cmbkm.map
   p +amsbkm.map
dvips veut chercher tous ces fichiers, y compris le fichier générique d’association psfonts.map, qui est toujours chargé (il contient des déclarations pour les fontes PostScript les plus communément utilisées ; voir la dernière partie de la Section 8.2.3 pour plus de détails sur la gestion du fichier d’association PostScript).

Arrivé là, dvips s’identifie à l’utilisateur :

 This is dvips(k) 5.92b Copyright 2002 Radical Eye Software (www.radicaleye.com)
 

pour continuer ensuite en cherchant le fichier prologue texc.pro,


kdebug:start search(file=texc.pro, must_exist=0, find_all=0,
  path=.:~/tex/dvips//:!!/usr/local/texmf/dvips//:
       ~/tex/fonts/type1//:!!/usr/local/texmf/fonts/type1//).
kdebug:search(texc.pro) => /usr/local/texmf/dvips/base/texc.pro

Après avoir trouvé ce fichier, dvips affiche la date et l’heure, nous informe qu’il va générer le fichier hello-world.ps puis qu’il a besoin du fichier de fonte cmr10 et que ce dernier est déclaré comme « résident » (pas besoin de bitmaps) :


TeX output 1998.02.26:1204’ -> hello-world.ps
Defining font () cmr10 at 10.0pt
Font cmr10 <CMR10> is resident.
Maintenant la recherche concerne le fichier cmr10.tfm, qui est trouvé, puis quelques fichiers de prologue de plus (non montrés) sont référencés ; finalement le fichier de la fonte type 1 cmr10.pfb est localisé et inclus dans le fichier de sortie (voir la dernière ligne).


kdebug:start search(file=cmr10.tfm, must_exist=1, find_all=0,
  path=.:~/tex/fonts/tfm//:!!/usr/local/texmf/fonts/tfm//:
       /var/tex/fonts/tfm//).
kdebug:search(cmr10.tfm) => /usr/local/texmf/fonts/tfm/public/cm/cmr10.tfm
kdebug:start search(file=texps.pro, must_exist=0, find_all=0,
   ...
<texps.pro>
kdebug:start search(file=cmr10.pfb, must_exist=0, find_all=0,
  path=.:~/tex/dvips//:!!/usr/local/texmf/dvips//:
       ~/tex/fonts/type1//:!!/usr/local/texmf/fonts/type1//).
kdebug:search(cmr10.pfb) => /usr/local/texmf/fonts/type1/public/cm/cmr10.pfb
<cmr10.pfb>[1]

8.3 Options à l’exécution

Web2C offre la possibilité de contrôler à l’exécution bon nombre de paramètres concernant la mémoire (en particulier la taille des tableaux utilisés) à partir du fichier texmf.cnf qui est lu par Kpathsea. Les paramètres en question se trouvent dans la troisième partie du fichier inclus dans la distribution TEX Live. Les variables les plus importantes sont :

main_memory

Nombre total de mots mémoire disponibles pour TEX, Metafont et MetaPost. Vous devez générer un nouveau fichier de format pour chaque nouveau paramétrage. Par exemple, vous pouvez générer une version large de TEX et appeler le fichier de format hugetex.fmt. En utilisant la méthode supportée par Kpathsea qui consiste à suffixer la variable par le nom du programme, la valeur particulière de la variable main_memory destinée à ce fichier de format sera lue dans le fichier texmf.cnf.

extra_mem_bot

Espace supplémentaire pour certaines structures de données de TEX : boîtes, glue, points d’arrêt... Surtout utile si vous utilisez PI CTEX par exemple.

font_mem_size

Nombre de mots mémoire disponibles pour décrire les polices. C’est plus ou moins l’espace occupé par les fichiers TFM lus.

hash_extra

Espace supplémentaire pour la table de hachage des noms de séquences de contrôle. Environ 10 000 de ces noms peuvent être stockés dans la table principale ; si vous avez un document très volumineux avec beaucoup de références croisées, il se peut que ce ne soit pas suffisant. La valeur par défaut hash_extra est 50000.

Évidemment, cette possibilité ne remplace pas une véritable allocation dynamique des tableaux et de la mémoire mais puisque c’est complexe à implémenter dans le présent source TEX, ces paramètres lus à l’exécution fournissent un compromis pratique qui procure une certaine souplesse.

9 Installation sur un nouveau système Unix

Si vous avez un système Unix ne correspondant à aucun des exécutables fournis, il faut compiler vous-même TEX et tous ses programmes satellites à partir des sources. Cela n’est pas aussi difficile qu’il y paraît. Tout ce dont vous aurez besoin est contenu dans le répertoire source qui se trouve sur le DVD.

9.1 Prérequis

Il faut au moins 400 Mo d’espace sur disque pour compiler la totalité de TEX et des programmes associés. Vous aurez aussi besoin d’un compilateur C ANSI, de l’utilitaire make, d’un générateur d’analyseur lexical et d’un générateur d’analyseur syntaxique. Nous recommandons les versions GNU des programmes suivants (gcc, GNUmake, m4, flex, bison). Vous pouvez utiliser d’autres compilateurs C et d’autres programmes make si vous maîtrisez correctement la programmation sous Unix pour résoudre les problèmes éventuels. La commande uname doit renvoyer une valeur raisonnable.

9.2 Configuration

Tout d’abord, effectuez l’installation normale de TEX Live sur le disque dur (voir section 3, page 14). Vous pouvez sauter l’installation de tous les binaires précompilés. Décompactez ensuite sur le disque le fichier source.tar.bz2 (archive compressée) trouvé dans le répertoire source et placez-vous dans le répertoire où vous avez transféré l’ensemble.

> cd /tmp/tl-source
> bunzip2 source.tar.bz2
> tar xf source.tar

Lancez maintenant configure de la façon suivante :

> sh configure -prefix=/usr/local/texlive/2007

Le répertoire -prefix est le répertoire de base de l’arborescence TEX Live, il est désigné par TEXDIR dans la suite.

Si vous ne voulez pas créer de répertoire $archname spécifique au système choisi pour stocker les exécutables (c.-à-d. les copier directement dans $TEXDIR/bin), il faut exécuter configure avec l’option
--disable-multiplatform.

Tapez ./configure --help, le programme affichera les options supplémentaires disponibles (telles que supprimer l’installation des extensions optionnelles comme Omega ou e-TEX).

9.3 Exécuter make

S’assurer que la variable ou l’option noclobber n’est pas définie. et lancer le make à la racine de l’arborescence de la façon suivante :

>> make world
et aller prendre un café...

Il peut être utile de garder une trace complète dans un fichier log en tapant :

>> sh -c "make world >world.log 2>&1" &
Avant de conclure que tout va bien, vérifier que le fichier log ne contient pas de message d’erreur : le make de GNU renvoie toujours le message « *** » à chaque erreur d’exécution. Vérifier aussi que tous les exécutables ont été créés.

>> cd TEXDIR/bin/archname
>> ls | wc
Le résultat doit être supérieur à 200 (on peut tester le nombre exact dans le répertoire bin de la distribution).

Si vous avez besoin de droits spéciaux pour exécuter make install, vous pouvez séparer « make world » en deux processus différents :

>> make all
>> su
>> make install strip

Après avoir installé vos nouveaux binaires, il faut suivre les procédures normales de la post-installation, indiquées dans la section 3.4, page 38.

10 Remerciements

TEX Live est le résultat des efforts collectifs de pratiquement tous les groupes d’utilisateurs de TEX. La présente édition de TEX Live a été coordonnée par Karl Berry. Voici la liste des principaux contributeurs :

Les binaires ont été compilés par : Tigran Aivazian (x86_64-linux), Tim Arnold (hppa-hpux), Randy Au (amd64-freebsd), Edd Barrett (i386-openbsd), Karl Berry (i386-linux), Akira Kakuto (win32), Dick Koch (universal-darwin), Manfred Lotz (i386-freebsd), Norbert Preining (alpha-linux), Arthur Reutenauer (sparc-linux), Thomas Schmitz (powerpc-linux), Apostolos Syropoulos (i386-solaris), Vladimir Volovich (powerpc-aix, sparc-solaris), Olaf Weber (mips-irix).

Documentation et mises à jour des traductions : Karl Berry (anglais), Daniel Flipo (français), Klaus Höppner (allemand), Petr Sojka & Jan Busa (tchèque et slovaque), Boris Veytsman (russe), Staszek Wawrykiewicz (polonais).

La page d’accueil de la documentation TEX Live est http://tug.org/texlive/doc.html.

Bien sûr, notre gratitude va en premier lieu à Donald Knuth pour avoir inventé TEX et l’avoir offert au monde entier.

11 Historique des versions successives

11.1 Les éditions précédentes

La discussion commença à la fin de 1993 quand le Groupe des Utilisateurs Néerlandais de TEX commençait à travailler à son CD 4AllTEX pour les utilisateurs de MS-DOS et on espérait à ce moment sortir un CD unique pour tous les systèmes. C’était un objectif beaucoup trop ambitieux mais il permit la naissance du CD 4AllTEX, projet couronné de succès et aussi d’un groupe de travail « TUG Technical Council » pour mettre en place TDS (TEX Directory Structure : http://tug.org/tds), qui spécifiait la gestion des fichiers TEX sous une forme logique. La mouture finale de TDS fut publiée dans le numéro de décembre 1995 de TUGboat et il était clair depuis un certain temps qu’il fallait proposer un produit contenant une structure modèle sur CD. La distribution que vous possédez est le résultat direct des délibérations de ce groupe de travail. Il était également clair que le succès des CD 4AllTEX démontrait que les utilisateurs d’Unix trouveraient leur bonheur avec une distribution aussi simple et ceci a été l’autre objectif de TEX Live.

Nous avons d’abord entrepris de créer un nouveau CD TDS Unix à l’automne 1995 et nous avons rapidement choisi teTEX de Thomas Esser comme étant la configuration idéale, car il supportait déjà plusieurs plates-formes et avait été construit en gardant à l’esprit la portabilité entre systèmes. Thomas accepta de nous aider et commença à travailler sérieusement au début de 1996. La première édition sortit en mai 1996. Au début de 1997, Karl Berry acheva une nouvelle distribution de Web2C, qui incluait presque toutes les caractéristiques que Thomas Esser avait ajoutées dans teTEX et il fut décidé de baser la deuxième édition du CD sur le standard Web2C, en y ajoutant le script texconfig de teTEX. La troisième édition du CD était basée sur une version majeure de Web2C, 7.2, par Olaf Weber ; en même temps, une nouvelle version révisée de teTEX était achevée dont TEX Live partageait presque toutes les caractéristiques. La quatrième édition a suivi le même schéma, en utilisant une nouvelle version de teTEX et une nouvelle version de Web2C (7.3). Le système incluait dorénavant un programme complet d’installation pour Windows.

Pour la cinquième édition (mars 2000), de nombreuses parties du CD ont été vérifiées et révisées, des centaines de composants mis à jour. Le contenu détaillé des composants était décrit par des fichiers XML. Mais le changement majeur de cette cinquième édition a été la suppression de tout logiciel non libre de droits. Tout ce qui se trouve dans TEX Live devait être compatible avec la licence Debian (Debian Free Software Guidelines : http://www.debian.org/intro/free) ; nous avons fait de notre mieux pour vérifier les termes des licences de chaque composant et nous souhaiterions que toute erreur nous soit signalée.

La sixième édition (juillet 2001) contient un grand nombre de mises à jour. Le changement majeur de cette version réside dans la refonte du processus d’installation : l’utilisateur peut désormais choisir les collections de manière plus précise. Les collections concernant les langues ont été entièrement réorganisées, aussi le choix d’une langue installe non seulement les macros, les fontes, etc. mais prépare également un fichier language.dat adéquat.

La septième édition (mai 2002) a comme ajout majeur une installation pour Mac OS X et l’habituelle myriade de mises à jour de composants et de programmes. Un objectif important a été de fusionner à nouveau les sources avec ceux de teTEX, alors que les versions 5 et 6 s’en étaient éloignées.

11.1.1 2003

En 2003, le flot de mises à jour et d’additions a continué mais nous avons constaté que TEX Live était devenu si volumineux qu’il ne pouvait plus tenir sur un seul CD, aussi l’avons-nous divisé en trois distributions distinctes (voir section 2.1, page 8). Par ailleurs :

11.1.2 2004

2004 a apporté beaucoup de changements (et quelques incompatibilités avec les versions précédentes) :

11.1.3 2005

2005 a apporté son lot habituel d’innombrables mises à jour d’extensions et de programmes. L’infrastructure est restée relativement stable par rapport à 2004, à quelques changements inévitables près :

11.1.4 2006–2007

En 2006–2007, la nouveauté majeure a été l’arrivée dans TEX Live de XeTEX disponible sous forme de deux programmes xetex et xelatex, voir http://scripts.sil.org/xetex.

MetaPost a subi une mise à jour importante et d’autres améliorations sont prévues, voir http://tug.org/metapost/articles. Il en va de même pour pdfTEX, voir http://tug.org/applications/pdftex.

Le format tex.fmt et les formats pour MetaPost and Metafont ne se trouvent plus dans texmf/web2c mais dans des sous-répertoires de texmf/web2c (la recherche de fichiers .fmt est néanmoins faite aussi dans texmf/web2c). Ces sous-répertoires portent le nom du moteur utilisé pour construire le format, par exemple tex, pdftex ou xetex. Ce changement ne devrait pas avoir d’effet visible pour les utilisateurs.

Le programme (plain) tex ignore désormais les lignes commençant par %& qui permettent de déterminer le format à utiliser ; c’est un vrai TEX « à la Knuth » ! LATEX et tous les autres prennent toujours en compte les lignes commençant par %&.

Comme chaque année des centaines d’extensions et de programmes ont été mis à jour, voir les sites CTAN (http://www.ctan.org).

L’arborescence utilisée en interne a été réorganisée avec de nouveaux outils qui devraient fournir une meilleure base de travail pour les développements futurs.

Enfin, en mai 2006 Thomas Esser a annoncé qu’il renonçait à poursuivre le développement de teTEX (http://tug.org/tetex). Sa décision a relancé l’intérêt pour TEX Live, en particulier chez les distributeurs de solutions GNU/Linux (un nouveau schéma d’installation tetex a été ajouté dans le script d’installation de TEX Live pour produire une distribution proche de l’ancienne teTEX). La distribution TEX Live existe déjà sous forme de paquets Debian, espérons que les autres acteurs du monde Linux (RedHat, SuSe, etc.) suivront et que les utilisateurs se verront proposer à l’avenir des distributions TEX riches et plus faciles à installer.

Remarque finale : toutes les anciennes distributions TEX Live ainsi que les jaquettes des CD correspondants sont disponibles ici : ftp://tug.org/historic/systems/texlive.

11.2 L’édition 2008

En 2008, l’infrastructure de la distribution TEX Live a été entièrement remaniée. Un nouveau fichier texte, tlpkg/texlive.tlpdb, regroupe toutes les informations concernant la configuration TEX Live de la machine.

Ce fichier permet entre autres choses de procéder à des mises à jour par le réseau après l’installation initiale. Cette possibilité était offerte depuis des années par MiKTEX. Nous espérons pouvoir fournir des mises à jour régulières du contenu des archives CTAN.

Le nouveau moteur LuaTEX (http://luatex.org) a été intégré ; il offre de nouvelles fonctionnalités typographiques et repose sur l’excellent langage de commande Lua qui peut aussi être utilisé en dehors de TEX.

Les versions Windows et Unix sont beaucoup plus proches que par le passé. En particulier les scripts en Perl et en Lua sont communs aux deux architectures.

TEX Live dispose d’une nouvelle interface pour la maintenance (tlmgr voir section 6), elle permet les ajouts, mises à jour et suppressions de composants et prend en charge la régénération des bases ls-R, des formats et des fichiers .map lorsque c’est nécessaire.

Les fonctionnalités de tlmgr englobent toutes les tâches dévolues auparavant à texconfig qui ne devrait plus être utilisé (il est conservé mais avec un champ d’action réduit).

Le programme d’indexation xindy (http://xindy.sourceforge.net/) est maintenant disponible pour la plupart des plates-formes.

L’utilitaire kpsewhich dispose de deux options nouvelles : –all qui retourne toutes les occurrences du fichier recherché et –subdir qui limite la recherche à un sous-répertoire donné.

Le programme dvipdfmx permet maintenant d’extraire les informations concernant la bounding box par le biais de la commande extractbb ; c’était une des dernières fonctionnalités de dvipdfm qui manquaient à dvipdfmx.

Les alias de polices Times-Roman, Helvetica, etc. ont été supprimés, les conflits de codage qu’ils induisaient n’ayant pas pu être résolus.

Le format platex a été supprimé afin de résoudre un conflit de nom avec son homonyme japonais ; le support pour le polonais est assuré maintenant par l’extension polski.

Les fichiers WEB d’extension .pool sont maintenant inclus dans les binaires afin de faciliter les mises à jour.

Enfin, les changements décrits par Donald Knuth dans « TEX tuneup of 2008 » (voir http://tug.org/TUGboat/Articles/tb29-2/tb92knut.pdf) sont inclus dans la présente édition.

11.3 Versions futures

TEX Live n’est pas un produit parfait ! (et ne le sera jamais). Nous prévoyons de continuer à produire de nouvelles versions et aimerions fournir plus d’aide, de fonctionnalités, de programmes d’installation et (bien sûr) une arborescence améliorée et vérifiée de macros et de fontes. Ce travail est effectué par des volontaires débordés, dans la limite de leur temps libre et beaucoup reste à faire. Si vous pouvez nous aider, n’hésitez pas à nous contacter, voir http://tug.org/texlive/contribute.html.

Corrections, suggestions et propositions d’aide doivent être envoyées à :

tex-live@tug.org
http://tug.org/texlive

Bon travail avec TEX !

1.Plus précisément en tête du PATH s’il y a d’autres binaires TEX en concurrence.

2.Dans la description qui suit, le nom des boutons est celui de la version anglaise par souci de cohérence avec les figures. L’affichage se fait normalement dans la langue de l’utilisateur (variable LANG sous Unix).