Guide pratique de T X Live E TEX Collection 2007 Karl Berry http://tug.org/texlive/ Version française Daniel Flipo (GUTenberg) Janvier 2007 TABLE DES MATIÈRES 2 Table des matières 1 Introduction 3 1.1 Utilisation élémentaire de TEX Live . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 1.2 Obtenir de l’aide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 2 Structure de TEX Live 5 2.1 Distributions multiples : live, inst, protext . . . . . . . . . . . . . . . . . . . . . . . 5 2.2 Répertoires situés à la racine . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 2.3 Description des arborescences texmf utilisées . . . . . . . . . . . . . . . . . . . . . 6 2.4 Les extensions de TEX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 2.5 Quelques autres programmes intéressants dans TEX Live . . . . . . . . . . . . . . . 7 3 Utilisation sous Unix 8 3.1 Utiliser TEX Live à partir du DVD live . . . . . . . . . . . . . . . . . . . . . . . . . 8 3.2 Installer TEX Live sur le disque . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 3.3 Ajouter des composants à une installation . . . . . . . . . . . . . . . . . . . . . . . 15 4 À faire après l’installation 16 4.1 Le programme texconfig . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16 4.2 Tester l’installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17 5 Installation pour MacOSX 19 5.1 Installation de MacTEX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19 5.2 install*.sh : installation depuis TEX Live . . . . . . . . . . . . . . . . . . . . . . . . 19 5.3 Interfaces graphiques pour MacOSX . . . . . . . . . . . . . . . . . . . . . . . . . . 20 6 Installation sous Windows 20 6.1 Installation sous Windows depuis le CD inst . . . . . . . . . . . . . . . . . . . . . . 21 6.2 Programmes auxiliaires pour Windows . . . . . . . . . . . . . . . . . . . . . . . . . 22 7 Maintenance sous Windows 23 7.1 Ajouter ou supprimer des composants . . . . . . . . . . . . . . . . . . . . . . . . . 23 7.2 Configuration et maintenance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23 7.3 Désinstallation complète de TEX Live . . . . . . . . . . . . . . . . . . . . . . . . . 23 7.4 Ajouter des composants à votre système . . . . . . . . . . . . . . . . . . . . . . . . 24 7.5 Exécution de tlmp.exe en ligne de commande . . . . . . . . . . . . . . . . . . . . . 24 7.6 Installation en réseau . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24 7.7 Différences entre la version Windows et la version Unix de TEX Live . . . . . . . . 24 7.8 Personnalisation de l’installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25 7.9 Tests . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26 7.10 Impression . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26 7.11 Trucs et astuces à propos de la plate-forme Win32 . . . . . . . . . . . . . . . . . . 27 7.12 En cas de problème . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30 LISTE DES TABLEAUX 3 8 Guide d’utilisation du système Web2C 31 8.1 Kpathsea et la recherche de fichiers . . . . . . . . . . . . . . . . . . . . . . . . . . . 32 8.2 Les bases de données . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36 8.3 Options à l’exécution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42 9 Installation sur un nouveau système Unix 43 9.1 Prérequis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43 9.2 Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43 9.3 Exécuter make . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43 10 Remerciements 44 11 Historique des versions successives 45 11.1 Les éditions précédentes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45 11.2 L’édition 2006–2007 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49 11.3 Versions futures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50 Liste des tableaux 1 Options d’installation du menu principal . . . . . . . . . . . . . . . . . . . . . . . . 10 2 Les binaires sont disponibles pour les architectures suivantes. . . . . . . . . . . . . 11 1 Introduction Ce document décrit les principales caractéristiques de la distribution TEX Live, une distribution de TEX et LATEX pour Linux et autres Unix, MacOSX et systèmes Windows 32 bits (attention, cette distribution n’est pas vraiment utilisable avec les anciens systèmes Mac ou MS-DOS). Elle comprend les binaires pré-compilés de TEX, LATEX2ε, METAFONT, MetaPost, BibTEX et de nombreux autres programmes ainsi qu’une bibliothèque étendue de macros, de fontes et de documentations. Elle traite aussi la composition de textes qui utilisent plusieurs systèmes d’écritures différentes venant de toute la surface du globe. La distribution TEX Live est en fait un sous-ensemble de TEX Collection (décrit brièvement à la section 2, p. 5) produit grâce aux efforts combinés des différents groupes d’utilisateurs de TEX. L’édition 2007 a été figée en janvier 2007. Les futures mises à jour des composants de la distribution 2007 seront disponibles au fur et à mesure de leur parution sur le site CTAN, http://www.ctan.org. On trouvera à la fin du document, section 11 (p. 45), un bref historique des principales modifica- tions 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 p. 49 qui présente les principaux changements intervenus cette année. 1.1 Utilisation élémentaire de TEX Live Vous pouvez utiliser TEX Live de trois façons différentes : 1. Vous pouvez exécuter TEX Live directement depuis le DVD live (toutes plates-formes). Cela prend très peu d’espace disque et donne un accès immédiat à tout le contenu de TEX Live. 1 INTRODUCTION 4 C’est une solution parfaitement acceptable même si les performances obtenues sont moins bonnes que si TEX Live était lancé depuis un disque local. 2. Vous pouvez installer tout ou partie de TEX Live sur un disque local. C’est l’utilisation la plus fréquente de TEX Live. Ceci peut se faire à partir du DVD live ou de l’un des CD de la distribution (voir section 2.1, p. 5). Il faut disposer d’un minimum de 120Mo, mais on recommande au moins 400Mo pour un système standard ou 800Mo pour un système complet. 3. Vous pouvez incorporer un jeu de composants particulier ou une collection dans un système TEX déjà présent, soit un système TEX Live installé précédemment, soit un système TEX différent. Ces trois utilisations sont décrites en détail dans les sections concernant l’installation spécifique à chaque système. Quelques remarques générales : – Le script d’installation globale pour Unix et pour MacOSX s’appelle install-tl.sh. Les uti- lisateurs de Linux peuvent aussi essayer le nouvel installeur setuptl/tlpmgui développé au départ pour Windows et adapté à Linux. Consulter la section 6 p. 20 pour plus d’informations. – Pour installer une extension ou une collection, on utilise le script d’installation install-pkg.sh. Après une installation faite à l’aide de tlpmgui, il est possible d’utiliser tlpmgui pour ajouter ou supprimer des extensions ou des collections. – Le programme d’installation pour Windows s’appelle tlpmgui.exe, il sert aussi à ajouter ou supprimer des composants dans une installation existante (voir section 6). 1.2 Obtenir de l’aide La communauté TEX est à la fois active et conviviale ; pratiquement toute question sérieuse finit 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 live dans texmf-doc/doc/ english/FAQ-en 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, ... particuliers, il faut examiner le catalogue TEX. C’est une importante liste de tous les éléments relatifs à TEX. Voir texmf-doc/doc/english/catalogue sur le DVD live, ou http://www.ctan.org/ tex-archive/help/Catalogue. Ressources TEX sur le Web La page web http://tug.org/interest.html propose beau- coup 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 2 STRUCTURE DE TEX LIVE 5 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 n’obtenez pas de réponse, vous pouvez poster la question à comp. text.tex via Google ou votre lecteur de news, ou encore par messagerie à 2 STRUCTURE DE TEX LIVE 6 2.2 Répertoires situés à la racine Les répertoires les plus importants situés à la racine du DVD live sont énumérés ci-dessous. Cette année, la distribution TEX Live est dans un sous-répertoire texlive2007 et non à la racine. bin Programmes de la famille TEX, rangés dans des sous-répertoires selon les plates-formes. source Le code source de tous les programmes, incluant la distribution Web2C de TEX et METAFONT. Il s’agit d’une archive au format tar, compressée par bzip2. Faute de place, le répertoire source n’est pas sur le CD inst (seulement sur le DVD live). setuptl Programmes d’installation pour Windows et Linux. support Ensemble d’extensions et programmes auxiliaires. 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 (appelé TEXMFMAIN dans la section suivante.) texmf-dist Répertoire principal où se trouvent les extensions, les fontes, etc., avec leur documentation (appelé TEXMFDIST dans la section suivante.) texmf-doc Répertoire contenant le reste de la documentation, le sous-répertoire doc est organisé par langue. texmf-var Répertoire contenant les fichiers générés automatiquement (appelé TEXMFSYSVAR dans la section suivante.) 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ù quelles soient sur le disque. Le fichier doc.html du DVD live contient une liste de liens bien utiles pour localiser les fichiers de documentation. On trouve également, au même niveau que les répertoires mentionnés ci-dessus, les scripts d’ins- tallation et les fichiers README (dans différentes langues). 2.3 Description des arborescences texmf utilisées 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.), les fichiers .pool, etc. TEXMFDIST contient les fichiers de macro (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 place 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éper- toire est sous $HOME par défaut. La variable TEXINPUTS ne devrait plus être utilisée. 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 $HOME par défaut. 2 STRUCTURE DE TEX LIVE 7 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 configu- ration. 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. Les possibilités offertes par texconfig sont décrites à la section 4.1, p. 16. 2.4 Les extensions de T X E TEX Live contient plusieurs extensions de TEX. ε-TEX ajoute un jeu, petit mais puissant, de nouvelles primitives et les extensions TEX--XET pour l’écriture de droite à gauche ; ε-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 live. pdfTEX inclut les extensions ε-TEX et produit, au choix, des fichiers au format Acrobat PDF ou au format DVI. Le manuel d’utilisation se trouve sur le DVD live dans texmf/doc/pdftex/ manual/. Le fichier texmf/doc/pdftex/pdftex/manual/samplepdf/samplepdf.tex donne un exemple d’utilisation. pdfTEX est le moteur de base sur lequel sont construits tous les formats autres que plainTEX. XeTEX ajoute la possibilité d’utiliser le codage Unicode en entrée et les fontes OpenType en sortie, ceci grâce à des bibliothèques externes : voir http://scripts.sil.org/xetex. Ω (Omega) fonctionne en utilisant Unicode et des caractères 16 bits, ce qui lui permet de tra- vailler directement et simultanément avec presque toutes les écritures du monde entier. L’extension supporte aussi le chargement dynamique d’OTP (Ω 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 Ω et de ε-TEX. texmf-dist/doc/aleph/base contient une documentation de base. 2.5 Quelques autres programmes intéressants dans T X Live E 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 approche que celle de pdfTEX (mentionné ci- dessus). Voir les extensions ps4pdf et pdftricks pour d’autres alternatives. psselect, psnup, . . . Utilitaires PostScript. lacheck Vérification de syntaxe LATEX. texexec Processeur ConTEXt et PDF. tex4ht Conversion TEX vers HTML. 3 UTILISATION SOUS UNIX 8 3 Utilisation sous Unix Comme on l’a vu en section 1.1 p. 3, le TEX Live peut être utilisé de trois façons principales : 1. Exécution directe depuis le DVD live. 2. Installation sur le disque dur. 3. Intégration d’un jeu de composants ou collections dans un système TEX déjà installé. Les procédures spécifiques à Unix sont décrites pour chacun de ces cas dans les sections qui suivent. ATTENTION : Les CD et le DVD sont au format ISO 9660 (High Sierra), avec les exten- sions « Rock Ridge » (et « Joliet » pour Windows). Votre système doit pouvoir reconnaître les extensions « Rock Ridge » pour une utilisation optimale de TEX Live. Consultez votre documentation concernant la commande mount pour voir si c’est le cas. Si votre réseau local est constitué de machines différentes, regardez si vous pouvez monter les CD sur une machine qui supporte Rock Ridge et utiliser ce point de montage pour les autres machines. L’utilisation des CD sur les systèmes modernes ne devrait pas poser de problèmes. S’il y en avait, n’hésitez pas à nous le faire savoir. La suite de ce document suppose que vous avez installé et monté les CD avec une compatibilité Rock Ridge parfaite. N.B. : les droits de « root » sont souvent requis pour monter le CD. D’autre part, selon le type d’Unix utilisé, il vous faudra probablement connaître le mot de passe de « root » ou tout au moins utiliser la commande sudo pour effectuer l’installation (le droit d’écriture sur le(s) répertoire(s) d’installation est évidemment indispensable). Cette remarque concerne particulièrement les utili- sateurs de MacOSX à qui nous recommandons de prendre d’abord connaissance de la section 5 avant toute installation. 3.1 Utiliser TEX Live à partir du DVD live La liste des architectures sur lesquelles fonctionne TEX Live est donnée page 11 (table 2). On peut utiliser le système TEX directement depuis DVD live, sans l’installer sur le disque dur (d’où en fait le nom TEX Live). Il n’est pas possible de faire tourner TEX directement depuis le CD inst (voir section 2.1, page 5). Pour démarrer, il faut d’abord « monter » le médium avec les extensions Rock Ridge. La commande exacte varie d’un système à l’autre ; la commande suivante fonctionne sous Linux, mais les noms du périphérique (ici /dev/cdrom) et du point de montage (ici /mnt/cdrom) peuvent changer. N.B. Tous nos exemples utilisent > pour les lignes de commandes (shell prompt) ; les commandes de l’utilisateur sont soulignées. > mount -t iso9660 /dev/cdrom /mnt/cdrom Se placer au point de montage du lecteur : > cd /mnt/cdrom Lancer le script install-tl.sh : > sh install-tl.sh Welcome to TeX Live... 3 UTILISATION SOUS UNIX 9 Après l’affichage de divers messages de bienvenue et une liste des options du menu principal, l’installation réclame l’entrée d’une commande. Taper alors le caractère voulu suivi d’un retour- chariot. Ne pas taper les chevrons (ni < ni >) ; on peut utiliser des majuscules ou des minuscules ; ici, les exemples utilisent des minuscules. Pour exécuter live, la première commande est d suivie de la sous-commande 1 pour choisir le répertoire du disque local où seront placés les fichiers (tels que les fontes et les formats) que le système T X génère lui-même ainsi que les fichiers de configuration si besoin est. On utilisera E /opt/texlive2007 dans cet exemple, mais un utilisateur non privilégié peut très bien choisir un sous-répertoire non-existant de son répertoire personnel (il sera créé et ne contiendra donc que du matériel T X Live). Étant donné que les fichiers créés ne sont pas toujours compatibles d’une E année sur l’autre, il est recommandé d’inclure l’année dans le nom du répertoire. Si la valeur par défaut /usr/local/texlive/2007 vous convient (c.-à-d. que /usr/local/texlive/2007 n’est pas un répertoire existant et que vous avez les droits pour écrire sous /usr/local), vous pouvez sauter cette étape. Enter command: d Current directories setup: <1> TEXDIR: /usr/local/texlive/2007 ... Enter command: 1 New value for TEXDIR [/usr/local/texlive/2007]: /opt/texlive2007 ... Enter command: r Retour au menu principal. La seconde (et dernière) commande est r pour faire tourner live à partir du DVD sans pour autant l’installer sur le disque dur : Enter command: r Preparing destination directories... ... Welcome to the TeX Live! > On se retrouve au niveau de la ligne de commande comme on vient de le voir. Il faut maintenant modifier les deux variables d’environnement PATH et TEXMFSYSVAR comme indiqué à l’écran quelques lignes au dessus de « Welcome to TeX Live! ». La syntaxe dépend du shell utilisé. Les syntaxes précises sont affichées pour les shell de type Bourne ou compatible (bash, sh ksh, etc.) et pour les C shells (csh, tcsh). Rappelons qu’il suffit de taper la commande echo $SHELL pour connaître le nom du shell utilisé. Le plus simple est de recopier par copier-coller, soit les deux lignes commençant par « setenv » pour les C shells, soit les trois lignes « PATH= », « TEXMFSYSVAR= », « export ... » pour les shell de type Bourne (suivies d’un retour-chariot) dans le terminal de commandes. Ceci suffit pour pouvoir utiliser la distribution T X Live pendant toute la session. Pour ne pas E avoir à redéfinir PATH et TEXMFSYSVAR à chaque nouvelle connexion, il suffit d’entrer les mêmes commandes à l’aide d’un éditeur dans le fichier d’initialisation du shell (.bash_profile, .profile ou .cshrc selon le cas). L’initialisation se fera ensuite automatiquement au début de chaque nouvelle session. Une fois l’installation terminée et les variables d’environnement initialisées, la dernière étape consiste à exécuter texconfig ou texconfig-sys pour éventuellement modifier certains paramètres. Ceci est expliqué à la section 4.1, p. 16. Passez maintenant à la section 4.2 pour effectuer quelques tests de bon fonctionnement. 3 UTILISATION SOUS UNIX 10 En cas de doute, n’hésitez pas à contacter un gourou système pour vous aider à résoudre vos problèmes, tels que la façon de monter le médium TEX Live, le choix des répertoires à utiliser ou les modifications à apporter dans vos fichiers d’initialisation. 3.2 Installer T X Live sur le disque E Il est possible, et même habituel, d’installer le système TEX à partir du TEX Live sur le disque (« dur »). Ceci peut se faire en utilisant soit le DVD live, soit le CD inst (voir section 2.1, p. 5 pour des explications sur les différentes distributions). Pour démarrer, il faut d’abord «monter » le médium avec les extensions Rock Ridge. La commande exacte varie d’un système à l’autre ; la commande suivante fonctionne sous Linux, mais les noms du périphérique (ici /dev/cdrom) et du point de montage (ici /mnt/cdrom) peuvent changer. N.B. Tous nos exemples utilisent > pour les lignes de commandes (shell prompt) ; les commandes de l’utilisateur sont soulignées. > mount -t iso9660 /dev/cdrom /mnt/cdrom Se placer au point de montage du lecteur : > cd /mnt/cdrom Lancer le script install-tl.sh : > sh install-tl.sh Welcome to TeX Live... Après l’affichage de divers messages de bienvenue et une liste des options du menu principal, l’installation réclame l’entrée d’une commande. Taper alors le caractère voulu suivi d’un retour- chariot. Ne pas taper les chevrons (ni < ni >) ; on peut utiliser des majuscules ou des minuscules ; ici, les exemples utilisent des minuscules. La table 1 donne la liste des options du menu principal. On peut choisir les options dans n’importe quel ordre, mais i doit être la dernière choisie. Il est cependant raisonnable de procéder dans l’ordre où elles apparaissent ici ! Table 1 – Options d’installation du menu principal p plate-forme que vous utilisez b choix des binaires à installer (architectures multiples) s schéma d’installation de base (complet, recommandé, GUTenberg, etc.). c modifier le choix des collections individuelles l modifier le choix des langues à installer d répertoire où faire l’installation o autres options i lancer l’installation Voici quelques précisions sur chaque option. p – Platform (current). Plate-forme utilisée. Le script d’installation détecte automatiquement la plate-forme sur laquelle il tourne, il est en général inutile de modifier cette option, sauf en cas d’erreur.