## Guide pratique de TeX Live 2024

Karl Berry, éditeur
https://tug.org/texlive/
Version française
Denis Bitouzé & Patrick Bideault∗
Mars 2024

### Table des matières

1 Introduction
1.1 TeX Live et TeXCollection
1.2 Prise en charge des diﬀérents systèmes d’exploitation
1.3 Installation élémentaire de TeX Live
1.4 Remarques sur la sécurité
1.5 Obtenir de l’aide
1.5.1 Aide en français
1.5.2 Aide en anglais
1.5.3 Aide en allemand
1.5.4 Aide dans d’autres langues
1.6 Apporter de l’aide
2 Structure de TeX Collection
2.1 TeX Collection : TeX Live, MacTeX, MiKTeX, CTAN
2.2 Répertoires situés à la racine de TeX Live
2.3 Description des arborescences « texmf » de TeX Live
2.4 Extensions de TeX
2.5 Quelques autres programmes intéressants dans TeX Live
3 Installation
3.1 Démarrage de l’installation
3.1.1 Installation sous Unix
3.1.2 Installation sous macOS
3.1.3 Installation sous Windows
3.1.4 Installation sous Cygwin
3.1.5 Installation en mode texte
3.1.6 Installation en mode graphique
3.1.7 Les anciens installateurs
3.2 Choix des options d’installation
3.2.1 Choix des binaires (Unix seulement)
3.2.2 Sélection de ce qui va être installé
3.2.3 Répertoires d’installation
3.2.4 Options
3.3 Options de install-tl en ligne de commande
3.3.1 L’option -repository
3.4 Étapes post-installation
3.4.1 Variables d’environnement sous Unix
3.4.2 Variables d’environnement : conﬁguration multi-utilisateur
3.4.3 Mises à jour par Internet après une installation par le DVD
3.5 Conﬁguration des fontes pour XeTeXet LuaTeX
3.5.1 ConTeXt LMTX et MkIV
3.5.2 Ajout de ﬁchiers locaux ou personnels
3.5.3 Ajout de fontes externes à TeX Live
3.6 Test de l’installation
3.7 Désinstaller la TeX Live
3.8 Liens vers d’autres logiciels téléchargeables
4 Installations spécialisées
4.1 Installation partagée entre plusieurs utilisateurs ou machines
5 Installations « portables » de TeX Live
6 Maintenance de l’installation avec tlmgr
6.1 GUI actuelles pour le tlmgr
6.2 Exemples d’utilisation de tlmgr en ligne de commande
7 Notes concernant Windows
7.1 Fonctionnalités supplémentaires à l’installation
7.2 Programmes supplémentaires
7.3 Utilisation d’installations externes de Perl, Tcl/Tk et Ghostscript
7.4 Répertoire personnel
7.5 Base de registre Windows
7.6 Droits d’accès sous Windows
7.7 Augmentation de la limite de mémoire sous Windows et Cygwin
8 Guide d’utilisation du système Web2C
8.1 Kpathsea et la recherche de ﬁchiers
8.1.1 Les diﬀérentes sources
8.1.2 Fichiers de conﬁguration
8.1.3 Expansion d’un chemin de recherche
8.1.4 Expansion par défaut
8.1.5 Expansion spéciﬁée par les accolades
8.1.6 Expansion des sous-répertoires
8.1.7 Récapitulatif des caractères spéciaux dans les ﬁchiers texmf.cnf
8.2 Bases de données
8.2.1 Le ﬁchier 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
8.4 $TEXMFDOTDIR
9 Remerciements
10 Historique des versions successives
10.1 Éditions précédentes
10.1.1 2003
10.1.2 2004
10.1.3 2005
10.1.4 2006–2007
10.1.5 2008
10.1.6 2009
10.1.7 2010
10.1.8 2011
10.1.9 2012
10.1.10 2013
10.1.11 2014
10.1.12 2015
10.1.13 2016
10.1.14 2017
10.1.15 2018
10.1.16 2019
10.1.17 2020
10.1.18 2021
10.1.19 2022
10.1.20 2023
10.2 Présent : 2024
10.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, macOS et systèmes Windows.

Cette distribution peut être obtenue par téléchargement, sur le DVD TeX Collection distribué par les groupes d’utilisateurs de TeX à leurs membres, ou par d’autres moyens. La section 2.1 décrit brièvement le contenu du DVD. TeX Live et TeX Collection sont le fruit des eﬀorts 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, ConTeXt, Metafont, MetaPost, BibTeX et de nombreux autres programmes ainsi qu’une bibliothèque étendue de macros, de fontes et de documentations. Elle permet aussi la composition de textes dans la plupart des langues utilisées dans le monde.

On trouvera à la ﬁn du document, section 10 (page 112), un bref historique des principales modiﬁcations apportées au ﬁl 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 10.2 page 152 qui présente les principaux changements intervenus cette année.

#### 1.2 Prise en charge des diﬀérents systèmes d’exploitation

TeX Live contient les exécutables pour les principales architectures Unix, dont GNU/Linux, macOS et Cygwin. Les sources inclus dans la distribution devraient être compilables sur des plateformes pour lesquelles nous ne fournissons pas d’exécutables.

Concernant Windows, les versions 7 et ultérieures sont prises en charge. Windows Vista peut probablement fonctionner en bonne partie, mais TeX Live ne saurait dorénavant être installée sur XP ou versions antérieures. La TeX Live inclut des exécutables 64 bit pour Windows.

Consulter la section 2.1 pour des solutions alternatives sous Windows et macOS.

#### 1.3 Installation élémentaire de TeX Live

Vous pouvez installer TeX Live de deux façons diﬀérentes : soit depuis le DVD, soit depuis Internet (https://tug.org/texlive/acquire.html). L’installateur réseau est petit et télécharge tout ce qu’il faut depuis Internet.

L’installateur du DVD vous permet d’installer sur votre disque dur mais il n’est plus possible de lancer TeX Live directement depuis le DVD TeX Collection (ou une image .iso). Vous pouvez créer une installation portable, par exemple sur une clé USB (voir section 5). La procédure d’installation est décrite en détail dans les sections suivantes (page 20), mais voici de quoi commencer rapidement.

- Sous Unix, le script d’installation est install-tl. Sous Windows, il faut plutôt invoquer install-tl-windows. L’installateur fonctionnera en mode graphique avec l’option -gui (par défaut pour Windows) ou en mode texte avec l’option -gui=text (par défaut pour tout le reste).

- Ce script installe en particulier le programme « TeX Live Manager » appelé tlmgr. Comme l’installateur, il peut être utilisé en mode graphique ou en mode texte. Il permet d’ajouter ou de supprimer des composants et de procéder à diﬀérents réglages de conﬁguration.

#### 1.4 Remarques sur la sécurité

À notre connaissance, les programmes TeX de base en eux-mêmes sont (et ont toujours été) extrêmement robustes. Cependant, d’autres programmes livrés avec TeX Live ne le sont peut-être pas autant, bien que chacun fasse de son mieux. De façon générale, il faut faire preuve de prudence avant de lancer des programmes sur des données en lesquelles vous n’avez pas toute conﬁance. Pour un maximum de sécurité, utilisez un nouveau répertoire créé à cet eﬀet ou chroot.

Il convient d’être particulièrement vigilant sous Windows, qui en général cherche les programmes dans le répertoire courant avant tout, quel que soit le chemin de recherche déﬁni. Nous avons comblé de nombreuses failles, mais il en reste certainement d’autres, notamment avec les programmes maintenus extérieurement. C’est pourquoi nous recommandons de vériﬁer s’il n’y a pas de ﬁchiers suspects dans le répertoire courant, en particulier les exécutables (binaires ou scripts). En général, il ne devrait pas y en avoir, et le simple fait de compiler un document devrait encore moins en créer.

Enﬁn, TeX (et les programmes associés) ont la capacité d’écrire des ﬁchiers en compilant des documents, capacité qui peut être exploitée à des ﬁns malignes de nombreuses façons. Ici aussi, la meilleure protection est de compiler les documents inconnus dans un répertoire nouvellement créé.

Un autre aspect de la sécurité consiste à s’assurer que le matériel téléchargé n’a pas été modiﬁé par rapport à ce qui a été créé. Le programme tlmgr (section 6) eﬀectuera automatiquement des vériﬁcations des téléchargements si le gpg (GNU Privacy Guard) est disponible. Il n’est pas distribué par la TeX Live, mais voir https://texlive.info/tlgpg/ pour des informations sur gpg si nécessaire.

#### 1.5 Obtenir de l’aide

##### 1.5.1 Aide en français

Si vous connaissez mal le système TeX, ou que vous n’êtes pas certain de vouloir installer TeX Live, vous pouvez avoir un aperçu du fonctionnement de l’un de ses logiciels principaux en lisant la Une courte (?) introduction à LaTeX2e, dont la traduction française est disponible à l’adresse https://mirrors.ctan.org/info/lshort/french/lshort-fr.pdf.

À la suite de cette lecture, vous n’aurez de cesse d’utiliser LaTeX2e, et donc d’installer TeX Live : il vous suﬃra tout simplement de reprendre ici la lecture du présent document pour eﬀectuer sereinement cette installation. Ce document a été rédigé pour vous guider lors de celle-ci.

Une fois installée, votre distribution TeX Live sera prête à l’emploi. C’est alors que la commande 1 texdoc vous sera d’une aide précieuse, puisqu’elle vous permettra d’aﬃcher la documentation des diﬀérents composants de TeX Live.

Ainsi, pour lire la Courte Introduction citée plus haut, vous n’aurez qu’à taper texdoc lshort-fr (vous remarquerez que la chaîne de caractères lshort-fr est également présente dans l’URL citée plus haut : c’est son nom au sein de TeX Live). Et pour aﬃcher de nouveau le présent document, vous taperez texdoc texlive-fr. Faites l’essai!

En toute logique, la commande texdoc texdoc vous indiquera comment vous servir au mieux de cette commande, par exemple pour qu’elle utilise votre lecteur PDF favori, ou pour qu’elle aﬃche automatiquement les documentations en français (si elles ont été traduites).

Car voilà : l’intégralité de la documentation des innombrables composants de TeX Live n’est pas encore disponible en français, tant s’en faut.

Fort heureusement, des ressources francophones de qualité existent. La documentation de LaTeX2e est traduite : elle est accessible via la commande texdoc latex2e-fr. Une communauté d’utilisateurs a recensé d’autres ressources à l’adresse suivante : https://texnique.fr/osqa/questions/2559/des-sources-dinformation-pour-debutants.

En eﬀet, la communauté TeX est active et conviviale; la plupart des questions ﬁnissent par obtenir une réponse. En revanche, la prise en charge est informelle, assurée par des volontaires et des usagers occasionnels, aussi est-il particulièrement important que vous fassiez votre propre travail de recherche avant de poser une question (si vous préférez une prise en charge commerciale, vous pouvez renoncer à TeX Live et acheter un système payant; voir une liste, en anglais, à https://tug.org/interest.html#vendors).

Avant de poser une question à d’autres utilisateurs, nous vous invitons à vériﬁer qu’elle n’a pas déjà été posée : un moteur de recherche, par exemple https://duckduckgo.com/, peut à lui seul fournir des réponses pertinentes, et les archives des diﬀérents espaces de discussion contiennent des milliers de questions et réponses déjà traitées; elles permettent une recherche fructueuse.

Enﬁn, avant de poser une question, n’hésitez pas à prendre conseil sur la façon de rédiger la question pour avoir des chances d’obtenir une réponse pertinente. Soyez clair, précis et concis. Et illustrez votre propos avec un exemple complet minimal (les trois termes sont importants), comme indiqué ici : https://texnique.fr/osqa/faq/#custom-id-ecm.

Ces précautions étant prises, il est temps de vous présenter les trois espaces de discussion en ligne des utilisateurs francophones.

FAQ TeX francophone

  – La TeX FAQ francophone est un recueil de réponses à toutes sortes de questions, des plus élémentaires aux plus obscures. Elle est disponible sur Internet à l’adresse https://faq.gutenberg-asso.fr/.

texnique.fr

  est un site de questions & réponses. D’utilisation très simple, il permet aux utilisateurs ayant besoin d’aide de poser des questions, à d’autres de leur apporter des réponses, et aux visiteurs du site de noter celles-ci selon leur pertinence, ce qui permet de les repérer eﬃcacement. Les questions sont triées par mots-clés, et le site oﬀre la compilation en ligne des exemples de code qui y sont postés. Il est accessible à l’adresse https://texnique.fr/.

la liste GUT

  est une liste de discussion par courriel comptant un grand nombre d’abonnés. Elle permet de demander ou d’apporter de l’aide, mais aussi de débattre ou d’exprimer des opinions, ce qui n’est pas l’objet du site cité plus haut. Pour vous inscrire à cette liste, envoyez un message à sympa@ens.fr avec subscribe gut comme corps ou sujet du message.

fctt

  est l’appellation usuelle du groupe de nouvelles Usenet très fréquenté fr.comp.text.tex. Pour l’utiliser de façon ergonomique, il est conseillé de recourir à un lecteur de news, par exemple celui intégré au logiciel de courriel Thunderbird. Ses archives sont consultables à l’adresse https://groups.google.com/g/fr.comp.text.tex.

Il est à noter que le site texnique.fr et la liste GUT sont soutenus par l’association GUTenberg, qui est le groupe francophone des utilisateurs de TeX, LaTeX et logiciels compagnons. Le site de l’association est accessible à l’adresse https://www.gutenberg-asso.fr/. Les traducteurs de la présente documentation sont également membres de l’association, qui elle-même contribue au développement de TeX Live.

##### 1.5.2 Aide en anglais

Donald Knuth, l’auteur de TeX, est anglophone : il est donc logique qu’une large documentation existe en anglais. Voici une liste de ressources anglophones, classées selon l’ordre dans lequel nous recommandons de les utiliser :

Getting Started

  – pour ceux qui débutent en TeX, la page Web https://tug.org/begin.html contient une courte description du système.

CTAN

  Si vous recherchez un package, une police, un programme particulier, etc., CTAN est l’endroit où commencer à chercher. Il s’agit d’une énorme collection de tous les éléments liés à TeX. Les entrées du catalogue vous indiquent également la disponibilité de la ressource correspondante pour TeX Live ou MiKTeX. Voir https://ctan.org.

FAQ TeX

  – La TeX FAQ est un recueil de réponses à toutes sortes de questions, des plus élémentaires aux plus obscures. Elle est disponible sur Internet à l’adresse https://texfaq.org.

Catalogue TeX

  – si vous recherchez une extension, une fonte, un programme, etc., le mieux est de consulter le catalogue TeX ici : https://ctan.org/pkg/catalogue.

Ressources TeX sur le Web

  – la page Web https://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.

Sites d’entraide

  – une recherche générale sur le Web ne fait jamais de mal. Les principaux forums dédiés à l’entraide au sujet de TeX sont le site de la communauté LaTeX https://latex.org/, le site de questions & réponses https://tex.stackexchange.com/ et la liste de diﬀusion texhax@tug.org (dont les archives sont à l’adresse https://tug.org/mail-archives/texhax).

Poster une question

  – si vous ne trouvez pas réponse à votre question, vous pouvez la poser sur https://latex.org/ et https://tex.stackexchange.com/ via leurs interfaces Web ou sur texhax@tug.org par mail. Mais, avant de poser votre question, nous vous conseillons de lire la FAQ https://texfaq.org/FAQ-askquestion aﬁn de maximiser vos chances d’obtenir une réponse utile.

Enﬁn, l’organisation internationale des utilisateurs de TeX, le TeX Users Group, ou TUG, est anglophone. Basée aux États-Unis, elle fédère toutes les associations nationales et son site est à l’adresse https://tug.org/.

Parmi ses très nombreuses activités, elle organise une conférence annuelle, publie une revue, le TUGboat, qui paraît trois fois par an, ainsi qu’une collection de logiciels appelée... TeX Live!

##### 1.5.3 Aide en allemand

La communauté germanophone est très active. Elle organise de solides séminaires ainsi que des rencontres informelles, publie des ouvrages de grande qualité... et a produit de très nombreuses lignes de code utilisées par TeX Live! Le groupe germanophone des utilisateurs de TeX s’appelle dante et son site est à l’adresse https://www.dante.de/. Il publie régulièrement une revue, Die TeXnische Komödie, et soutient le forum https://golatex.de/.

Enﬁn, le site germanophone de questions & réponses https://texwelt.de/ est le grand frère du francophone texnique.fr!

##### 1.5.4 Aide dans d’autres langues

TeXest répandu dans le monde entier, et des groupes d’utilisateurs existent dans de nombreux pays, de la Bulgarie à l’Afrique du Sud! On en trouvera la liste à l’adresse https://tug.org/usergroups.html.

#### 1.6 Apporter de l’aide

Il vous est possible d’apporter une aide précieuse aux autres utilisateurs :

Prise en charge 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 diﬀusion 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 diﬀusion qui maintient le programme. Il suﬃt souvent d’ajouter l’option --help lors de l’exécution du programme pour trouver à qui adresser le rapport.

Aide en ligne

  – des personnes soumettent des questions, et leur répondre est très utile, tant pour eux que pour vous : formuler clairement une réponse est une source d’apprentissage non négligeable! Les sites LaTeX, tels texnique.fr, les groupes de nouvelles comme fr.comp.text.tex ainsi que la liste gut sont ouverts à tous : n’hésitez pas à vous y joindre, à commencer la lecture et à fournir de l’aide là où cela vous est possible.

Traduction

  – le présent document a été rédigé puis traduit bénévolement, pour le bien de la communauté. Il en va de même pour l’essentiel des logiciels et de leur documentation. Comme la rédaction de réponses, la traduction est un exercice très proﬁtable en termes d’apprentissage. Si la documentation qui vous est nécessaire n’est pas encore disponible en français, n’hésitez pas à la traduire vous-même et à en faire proﬁter les autres utilisateurs! Les coordonnées des auteurs des logiciels ﬁgurent généralement dans la documentation originale de ceux-ci; dès lors, il est très simple de prendre contact avec eux pour publier votre traduction.

### 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, MacTeX, MiKTeX, CTAN

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

TeX Live

  – Un système multiplateforme complet TeX à installer sur disque. Page Web : https://tug.org/texlive/.

MacTeX

  – pour macOS. Cela ajoute un installateur natif pour macOS et d’autres applications Mac à TeX Live. Page Web : https://tug.org/mactex/.

MiKTeX

  Une autre distribution complète et multiplateforme TeX pour Windows, GNU/Linux et macOS (mais seuls les binaires Windows sont inclus dans le DVD). Elle dispose d’un gestionnaire de paquets intégré qui, si nécessaire, installe les composants manquants à partir d’Internet. Page Web : https://miktex.org/.

CTAN

  – une image du site d’archives CTAN (https://ctan.org/). CTAN ne suit pas les mêmes conditions de copie que TeX Live, pensez à lire les licences si vous envisagez de modiﬁer ou de redistribuer certains de ces ﬁchiers.

#### 2.2 Répertoires situés à la racine de TeX Live

Voici une petite liste des répertoires situés à la racine d’une installation TeX Live avec une courte description.

bin

  – programmes de la famille TeX, rangés dans des sous-répertoires selon les plateformes.

readme-*.dir

  – une brève introduction et quelques liens utiles pour TeX Live, dans divers langages, sous forme de pages HTML ou de texte brut.

source

  – le code source de tous les programmes, dont les principaux programmes TeX basés sur Web2C.

texmf-dist

  – le répertoire principal; voir TEXMFDIST dans la section suivante.

tlpkg

  – scripts et programmes d’installation, et éléments spéciﬁques pour Windows.

On trouve également, au même niveau que les répertoires mentionnés ci-dessus, les scripts d’installation et le ﬁchier README principal en anglais (disponible en diﬀérentes langues dans les répertoires readme-*.dir susmentionnés).

En plus des répertoires ci-dessus, les scripts d’installation et les ﬁchiers README (dans diﬀérentes langues) sont situés dans le dossier racine de la distribution.

Concernant la documentation, le ﬁchier doc.html, qui contient une liste exhaustive de liens vers les ﬁchiers de documentation, pourra s’avérer utile. La documentation pour presque tout (paquets, formats, fontes, manuels de logiciels, pages de man, ﬁchiers info) se trouve dans texmf-dist/doc. Vous pouvez utiliser le programme texdoc pour trouver une documentation, où qu’elle soit.

La documentation de TeX Live proprement dite (que vous consultez actuellement) est disponible dans le répertoire texmf-dist/doc/texlive en plusieurs langues :

- anglais : texmf-dist/doc/texlive/texlive-en,

- allemand : texmf-dist/doc/texlive/texlive-de,

- espagnol : texmf-dist/doc/texlive/texlive-es,

- chinois (simpliﬁé) : texmf-dist/doc/texlive/texlive-zh-cn,

- français : texmf-dist/doc/texlive/texlive-fr,

- italien : texmf-dist/doc/texlive/texlive-it

- polonais : texmf-dist/doc/texlive/texlive-pl,

- russe : texmf-dist/doc/texlive/texlive-ru,

- tchèque & slovaque : texmf-dist/doc/texlive/texlive-cz.

#### 2.3 Description des arborescences « texmf » de TeX Live

Nous donnons ici la liste des variables prédéﬁnies qui contiennent les noms des diﬀérentes arborescences de type « texmf », l’usage qui en est fait, et leurs valeurs par défaut dans TeX Live. La commande tlmgr conf montre les valeurs de ces variables, ce qui permet de savoir où se trouvent ces diﬀérentes arborescences dans une installation donnée.

Notez bien que toutes ces arborescences, y compris les arborescences personnelles, doivent suivre la structure standard des répertoires de TeX (TDS : https://tug.org/tds) avec sa pléthore de sous-répertoires, sans quoi les ﬁchiers ne seront pas pris en compte. La section 3.5.2 page 57 donne plus de détails à ce sujet. L’ordre ici est l’inverse de celui dans lequel les arborescences sont cherchées, c’est-à-dire que les dernières arborescences dans la liste outrepassent les précédentes.

TEXMFDIST

  – contient à peu près tous les ﬁchiers de la distribution originale : ﬁchiers de conﬁguration, scripts, paquets, polices, etc. (La principale exception concerne les exécutables de chaque plateforme placés dans le répertoire apparenté bin/). Rien ne devrait être ajouté, modiﬁé ni supprimé manuellement dans cette arborescence.

TEXMFSYSVAR

  – c’est là que les scripts texconﬁg-sys, updmap-sys, fmtutil-sys et tlmgr rangent les (versions globales des) données générées, comme les formats et les ﬁchiers `.map`.

TEXMFSYSCONFIG

  – c’est là que les scripts texconﬁg-sys, updmap-sys et fmtutil-sys recherchent leurs ﬁchiers de conﬁguration (globaux) en priorité.

TEXMFLOCAL

  – c’est l’arborescence que les administrateurs peuvent utiliser pour installer pour tous les utilisateurs les extensions, fontes, etc. additionnelles ou mises à jour.

TEXMFHOME

  – c’est l’arborescence que les utilisateurs peuvent utiliser pour leurs installations individuelles de macros, polices, etc. supplémentaires ou de mises à jour. Pour chaque utilisateur, cette variable pointe vers son propre répertoire individuel.

TEXMFVAR

  – c’est là que les scripts texconﬁg, updmap-user et fmtutil-user rangent les (versions personnelles de) données générées, comme les formats et les ﬁchiers `.map`.

TEXMFCONFIG

  – c’est là que les scripts texconﬁg updmap-sys et fmtutil-sys recherchent leurs ﬁchiers de conﬁguration (personnelles) en priorité.

TEXMFCACHE

  – arborescence(s) utilisée(s) par ConTeXt MkIV et LuaLaTeX pour stocker des (versions de cache de) ﬁchiers de travail. Par défaut, utilise TEXMFSYSVAR ou, s’il n’est pas possible d’y écrire, TEXMFVAR.

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

racine multi-utilisateur

  (p. ex. /usr/local/texlive sous Unix, D:\texlive sous Windows, etc.) qui contient éventuellement plusieurs distributions :

  2023

    – une distribution précédente,

  2024

    – la distribution actuelle,

    bin

      i386-linux

        – exécutables Linux (32 bit),

      ...

      universal-darwin

        – exécutables macOS,

      x86_64-linux

        – exécutables GNU/Linux (64 bit),

      windows

        – exécutables Windows (64 bit),

    texmf-dist

      – correspond à TEXMFDIST et TEXMFMAIN,

    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%` :

  .texlive2023

    – ﬁchiers propres à l’utilisateur générés automatiquement pour une distribution TeX Live précédente,

  .texlive2024

    – ﬁchiers propres à l’utilisateur générés automatiquement pour la distribution TeX Live actuelle,

    texmf-var

      – correspond à TEXMFVAR, TEXMFCACHE,

    texmf-config

      – correspond à TEXMFCONFIG,

  texmf

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

#### 2.4 Extensions de TeX

Le programme TeX original de Knuth est ﬁgé, sauf corrections de bugs, rares. C’est toujours le programme tex présent dans TeX Live, et ceci ne changera pas autant dans un futur prévisible. TeX Live contient plusieurs variantes étendues de TeX (aussi appelées « moteurs 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 ﬁchier texmf-dist/doc/etex/base/etex_man.pdf du DVD.

pdfTeX

  inclut les extensions e-TeX et produit, au choix, des ﬁchiers au format Acrobat PDF ou au format DVI; il inclut aussi de nombreuses extensions indépendantes du format de sortie. C’est le programme invoqué pour de nombreux formats courants tels que etex, latex et pdﬂatex. Son site Web est https://tug.org/applications/pdftex/. Le manuel d’utilisation se trouve sur le DVD dans texmf-dist/doc/pdftex/manual/pdftex-a.pdf. Le ﬁchier texmf-dist/doc/pdftex/samplepdftex/samplepdf.tex donne des exemples d’utilisation.

LuaTeX

  ajoute la prise en charge d’un codage d’entrée Unicode et des polices OpenType/TrueType et système. Il intègre également un interprète Lua ( https://lua.org/), permettant des solutions à de nombreux épineux problèmes TeX. Lorsqu’il est appelé sous le nom de texlua, il fonctionne comme un interpréteur Lua autonome. Son site Web est http://luatex.org/, et le manuel de référence est texmf-dist/doc/luatex/base/luatex.pdf.

(e)(u)pTeX

  ont une prise en charge native pour la composition en japonais; pTeX est le moteur de base, tandis que les variantes e- ajoutent e-TeX et u- ajoutent la prise en charge Unicode.

XeTeX

  ajoute la prise en charge d’un codage d’entrée Unicode et des polices OpenType/TrueType et système, implémentées à l’aide de bibliothèques standard tierces. Voir https://tug.org/xetex.

Omega (Omega)

  fonctionne en utilisant Unicode et des caractères 16 bit, ce qui lui permet de travailler directement et simultanément avec presque toutes les écritures du monde. L’extension prend en charge aussi le chargement dynamique d’OTP (Omega Translation Processes) qui permet à l’utilisateur d’appliquer sur des ﬂux d’entrée quelconques des transformations complexes qu’il aura lui-même déﬁnies. TeX Live n’inclut plus Omega en tant que programme séparé; seul Aleph est fourni.

Aleph

  combine les fonctionnalités de Omega et de e-TeX; voir texmf-dist/doc/aleph/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, biber

  – traitement des bibliographies.

makeindex, upmendex, xindex, xindy

  – traitement des index.

dvips

  – conversion DVI vers PostScript.

dvipdfmx

  – conversion DVI vers PDF, une alternative à pdfTeX (mentionné ci-dessus) pour produire des ﬁchiers PDF.

xdvi

  – visualisation DVI pour le système X Window.

dviconcat, dviselect

  – couper/coller de pages à partir de ﬁchiers DVI.

psselect, psnup, ...

  – utilitaires PostScript.

pdfjam, pdfjoin, ...

  – utilitaires PDF.

context, mtxrun

  – processeurs ConTeXt et PDF.

htlatex, ...

  tex4ht : (LA)TeX vers HTML (et XML et DocX et autres).

### 3 Installation

#### 3.1 Démarrage de l’installation

La première chose à faire est de télécharger le programme d’installation par le réseau ou de récupérer le DVD TeX Collection. La page https://tug.org/texlive/acquire.html donne plus d’informations sur les diﬀérentes façons d’obtenir le logiciel.

Installateur réseau, .zip ou .tar.gz

  – télécharger l’archive depuis le CTAN dans systems/texlive/tlnet; l’URL https://mirror.ctan.org/systems/texlive/tlnet/ devrait vous rediriger vers le serveur d’archive le plus proche de chez vous. Deux versions sont disponibles, install-tl.zip utilisable sous Unix et Windows, et install-unx.tar.gz pour Unix seulement (y compris macOS). Après décompression de l’un de ces deux ﬁchiers, les scripts install-tl et install-tl-windows.bat se trouveront dans le sous-répertoire install-tl.

Installateur réseau, Windows .exe :

  à télécharger sur CTAN comme ci-dessus, et à exécuter en double-cliquant. Cela lance un installateur préliminaire et décompacteur (voir ﬁgure 1) proposant deux options : « Installation » et « Décompactage seulement ».

DVD TeX Collection

  – aller dans son répertoire texlive. Sous Windows, l’installation démarre en principe automatiquement quand vous insérerez le DVD, sinon, il faudra exécuter 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 https://tug.org/usergroups.html). Il est également possible de l’acheter séparément (https://tug.org/store) ou de graver votre propre DVD pour TeX Live à partir du image ISO téléchargée sur CTAN. Sur la plupart des systèmes, vous pouvez aussi monter directement cette image ISO. Après avoir installé depuis le DVD, si vous voulez accéder aux mises à jour en continu depuis Internet, consultez la section 3.4.3.

Figure 1: Première étape de l’installateur .exe de Windows. En appuyant sur le bouton Installer, vous obtiendrez la fenêtre aﬃchée dans la ﬁgure 3.

Le même programme d’installation est utilisé, quelle que soit la source d’installation. La diﬀérence la plus notable entre ces deux modes est qu’avec l’installation par le réseau, vous obtenez les versions courantes des diﬀérents paquets, contrairement au DVD (ou image ISO) qui n’est pas mis à jour entre deux versions majeures.

Si vous devez télécharger par le biais des serveurs mandataires (proxies), utilisez un ﬁchier ~/.wgetrc ou des variables d’environnement avec une conﬁguration de serveur mandataire pour Wget (https://www.gnu.org/software/wget/manual/html_node/Proxies.html), ou équivalent pour tout autre programme de téléchargement que vous utilisez. TeX Live utilise toujours GNU Wget pour le téléchargement. Bien sûr, ceci ne vous concerne pas si vous installez depuis le DVD ou l’image ISO.

Les sections suivantes expliquent plus en détail le fonctionnement de l’installateur.

##### 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. Le programme install-tl est un script Perl; la façon la plus simple de le démarrer sur un système Unix est la suivante.

> perl /chemin/de/l/installateur/install-tl
Si le ﬁchier install-tl est encore exécutable, vous pouvez aussi n’invoquer que :
> /chemin/de/l/installateur/install-tl
ou changer de répertoire auparavant, via la commande cd; nous ne répéterons plus toutes ces variantes. Il est possible que vous deviez agrandir la fenêtre de votre terminal pour voir le texte complet de l’installateur (ﬁgure 2).

Pour travailler via une interface graphique (GUI), cf. ﬁgure 4, il est nécessaire que Tcl/Tk soit installé. Vous pouvez alors lancer :

> cd /chemin/de/l/installateur
> ./install-tl -gui

Les anciennes options -wizard and -perltk/-expert ont désormais le même eﬀet que -gui. La liste complète des options est donnée par

> perl install-tl -help

Concernant les permissions Unix : 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.

Remarques particulières pour Cygwin : contrairement aux autres systèmes compatibles Unix, Cygwin ne comprend pas par défaut tous les programmes requis pour faire fonctionner l’installateur TeX Live. Voir la section 3.1.4.

##### 3.1.2 Installation sous macOS

Une distribution spéciﬁque, MacTeX (https://tug.org/mactex), a été mise au point pour macOS. Nous recommandons d’utiliser son installateur natif, plutôt que d’installer la distribution TeX Live en suivant la procédure indiquée pour Unix. En eﬀet, MacTeX comprend des ajustements spéciﬁques pour le système macOS et facilite la cohabitation entre plusieurs distributions TeX (MacTeX, Fink, MacPorts, etc.).

MacTeX est fortement basée sur TeX Live et les arborescences principales et les exécutables sont en tous points identiques. Quelques répertoires contenant de la documentation et des applications spéciﬁques au Mac sont ajoutés.

##### 3.1.3 Installation sous Windows

Si vous utilisez le ﬁchier zip téléchargé et décompacté ou si l’insertion du DVD ne lance pas l’installation automatiquement, double-cliquez sur install-tl-windows.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 (à partir du répertoire du script d’installation) :

> install-tl-windows
Si l’on opère à l’extérieur du répertoire dudit script d’installation, il faut écrire :
> D:\texlive\install-tl-windows
où D: désigne le lecteur de DVD où se trouve la collection TeX.

La ﬁgure 3 montre l’écran initial de base de l’installateur en mode GUI, qui est le mode par défaut pour Windows.

Pour travailler en mode texte :

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

Si le même répertoire contient également install-tl-windows.exe, ajoutez une extension .bat. Ce ne sera normalement pas le cas, à moins que vous n’ayez mis en miroir le répertoire tlnet localement.

Les caractères non ASCII dans le chemin d’accès à l’installation de TeX Live doivent être évités. Cela peut poser un problème, en particulier sous Windows 11, où les utilisateurs sont contraints d’utiliser un compte réseau Microsoft. Voir https://tug.org/texlive/windows.html\#nonascii pour quelques solutions de contournement.

    Installing TeX Live 2024 from: ...
    Platform: x86_64-linux => ’GNU/Linux on x86_64’
    Distribution: inst (compressed)
    Directory for temporary files: /tmp
    ...
     Detected platform: GNU/Linux on Intel x86_64

     <B> binary platforms: 1 out of 16

     <S> set installation scheme (scheme-full)

     <C> customizing installation collections
         40 collections out of 41, disk space required: 8296 MB (free: 138718 MB)

     <D> directories:
       TEXDIR (the main TeX directory):
         /usr/local/texlive/2024
       ...

     <O> options:
       [ ] use letter size instead of A4 by default
       ...

     <V> set up for portable installation

    Actions:
     <I> start installation to hard disk
     <P> save installation profile to ’texlive.profile’ and exit
     <H> help
     <Q> quit

Figure 2: Fenêtre principale de l’installateur en mode texte (GNU/Linux)

Figure 3: Fenêtre de l’installateur de base (Windows); le bouton « Avancé » quelque chose ressemblant à la ﬁgure 4

Figure 4: Fenêtre de l’installateur en mode GUI avancé (GNU/Linux)

##### 3.1.4 Installation sous Cygwin

Avant de commencer l’installation, utilisez le programme setup.exe de Cygwin pour installer les paquets perl et wget (si ce n’est déjà fait).

Il est également recommandé d’installer les paquets suivants :

- fontconfig, utilisé par XeTeX et LuaTeX;

- ghostscript, nécessaire pour divers utilitaires;

- libXaw7, utilisé par xdvi;

- ncurses, qui fournit la commande clear utilisée par l’installateur.

##### 3.1.5 Installation en mode texte

La ﬁgure 2 présente l’écran principal de conﬁguration en mode texte sous Unix/Linux, où c’est le mode par défaut.

Il s’agit d’un installateur en mode ligne de commande, il n’y a pas de notion de curseur; par exemple, vous ne pouvez pas naviguer entre les cases à cocher et les champs d’entrée avec la touche tabulation. Tapez une des lettres proposées (en respectant la casse) suivie de « entrée » (retour chariot) et l’écran se mettra automatiquement à jour.

L’interface en mode texte est volontairement rudimentaire aﬁn qu’elle fonctionne sur le plus grand nombre possible de systèmes — même avec des versions très minimales de Perl.

##### 3.1.6 Installation en mode graphique

L’installateur en mode graphique par défaut est au départ très simple, avec juste quelques options; voir ﬁgure 3. Il peut être lancé avec la commande :

> install-tl -gui

Le bouton « Avancé » donne accès à la plupart des options de l’installateur en mode texte; voir ﬁgure 4.

##### 3.1.7 Les anciens installateurs

Les modes perltk/expert et wizard sont toujours disponibles sur les systèmes sur lesquels Perl/Tk est installé. Ils peuvent être spéciﬁés avec les arguments respectivement -gui=perltk and -gui=wizard.

#### 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 platforms:
    ===============================================================================
       a [ ] Cygwin on x86_64 (x86_64-cygwin)
       b [ ] MacOSX current (10.14-) on ARM/x86_64 (universal-darwin)
       c [ ] MacOSX legacy (10.6-) on x86_64 (x86_64-darwinlegacy)
       d [ ] FreeBSD on x86_64 (amd64-freebsd)
       e [ ] FreeBSD on Intel x86 (i386-freebsd)
       f [ ] GNU/Linux on ARM64 (aarch64-linux)
       g [ ] GNU/Linux on RPi(32-bit) and ARMv7 (armhf-linux)
       h [ ] GNU/Linux on Intel x86 (i386-linux)
       i [X] GNU/Linux on x86_64 (x86_64-linux)
       j [ ] GNU/Linux on x86_64 with musl (x86_64-linuxmusl)
       k [ ] NetBSD on x86_64 (amd64-netbsd)
       l [ ] NetBSD on Intel x86 (i386-netbsd)
       m [ ] Solaris on Intel x86 (i386-solaris)
       o [ ] Solaris on x86_64 (x86_64-solaris)
       p [ ] Windows (64-bit) (windows)

Figure 5: Menu pour le choix des binaires

La ﬁgure 5 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 : cela peut être intéressant dans le cas de machines en réseau ou sur des systèmes en « double boot ».

##### 3.2.2 Sélection de ce qui va être installé

    Select scheme:
    ===============================================================================
     a [X] full scheme (everything)
     b [ ] medium scheme (small + more packages and languages)
     c [ ] small scheme (basic + xetex, metapost, a few languages)
     d [ ] basic scheme (plain and latex)
     e [ ] minimal scheme (plain only)
     f [ ] infrastructure-only scheme (no TeX at all)
     g [ ] book publishing scheme (core LaTeX and add-ons)
     h [ ] ConTeXt scheme
     i [ ] GUST TeX Live scheme
     j [ ] teTeX scheme (more than medium, but nowhere near full)
     k [ ] custom selection of collections

Figure 6: Menu « Scheme »

Dans le menu « Scheme » (voir ﬁgure 6) on choisit un schéma général de conﬁguration qui détermine un ensemble de collections à installer. Le schéma par défaut (full) consiste à tout installer, ce qui est recommandé. Vous pouvez également choisir basic pour juste plain et LaTeX, small pour quelques programmes supplémentaires (équivalents à l’installation de MacTeX dite « BasicTeX »), minimal pour des tests uniquement, medium ou teTeX pour quelque chose d’intermédiaire. Il existe aussi des schémas spécialisés ou spéciﬁques à un pays.

Figure 7: Menu « Collections » (Linux)

Une fois un schéma choisi, vous pouvez aﬃner votre sélection avec le menu « collections » (voir ﬁgure 7, montrée ici en mode graphique pour changer).

Il est possible d’aﬃner encore les choix : pour ce faire, il faudra recourir ultérieurement au gestionnaire de paquets TeX Live (tlmgr) — voir la section 6.

##### 3.2.3 Répertoires d’installation

La disposition par défaut des diﬀérents répertoires est donnée à la section 2.3, page 15. Le répertoire d’installation par défaut est /usr/local/texlive/2024 sous Unix et `%SystemDrive%\texlive\2024` sous Windows. Cela permet d’avoir en parallèle plusieurs installations TeX Live, par exemple une par version (typiquement par année, comme ici) et vous pouvez basculer de l’une à l’autre simplement en modiﬁant votre chemin de recherche (votre « PATH »).

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 superutilisateur root ou « Administrateur », il suﬃt d’avoir les droits en écriture sur le répertoire TEXDIR.

Ce répertoire d’installation peut être modiﬁé en conﬁgurant le TEXDIR dans l’installateur. L’écran de l’interface pour ceci – et pour d’autres choix – est montré à la ﬁgure 4. Les principales raisons pour lesquelles il peut être nécessaire de le modiﬁer sont soit le manque de place sur cette partition (une installation TeX Live complète nécessite plusieurs Go), soit l’absence de droit d’écriture sur le répertoire par défaut : comme indiqué précédemment, l’installation n’est pas réservée au superutilisateur root ou « Administrateur »; il suﬃt d’avoir les droits en écriture sur le répertoire TEXDIR.

Sous Windows, vous n’avez normalement pas besoin d’être un administrateur pour créer `C:\texlive\2024` (ou, plus généralement, `%SystemDrive%\texlive\2024`).

Les répertoires d’installation peuvent aussi être modiﬁés en conﬁgurant diﬀérentes variables d’environnement 2 avant de lancer l’installateur; consultez la documentation au moyen de `install-tl --help` (disponible en ligne à https://tug.org/texlive/doc/install-tl.html) pour la liste complète et plus de détails.

Une alternative raisonnable est d’installer TeX Live dans votre répertoire personnel, surtout si vous prévoyez d’en être le seul utilisateur. Vous pouvez utiliser `~` à cet eﬀet, par exemple `~/texlive/2024`.

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

Le répertoire TEXMFHOME est destiné à regrouper les répertoires de macros personnelles. Par défaut, son emplacement est `~/texmf` (`~/Library/texmf` isur Mac); ici, le `~` est préservé dans les ﬁchiers de conﬁguration créés, de façon à être remplacé dynamiquement pour chaque utilisateur de TeX, par la valeur des variables d’environnement $HOME sous Unix et `%USERPROFILE%` sous Windows. Attention, comme tous les autres répertoires, TEXMFHOME doit respecter la structure TDS, ce sans quoi les ﬁchiers ne seront pas trouvés.

Enﬁn, TEXMFVAR est l’emplacement où sont stockés les ﬁchiers de cache spéciﬁques à chaque utilisateur. Le nom TEXMFCACHE est utilisé par LuaLaTeX et ConTeXt MkIV pour le même but (voir la section 3.5.1 page 57); par défaut il coïncide avec TEXMFSYSVAR ou, s’il n’est pas possible d’y écrire, avec TEXMFVAR.

##### 3.2.4 Options

    Options customization:
    ===============================================================================
     <P> use letter size instead of A4 by default: [ ]
     <E> execution of restricted list of programs: [X]
     <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:
     <Y> after install, set CTAN as source for package updates: [X]

Figure 8: menu « Options » (Unix)

La ﬁgure 8 présente le menu « Options » en mode texte, sur lequel voici quelques précisions.

use letter size instead of A4 by default

  – la taille du papier par défaut pour des outils comme dvips, pdftex, xdvi. Cette option n’a pas d’inﬂuence sur les tailles par défaut utilisées par des jeux de macros, tels que les classes standard de LaTeX ou ses extensions : ces derniers resteront prioritaires. Dans tous les cas, il est possible (et recommandé) de préciser la taille de papier souhaitée au sein de chaque document.

execution of restricted list of programs

  – à compter de TeX Live 2010, l’exécution de certains programmes externes depuis TeX est autorisée par défaut. La (très courte) liste de programmes autorisés se trouve dans le ﬁchier texmf.cnf. Voir la section 10.1.7 pour plus de détails.

create all format ﬁles

  Nous recommandons de laisser cette option cochée, aﬁn d’éviter des problèmes inutiles lors de la création dynamique de formats. Consultez la documentation fmtutil pour plus de détails.

install font/macro . . . tree

  – ces options permettent d’installer les ﬁchiers de documentation et les ﬁchiers source présents dans la plupart des paquets. Décocher cette option n’est pas recommandé.

create symlinks in standard directories

  – cette option (pour Unix seulement) permet d’éviter d’avoir à modiﬁer les variables d’environnement PATH, MANPATH et INFOPATH après l’installation. Elle nécessite les droits d’écriture dans les répertoires cibles. Cette option est destinée à l’accès au système TeX depuis des répertoires standard tels que /usr/local/bin qui ne contiennent pas déjà de ﬁchiers TeX. Veillez à ne pas écraser de ﬁchiers existants sur votre système avec cette option, par exemple en spéciﬁant des répertoires système. L’approche la plus sûre et recommandée est de laisser cette option décochée.

  Note du traducteur.

    Le traducteur (Denis Bitouzé) est d’un avis opposé (mais controversé) et recommande au contraire cette option : elle simpliﬁe grandement l’installation puisqu’elle ne nécessite pas les conﬁgurations post-installation indiquées section 3.4.1. Cette méthode ne nécessite des précautions que dans les cas suivants.

    Ajout d’un exécutable :

      après que la TeX Live a été installée, elle peut être mise à jour, par exemple au moyen de :

      > tlmgr update --self --all
      Les éléments mis à jour sont la plupart du temps des packages et classes. Eux ne posent pas de problème mais il arrive aussi qu’un nouvel exécutable soit ajouté et, par défaut, celui-ci n’est pas directement accessible au système. Pour qu’il le soit, il est nécessaire de mettre à jour les liens symboliques et, pour ce faire, il suﬃt de lancer :
      > tlmgr path add
    Installations multiples :

      supposons par exemple que vous conserviez la TeX Live 2023 à côté de la TeX Live 2024 pour le cas où un document qui compilait avec la 1re ne compile plus avec la 2e. Pour basculer de la 2024 à 2023, il suﬃt de lancer 3 :

      > /usr/local/texlive/2023/bin/x86_64-linux/tlmgr path add
      puis, pour revenir à la TeX Live 2024 :
      > /usr/local/texlive/2024/bin/x86_64-linux/tlmgr path add
    Liens symboliques morts :

      à la suite de l’installation de multiples TeX Live, il se peut que certains liens symboliques morts se trouvent dans le dossier des binaires (typiquement /usr/local/bin). Pour les supprimer, il suﬃt de lancer :

      > find /usr/local/bin -xtype l -delete
after install, set CTAN as source for package updates

  – lors d’une installation depuis le DVD ou une image ISO, cette option est activée par défaut, car on souhaite généralement bénéﬁcier des mises à jour de paquets depuis la partie du CTAN les hébergeant, qui est mise à jour toute l’année. La seule raison probable de la désactiver est si vous installez seulement un sous-ensemble de TeX Live depuis le DVD et prévoyez de la compléter ultérieurement, toujours depuis le DVD. Dans tous les cas, le dépôt de paquets utilisé par l’installateur et celui utilisé après installation peuvent être choisis de façon indépendante; voir les sections 3.3.1 et 3.4.3.

Options spéciﬁques à Windows, telles qu’aﬃchées dans l’interface avancée Perl/Tk :

adjust PATH setting in registry

  – ceci assure que tous les programmes vont voir le répertoire contenant les binaires TeX Live dans leur chemin de recherche.

Add menu shortcuts

  – si coché, le menu « Démarrage » contiendra un sous-menu TeX Live. Il y a une 3e option « Entrée de lanceur » en plus de « Menu TeX Live » et « Pas de raccourcis ». Cette option est décrite section 4.1.

Change ﬁle associations

  – ces options sont « Seulement les nouveaux » (créant des associations de ﬁchier, mais n’en écrasant aucune), « Tous » et « Aucun ».

Install TeXworks front end

Lorsque vous êtes satisfait des réglages eﬀectués, il vous reste à taper I dans l’interface textuelle ou cliquer sur le bouton « Installer » dans l’interface graphique Perl/Tk pour lancer le processus d’installation. Lorsque celui-ci sera terminé, allez à la section 3.4 pour voir s’il y a d’autres choses à faire.

#### 3.3 Options de install-tl en ligne de commande

Tapez

> install-tl -help
pour obtenir la liste de toutes les options disponibles. Vous pouvez utiliser `-` ou `--` pour introduire le noms des options. Voici les plus courantes :

-gui

  : exécution en mode GUI si possible. Ceci nécessite Tcl/Tk version 8.5 ou plus. Il était distribué avec macOS; pour Big Sur et suivants, vous devrez installer Tcl/Tk vous-même, si vous ne si vous ne choisissez pas d’utiliser l’installateur MacTeX. Tcl/Tk est distribué avec TeX Live sous Windows. Les anciennes options -gui=perltk et -gui=wizard sont toujours disponibles et requièrent le module Perl/Tk (https://tug.org/texlive/distro.html#perltk) avec prise en charge de XFT; au cas où ni Tcl/Tk, ni Perl/Tk ne sont disponible, l’installation se poursuit en mode texte.

-no-gui

  : exécution en mode texte.

-lang LL

  : langue utilisée par l’interface de l’installateur, spéciﬁée par son code standard (généralement sur deux lettres). Le programme s’eﬀorce de déterminer automatiquement la langue à utiliser et se rabat sur l’anglais en cas d’échec. Vous pouvez obtenir la liste des langues disponibles avec install-tl --help.

-portable

  : créer une installation utilisable de façon portable sur une clé USB ou un DVD; peut aussi être activé depuis l’interface textuelle de l’installateur avec la commande V, ainsi que depuis l’interface graphique. Voir la section 5 pour les détails.

-profile ﬁchier

  : charger le proﬁl d’installation depuis le ﬁchier et installer sans interaction avec l’utilisateur. À chaque exécution, le script d’installation écrit un compte-rendu dans le ﬁchier texlive.profile du sous-répertoire tlpkg de votre installation TeX Live. Ce ﬁchier peut être donné en argument pour refaire exactement la même installation sur une machine diﬀérente, par exemple. Sinon, vous pouvez utiliser un proﬁl personnalisé; la façon la plus facile de le créer est de partir d’un proﬁl généré et de modiﬁer les valeurs, ou d’utiliser un ﬁchier vide pour utiliser toutes les valeurs par défaut.

-repository url-ou-répertoire

  : choix d’une source où récupérer le matériel à installer, voir ci-dessous.

-in-place

  : si vous possédez déjà une copie de TeX Live acquise par rsync, svn ou un autre moyen (voir https://tug.org/texlive/acquire-mirror.html), cette option vous permet de l’utiliser directement, tel quel, et de ne procéder qu’aux actions post-installation. Attention, ceci peut écraser le ﬁchier tlpkg/texlive.tlpdb, c’est à vous de le sauvegarder auparavant si vous le désirez. Aussi, une éventuelle suppression de paquet est à faire manuellement. N’utilisez pas cette option à moins de savoir ce que vous faites. Cette option ne peut pas être activée depuis l’interface de l’installateur.

##### 3.3.1 L’option -repository

L’emplacement par défaut du dépôt de paquets en ligne est un miroir du CTAN choisi automatiquement par le service de redirection https://mirror.ctan.org/.

Si vous voulez en utiliser un autre, vous pouvez utiliser l’option -repository avec pour valeur une URL commençant par ftp:, http:, https: ou file:/, ou un chemin vers un répertoire local. Dans le cas d’une URL en https:, http: ou ftp:, un éventuel caractère « / » à la ﬁn, de même qu’une éventuelle composante tlpkg/ ﬁnale, sont ignorés.

Par exemple, vous pouvez choisir un miroir du CTAN en particulier avec une valeur comme https://ctan.example.org/tex-archive/systems/texlive/tlnet/, en substituant le nom d’un vrai miroir et le chemin vers l’archive TeX spéciﬁque à la place de `ctan.example.org`. La liste des miroirs du CTAN est disponible sur https://ctan.org/mirrors.

Si l’argument donné est local (un chemin ou une URL en file:/) et que les paquets sont présents à la fois sous forme de ﬁchiers non compressés et d’archives compressées, ces dernières seront utilisées.

#### 3.4 Étapes post-installation

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

##### 3.4.1 Variables d’environnement sous Unix

Si vous avez choisi de créer des liens symboliques dans les répertoires standard (voir la section 3.2.4), alors il est inutile de modiﬁer vos variables d’environnement. Sinon, sur les systèmes Unix, le répertoire contenant les binaires pour votre plateforme doit être ajouté au PATH (pas sous Windows où l’installateur s’en occupe).

À chaque architecture correspond un sous-répertoire de TEXDIR/bin, voir la liste à la ﬁgure 5 38.

Si vous voulez que votre système trouve les ﬁchiers de documentation concernant TeX Live aux formats man et Info, il faut également ajuster les variables MANPATH et INFOPATH. Sur certains systèmes, ceci ne sera pas nécessaire et il suﬃra de régler le PATH pour que les pages de man et d’Info soient trouvées.

Pour les interpréteurs de commandes (shells) dits « Bourne-compatible » tels que bash sous GNU/Linux (et la conﬁguration du répertoire par défaut TeX Live à titre d’exemple), le ﬁchier à éditer peut être $HOME/.bash_profile (ou $HOME/.profile) et les lignes à ajouter sont de la forme suivante :

    PATH=/usr/local/texlive/2024/bin/x86_64-linux:$PATH; export PATH
    MANPATH=/usr/local/texlive/2024/texmf-dist/doc/man:$MANPATH; export MANPATH
    INFOPATH=/usr/local/texlive/2024/texmf-dist/doc/info:$INFOPATH; export INFOPATH

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

    setenv PATH /usr/local/texlive/2024/bin/x86_64-linux:$PATH
    setenv MANPATH /usr/local/texlive/2024/texmf-dist/doc/man:$MANPATH
    setenv INFOPATH /usr/local/texlive/2024/texmf-dist/doc/info:$INFOPATH

Si vous n’êtes pas sur une plateforme x86_64-linux, utilisez le nom de plateforme approprié; de même, si vous n’avez pas eﬀectué l’installation dans le répertoire par défaut, modiﬁez le nom du répertoire. Le programme d’installation TeX Live indique les lignes complètes à utiliser à la ﬁn de l’installation.

Si vous avez déjà des paramètres PATH quelque part dans vos ﬁchiers de démarrage, fusionnez les répertoires TeX Live comme vous le souhaitez.

##### 3.4.2 Variables d’environnement : conﬁguration 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 ﬁchiers personnels de chacun, mais les façons de le faire sont trop diﬀérentes d’un système à l’autre pour être présentées ici.

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

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

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

Nous créons aussi à l’installation un lien symbolique nommé man dans les répertoires des binaires Unix. Certains programmes man, comme celui livré en standard sur macOS, l’utilisent pour trouver automatiquement les pages de man, rendant inutile tout réglage de MANPATH.

##### 3.4.3 Mises à jour par Internet après une installation par le DVD

Si vous avez installé TeX Live depuis le DVD et souhaitez ensuite accéder aux mises à jour par Internet, il vous faudra exécuter la commande suivante (après avoir réglé votre PATH si nécessaire, comme expliqué à la section précédente) :

> tlmgr option repository https://mirror.ctan.org/systems/texlive/tlnet

Ceci dit à tlmgr d’utiliser pour les futures mises à jour un miroir du CTAN proche. Ceci est fait par défaut lors d’une installation depuis le DVD, via l’option décrite dans la section 3.2.4.

Si vous rencontrez des problèmes avec la sélection automatique du miroir, vous pouvez en sélectionner un en particulier depuis la liste disponible en https://ctan.org/mirrors. Utilisez le chemin complet vers le répertoire tlnet pour ce miroir, comme ci-dessus.

#### 3.5 Conﬁguration des fontes pour XeTeX et LuaTeX

XeTeX et LuaTeX peuvent utiliser n’importe quelle police installée sur le système, et pas seulement celles des arborescences TeX. Ces polices système (qui ne font pas partie de TeX Live) sont généralement accessibles en donnant le nom de la police, par exemple ‘Liberation Serif’, bien que le nom de ﬁchier système puisse être également utilisé.

Une question connexe consiste à rendre les polices de la distribution TeX Live disponibles en tant que polices système, ce qui les rendra à leur tour accessibles par leur nom.

Pour LuaTeX :

  pour l’accès par nom de police, il n’y a rien de spécial à faire. Toutes les polices de la distribution TeX Live devraient être également accessibles par nom de police ou par nom de ﬁchier pour LuaTeX, via le paquet luaotﬂoad qui prend en charge à la fois LaTeX et plain TeX. L’index des noms de police luaotﬂoad peut avoir besoin d’être reconstruit pour les nouvelles polices; ceci est déclenché automatiquement lors de la tentative de chargement d’une police qui n’est pas encore connue.

Pour XeTeX :

  sous :

  Windows :

    les polices livrées avec TeX Live sont automatiquement mises à disposition (en exécutant le programme fc-cache fourni pour Windows par la TeX Live);

  macOS :

    vous devrez consulter d’autres documents;

  systèmes Unix autres que macOS :

    la procédure est la suivante : lorsque le paquetage xetex est installé (lors de l’installation initiale ou ultérieurement), le ﬁchier de conﬁguration nécessaire est créé dans TEXMFSYSVAR/fonts/conf/texlive-fontconfig.conf. Pour rendre les polices TeX Live disponibles en tant que polices système :

    1. Copiez le ﬁchier texlive-fontconfig.conf dans (généralement) /etc/fonts/conf.d/09-texlive.conf.

    2. Exécutez fc-cache -fsv.

    Si vous n’avez pas les privilèges suﬃsants pour utiliser la méthode ci-dessus, ou si vous préférez rendre les polices disponibles seulement pour l’utilisateur en cours, vous pouvez procéder comme suit :

    1. copiez dans (généralement) ~/.fonts.conf.d/09-texlive.conf le ﬁchier texlive-fontconfig.conf, où ~ représente votre répertoire personnel.

    2. exécutez fc-cache -fv.

Vous pouvez exécuter fc-list pour aﬃcher les noms des polices système disponibles. L’incantation fc-list : family style file spacing (tous ces arguments sont des chaînes littérales) aﬃche des informations généralement intéressantes.

##### 3.5.1 ConTeXt LMTX et MkIV

L’ancien ConTeXt (Mark IV ou MkIV) et le nouveau ConTeXt (LMTX ou MkXL) devraient fonctionner sans problème après l’installation de TeX Live, et ne devraient pas nécessiter d’attention particulière tant que vous utilisez `tlmgr` pour les mises à jour.

ConTeXt n’utilise pas la bibliothèque Kpathsea ou les ﬁchiers système ls-R; à la place, ConTeXt maintient une base de données de noms de ﬁchiers par utilisateur pour tous les arbres connus. L’exécution de mktexlsr ne mettra pas à jour ces bases de données directement, mais ConTeXt les reconstruira automatiquement lors de sa prochaine exécution. (Les ﬁchiers spéciﬁques à TeX Live cont-sys.mkiv et cont-sys.mkxl implémentent cela.)

Si vous souhaitez reconstruire manuellement ces bases de données, exécutez l’une ou l’autre ou les deux commandes suivantes :

    mtxrun --generate          # LMTX
    mtxrun --luatex --generate # MkIV

Les ﬁchiers résultants sont stockés sous TEXMFCACHE, dont la valeur par défaut dans TeX Live est `TEXMFSYSVAR;TEXMFVAR`.

ConTeXt lira tous les chemins mentionnés dans `TEXMFCACHE`, et écrira dans le premier chemin accessible en écriture. Lors de la lecture, la dernière correspondance trouvée sera prioritaire en cas de duplication des données du cache.

Pour plus d’informations, voir :

- https://wiki.contextgarden.net/LMTX;

- https://wiki.contextgarden.net/Running_Mark_IV.

##### 3.5.2 Ajout de ﬁchiers locaux ou personnels

Comme cela a déjà été indiqué à la section 2.3, TEXMFLOCAL (par défaut /usr/local/texlive/texmf-local ou `%SystemDrive%\texlive\texmf-local` sous Windows) est la racine de l’arborescence prévue pour regrouper les ﬁchiers 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 ﬁchiers 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 https://tug.org/tds ou lire le ﬁchier 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.

Enﬁn, 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, en mode graphique, bouton « Mettre à jour l’index de ﬁchiers » dans l’onglet « Actions ») de l’interface graphique du TeX Live « Manager ».

L’emplacement des répertoires TEXMFLOCAL et TEXMFHOME est ﬁxe (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.

Par défaut, chacune de ces variables est déﬁnie comme étant un seul répertoire, comme illustré ci-dessus. Cependant, ceci n’est pas obligatoire. Si vous voulez par exemple changer rapidement de version pour des paquets importants, vous pouvez maintenir plusieurs arborescences pour votre usage personnel en spéciﬁant dans TEXMFHOME une liste de répertoires entre accolades, séparés par des virgules :

      TEXMFHOME = {/my/dir1,/mydir2,/a/third/dir}

La section 8.1.5 décrit plus en détail la façon dont de telles listes entre accolades sont traitées.

##### 3.5.3 Ajout de fontes externes à TeX Live

Ce sujet est malheureusement assez délicat en ce qui concerne TeX et pdfTeX donc ne vous y attardez pas à moins que vous souhaitiez vous plonger dans les arcanes d’une installation TeX.

De nombreuses polices étant déjà intégrées à TeX Live, nous vous conseillons de vériﬁer en premier lieu si ce que vous cherchez ne s’y trouve pas : les pages de https://tug.org/FontCatalogue listent, classées de diﬀérentes façons, la quasi-totalité des polices de texte incluses dans les principales distributions TeX.

Si vous voulez toutefois installer vos propres polices, vous pouvez consulter le document :

https://tug.org/fonts/fontinstall.html

qui essaie de décrire au mieux la procédure pour ce faire.

Une alternative possible est d’utiliser XeTeX ou LuaTeX (voir section 2.4) qui permettent l’accès aux fontes disponibles sur le système sans aucune installation supplémentaire. (Mais prenez garde au fait que l’utilisation de polices système rend vos sources instantanément inutilisables par toute personne travaillant dans un environnement diﬀérent.)

#### 3.6 Test de l’installation

Après avoir installé TeX Live aussi bien que possible, 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).

Une chose que vous devez immédiatement chercher est une interface graphique (un éditeur) avec laquelle éditer des ﬁchiers. TeX Live installe TeXworks ( https://tug.org/texworks) sur Windows (seulement) et MacTeX installe TeXShop ( https://pages.uoregon.edu/koch/texshop). Sur les autres systèmes Unix, le choix d’un éditeur vous revient. Il y en a de nombreux et certains d’entre eux sont listés à la section suivante (cf. aussi https://tug.org/interest.html#editors). Tout éditeur de texte brut convient : il n’est pas requis qu’il soit spéciﬁque à TeX.

Le reste de cette section donne quelques procédures de base pour vériﬁer que le nouveau système est opérationnel. On les décrit pour Unix; pour macOS 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.14159265 (TeX Live ...)
   Copyright ... D.E. Knuth.
   ...

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

2. Traiter un ﬁchier LaTeX simple :

   > pdflatex sample2e.tex
   This is pdfTeX 3.14...
   ...
   Output written on sample2e.pdf (3 pages, 142120 bytes).
   Transcript written on sample2e.log.
   Si le ﬁchier sample2e.tex ou d’autres ne sont pas trouvés, il est possible qu’il y ait des interférences avec vos anciennes variables d’environnement ou ﬁchiers de conﬁguration. 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 101.

3. Prévisualiser le ﬁchier PDF, par exemple au moyen de :

   > xpdf sample2e.pdf
   Vous devriez voir une nouvelle fenêtre avec un joli document expliquant certaines des bases de LaTeX. (Au fait, ça vaut la peine de lire si vous êtes nouveau à TeX.)

   Bien sûr, il existe de nombreux autres lecteurs de PDF; sur les systèmes Unix, evince et okular sont couramment utilisés. Pour Windows, nous recommandons d’essayer le lecteur Sumatra PDF (https://www.sumatrapdfreader.org/free-pdf-reader.html). Aucun aﬃcheur PDF n’est inclus dans TeX Live et vous devez donc installer séparément celui que vous voulez utiliser.

4. Bien sûr, vous pouvez toujours générer le format originel DVI de TeX :

   > latex sample2e.tex

5. Prévisualiser les résultats :

   > xdvi sample2e.dvi # Unix
   > dviout sample2e.dvi # Windows
   Nota : vous devez travailler sous X pour que xdvi fonctionne. Dans le cas contraire, votre variable d’environnement DISPLAY ne sera pas correcte et vous obtiendrez l’erreur « Can’t open display ».

6. Créer un ﬁchier PostScript à partir du DVI :

   > dvips sample2e.dvi -o sample2e.ps

7. Ou pour créer un ﬁchier PDF à partir du DVI, une méthode alternative à l’utilisation pdfTeX (ou XeTeX ou LuaTeX) qui peut parfois être utile :

   > dvipdfmx sample2e.dvi -o sample2e.pdf

8. Autres ﬁchiers 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 ﬁchier de test de (plain)TeX le plus canonique de tous. Il faut taper « \bye » à l’invite * après « tex story.tex ».

9. Si vous avez installé le paquet xetex, vous pouvez vériﬁer s’il a bien accès aux polices du système ainsi :

   > xetex opentype-info.tex
   This is XeTeX, Version 3.14...
   ...
   Output written on opentype-info.pdf (1 page).
   Transcript written on opentype-info.log.

   En cas de message d’erreur contenant « Invalid fontname ‘Latin Modern Roman/ICU’... », alors vous devez revoir la conﬁguration de votre système pour que les polices installées par TeX Live soient reconnues, voir section 3.5.

#### 3.7 Désinstaller la TeX Live

Pour désinstaller TeX Live (après une installation réussie; pour Windows, voir ci-dessous) :

> tlmgr uninstall --all

Une conﬁrmation vous sera demandée, sinon rien ne sera fait. (Sans --all, l’action uninstall est utilisée pour supprimer les packages individuellement).

Ceci ne supprime pas les répertoires spéciﬁques à l’utilisateur, à savoir (voir aussi section 2.3) :

TEXMFCONFIG

  Ceci est destiné aux changements de conﬁguration de l’utilisateur. Si vous souhaitez les conserver, assurez-vous de savoir comment les recréer avant de les supprimer.

TEXMFVAR

  Ceci est destiné à stocker les données d’exécution générées automatiquement, telles que les ﬁchiers de format local. À moins que vous ne l’ayez utilisé à d’autres ﬁns, vous pouvez le supprimer en toute sécurité.

TEXMFHOME

  Contient uniquement les ﬁchiers que vous avez vous-même installés, généralement ceux qui ne sont pas disponibles dans les distributions. À moins que vous n’arrêtiez complètement d’utiliser TeX, ou que vous souhaitiez repartir de zéro, vous n’avez probablement pas envie de supprimer cet élément.

Vous pouvez trouver les chemins de répertoire de ces variables en exécutant kpsewhich -var-value=var.

Cette désinstallation de tlmgr n’annule pas non plus les actions post-installation, telles que les modiﬁcations de PATH dans les ﬁchiers d’initialisation de votre shell et l’accès du système aux polices de TeX Live (voir la section 3.4). Vous devez annuler manuellement ces actions, si vous le souhaitez.

Sous Windows, la désinstallation peut être eﬀectuée via l’interface utilisateur graphique (GUI); voir la section 7.1.

#### 3.8 Liens vers d’autres logiciels téléchargeables

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 https://tug.org/begin.html.

Voici quelques liens vers d’autres outils qui peuvent être utiles à installer.

Ghostscript

  https://ghostscript.com/, un interpréteur PostScript et PDF gratuit.

Perl

  https://perl.org/ avec des paquets supplémentaires du CPAN, https://cpan.org/

ImageMagick

  https://imagemagick.com pour les conversions entre formats graphiques, notamment.

NetPBM

  http://netpbm.sourceforge.net/ également pour les graphiques.

Éditeurs orientés TeX

  Le choix est large, et est en bonne partie une question de goût personnel. Voici une sélection classée par ordre alphabétique (dont certains ne sont disponibles que sous Windows).

  - GNU Emacs est disponible pour toutes les principales plateformes; voir https://www.gnu.org/software/emacs.

  - AUCTeX fonctionne sous Emacs; il est disponible par le biais du gestionnaire de paquets ELPA d’Emacs. Les sources sont également disponibles sur le CTAN. La page d’accueil de AUCTeX est https://www.gnu.org/software/auctex.

  - SciTE (Windows seulement) est disponible sur https://www.scintilla.org/SciTE.html.

  - Texmaker est disponible sur https://www.xm1math.net/texmaker/index_fr.html .

  - TeXstudio était au départ un fork de Texmaker avec des fonctionnalités supplémentaires : https://texstudio.org/.

  - TeXnicCenter est disponible sur https://www.texniccenter.org.

  - TeXworks est disponible sur https://tug.org/texworks et inclus dans TeX Live sur Windows (seulement).

  - Vim est disponible sur https://www.vim.org.

  - WinEdt (Windows seulement, non libre) est disponible sur https://tug.org/winedt or https://www.winedt.com.

  - WinShell (Windows seulement) est disponible sur https://www.winshell.de.

Voir https://tug.org/interest.html pour une liste plus complète de programmes.

### 4 Installations spécialisées

Les sections précédentes décrivaient le processus pour installation « normale ». Celle-ci concerne des cas plus spécialisés.

#### 4.1 Installation partagée entre plusieurs utilisateurs ou machines

TeX Live a été conçue pour pouvoir être partagée par diﬀérents systèmes sur un réseau. Avec la disposition standard des répertoires, aucun chemin n’est codé en dur : les emplacements des ﬁchiers dont TeX Live a besoin sont trouvés automatiquement à partir des emplacements des programmes. Vous pouvez le constater dans le ﬁchier de conﬁguration principal $TEXMFDIST/web2c/texmf.cnf, qui contient des lignes comme

    TEXMFROOT = $SELFAUTOPARENT
    ...
    TEXMFDIST = $TEXMFROOT/texmf-dist
    ...
    TEXMFLOCAL = $SELFAUTOGRANDPARENT/texmf-local

Cela signiﬁe qu’il suﬃt aux utilisateurs d’ajouter à leur PATH le chemin des exécutables pour leurs plateformes, pour obtenir une conﬁguration qui marche.

Pour la même raison, vous pouvez aussi installer TeX Live localement et ensuite déplacer l’arborescence complète vers un emplacement réseau.

Pour Windows, TeX Live inclut un programme de lancement nommé tlaunch. Sa fenêtre principale contient des entrées de menus et des boutons pour diﬀérents programmes et documentations liés à TeX personnalisables via un ﬁchier ini. Lors de son premier usage, il reproduit la post-installation usuelle sous Windows, c’est-à-dire qu’il modiﬁe le chemin de recherche pour la TeX Live et crée quelques associations de ﬁchiers, mais seulement pour l’utilisateur en cours. De ce fait, les stations de travail ayant accès à la TeX Live sur un réseau local ne nécessitent qu’un raccourci de menu pour le lanceur. Cf. le manuel de tlaunch (texdoc tlaunch ou https://ctan.org/pkg/tlaunch).

### 5 Installations « portables » de TeX Live

L’option -portable de l’installateur (ou la commande V dans l’installateur en mode texte ou l’option correspondante en mode graphique) crée une installation de TeX Live entièrement contenue dans un seul répertoire et n’eﬀectue aucune intégration au système. Vous pouvez créer une telle installation directement sur une clé USB ou la copier sur une clé ultérieurement.

Techniquement, l’installation portable est rendue autonome en rendant les valeurs par défaut de TEXMFHOME, TEXMFVAR, et TEXMFCONFIG respectivement identiques à TEXMFLOCAL, TEXMFSYSVAR, et TEXMFSYSCONFIG; la conﬁguration par utilisateur et les caches ne seront donc pas créés.

Pour utiliser TeX depuis cette installation portable, il suﬃt d’ajouter le bon répertoire de binaires à votre path pour la session de terminal en cours, comme d’habitude.

Sous Windows, vous pouvez double-cliquer sur le ﬁchier tl-tray-menu à la racine de l’installation et créer un « menu receveur » temporaire oﬀrant quelques actions communes, comme dans cette capture d’écran :

L’entrée « More... » explique comment personnaliser ce menu.

### 6 Maintenance de l’installation avec tlmgr

Figure 9: GUI tlshell, montrant le menu Actions (GNU/Linux)

Figure 10: GUI tlcockpit pour tlmgr

Figure 11: Ancien mode GUI pour tlmgr : fenêtre principale, après « Chargement »

TeX Live fournit un programme appelé tlmgr pour assurer la maintenance de la distribution après son installation initiale. Il permet en particulier

- d’installer, de mettre à jour ou de désinstaller des paquets individuellement, éventuellement en respectant les dépendances;

- de rechercher des paquets, d’obtenir leur liste et leurs descriptions, etc.;

- de voir la liste des plateformes binaires et d’en installer ou d’en supprimer;

- de modiﬁer la conﬁguration, par exemple la taille du papier par défaut, le dépôt de paquets par défaut (voir la section 3.3.1).

Les fonctionnalités de tlmgr surpassent celles de texconﬁg. Nous continuons à distribuer et maintenir ce dernier pour le confort de ceux habitués à son interface, mais nous recommandons d’utiliser tlmgr désormais.

#### 6.1 GUI actuelles pour le tlmgr

TeX Live fournit plusieurs GUI pour tlmgr. Deux notables d’entre elles sont :

1. tlshell (ﬁgure 9) qui est écrit en Tcl/Tk et fonctionne d’emblée sous Windows;

2. tlcockpit (ﬁgure 10) qui nécessite Java version 8 ou supérieure et JavaFX.

Les deux sont des paquets séparés.

tlmgr dispose lui-même d’une GUI native (ﬁgure 11) qui peut être lancée au moyen de :

> tlmgr -gui
Cependant, cette extension GUI requiert Perl/Tk, dont le module n’est plus fourni par la distribution Perl de TeX Live pour Windows.

#### 6.2 Exemples d’utilisation de tlmgr en ligne de commande

Après l’installation initiale, vous pouvez mettre à jour votre système en utilisant :

> tlmgr update -all
Si cela vous inquiète, vous pouvez commencer par :
> tlmgr update -all -dry-run
ou (moins bavard) :
> tlmgr update -list

L’exemple suivant, plus complexe, ajoute une collection, pour le moteur XeTeX, depuis un dépôt local :

> tlmgr -repository /local/mirror/tlnet install collection-xetex
La sortie, abrégée, ressemble à ceci :

    install: collection-xetex
    install: arabxetex
    ...
    install: xetex
    install: xetexconfig
    install: xetex.i386-linux
    running post install action for xetex
    install: xetex-def
    ...
    running mktexlsry
    mktexlsr: Updating /usr/local/texlive/2024/texmf-dist/ls-R...
    ...
    running fmtutil-sys --missing
    ...
    Transcript written on xelatex.log.
    fmtutil: /usr/local/texlive/2024/texmf-var/web2c/xetex/xelatex.fmt installed.

Comme vous pouvez le constater, tlmgr prend en compte les dépendances et eﬀectue automatiquement toutes les opérations nécessaires, comme la mise à jour des bases de données de ﬁchiers et la génération de formats (ici un nouveau format a été créé pour XeTeX).

La commande suivante permet d’obtenir la description d’un paquet.

> tlmgr show collection-latexextra
Elle retourne par exemple quelque chose comme :

    package:    collection-latexextra
    category:   Collection
    shortdesc:  LaTeX supplementary packages
    longdesc:   A very large collection of add-on packages for LaTeX.
    installed:  Yes
    revision:   46963
    sizes:            657941k

Enﬁn, le plus important, pour la documentation complète, tapez tout simplement :

> tlmgr help
ou consultez l’adresse suivante :

https://tug.org/texlive/tlmgr.html

### 7 Notes concernant Windows

#### 7.1 Fonctionnalités supplémentaires à l’installation

Sous Windows le programme d’installation eﬀectue 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 quelques programmes graphiques, tels que tlshell (une GUI pour tlmgr) et dviout, et quelques entrées pour la documentation.

Associations de ﬁchiers

  – si cette option n’est pas désactivée, TeXworks et Dviout deviennent le programme par défaut pour ouvrir leurs types de ﬁchiers respectifs ou, s’il y a déjà un tel programme, sont ajoutés à la liste « Ouvrir avec... » du menu contextuel. Cependant, les associations de ﬁchiers plus prioritaires « choisies par l’utilisateur », qui ne peuvent être spéciﬁées que de manière interactive, peuvent prendre le dessus.

Convertisseur bitmap vers eps

  – une entrée bitmap2eps est ajoutée à l’entrée « Ouvrir avec... » du menu contextuel pour de nombreux formats d’images bitmap. Bitmap2eps est un script simple qui utilise sam2p ou bmeps pour faire le vrai travail.

Prise en charge PostScript

  – pour les ﬁchiers PostScript, un type de ﬁchier PSviewer convertit désormais PostScript en un PDF temporaire, qui est ensuite aﬃché par le visualiseur PDF par défaut. Pour la conversion en EPS, une entrée bitmap2eps est ajoutée à l’entrée « Ouvrir avec... » du menu contextuel pour de nombreux formats d’images bitmap, laissant sam2p ou bmeps faire le vrai travail.

Ajustement automatique du path

  – aucune intervention manuelle n’est nécessaire.

Désinstallation

  – une entrée est ajoutée pour TeX Live, soit dans le menu « Ajout et suppression de programmes » (pour une installation en tant qu’administrateur), soit dans le menu TeX Live (pour une installation mono-utilisateur)

Protection en écriture

  – Pour une installation en tant qu’administrateur, les répertoires de la TeX Live sont protégés en écriture, au moins si la TeX Live est installée sur un disque normal formaté en NTFS et non amovible.

Pour une autre approche, cf. tlaunch, décrit à la section 4.1.

#### 7.2 Programmes supplémentaires

Pour être complète, une installation TeX Live a besoin de quelques utilitaires qui ne sont pas présents en général sur les machines Windows. TeX Live fournit donc les outils suivants (installés sur Windows seulement).

Perl, Tcl/Tk et Ghostscript

  – en raison de l’importance de Perl et de Ghostscript, et parce que l’installateur et les GUI de tlshell sont écrits en Tcl/Tk, TeX Live inclut des copies ‘cachées’ de ces programmes. Les programmes TeX Live qui en ont besoin savent où les trouver, mais ils ne trahissent pas leur présence par des variables d’environnement ou des paramètres de registre. Il ne s’agit pas d’installations complètes (sauf pour Ghostscript), et elles ne devraient pas interférer avec les installations système de Perl, Tcl/Tk ou Ghostscript. Voir la sous-section 7.3 pour savoir comment indiquer à TeX Live que vous souhaitez utiliser vos propres installations externes pour les scripts contribués dans TeX Live.

dviout

  – lecteur de DVI. La première fois que vous visualisez un ﬁchier avec dviout, il va créer des polices, car les versions des fontes pour écran ne sont pas installées. Au bout d’un moment, la plupart des polices que vous utilisez auront été créées, et vous ne verrez plus que rarement la fenêtre de création des fontes. Vous pouvez trouver plus d’informations dans le menu d’aide du logiciel (dont la lecture est recommandée).

TeXworks

  – TeXworks est un éditeur conçu pour les ﬁchiers TeX, avec un lecteur de PDF intégré.

Outils en ligne de commande

  – des versions pour Windows de programmes Unix sont installées, en particulier gzip, zip, unzip, jpeg2ps, chktex, wget et quelques utilitaires de la suite poppler (comme pdﬁnfo ou pdﬀonts); aucun aﬃcheur PDF autonome pour Windows n’est inclus. Une option est l’aﬃcheur Sumatra PDF disponible à https://www.sumatrapdfreader.org/.

fc-list, fc-cache, etc.

  – outils de la bibliothèque fontconﬁg permettant à XeTeX d’accéder aux polices système sous Windows. Vous pouvez utiliser fc-list pour connaître la liste des noms de police utilisables avec la commande \font de XeTeX.

#### 7.3 Utilisation d’installations externes de Perl, Tcl/Tk et Ghostscript

Normalement, TeX Live utilise ses installations intégrées Perl, Tcl/Tk et Ghostscript également pour les scripts contribués dans TeX Live. Si vous souhaitez utiliser vos propres versions externes, vous pouvez le conﬁgurer dans le ﬁchier texmf.cnf à la racine de l’installation.

Pour Perl, vous devez ajouter une ligne

    TEXLIVE_WINDOWS_TRY_EXTERNAL_PERL = 1

TeX Live (plus précisément, bin/windows/runscript.tlu) recherchera alors perl.exe sur le chemin de recherche, sauf pour les scripts qui appartiennent à l’infrastructure TeX Live. Il s’agit du paramètre le plus susceptible d’être utile; bien que l’infrastructure TeX Live Perl inclut de nombreux modules supplémentaires, il ne peut pas prendre en charge tous les scripts tiers.

De même, pour Tcl/Tk, vous avez besoin d’une ligne

    TEXLIVE_WINDOWS_TRY_EXTERNAL_TCL = 1

TeX Live recherchera alors les ﬁchiers tclkit.exe, wish.exe, wish85.exe, wish86.exe et wish87.exe sur le chemin de recherche.

Ghostscript est traité diﬀéremment, dans la mesure où vous devez spéciﬁer le nom de ﬁchier ou le chemin complet de votre Ghostscript en ligne de commande :

TEXLIVE_WINDOWS_EXTERNAL_GS = chemin de la ligne de commande ghostscript
Une autre diﬀérence est que le Ghostscript fourni avec TeX Live est complet, seuls la documentation et les pilotes d’imprimante étant omis. Il est donc peu probable que vous ayez besoin de le remplacer.

Voir également la section 8.1.2 à propos du ﬁchier texmf.cnf.

#### 7.4 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:\Utilisateurs\<username>` sous Vista et versions suivantes. 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.5 Base de registre Windows

Windows stocke pratiquement tous les paramètres de conﬁguration dans sa base de registre. 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 registre se trouve dans le répertoire personnel de l’utilisateur (voir section 7.4). 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 modiﬁcation des variables d’environnement nécessite l’accès à la base de registre.

#### 7.6 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. Nous nous sommes eﬀorcés de rendre l’installation de TeX Live possible aux utilisateurs non privilégiés.

Si l’installateur est lancé avec des droits « administrateur », il dispose d’une option procédant à l’installation pour tous les utilisateurs : si elle est choisie, les raccourcis et les entrées de menu sont créés pour tous les utilisateurs, et le chemin de recherche est modiﬁé au niveau du système. Sinon, les raccourcis et entrées de menu sont créés pour l’utilisateur courant, et seul le chemin de recherche dudit utilisateur est modiﬁé.

Dans tous les cas, le répertoire proposé comme racine de l’installation est `%SystemDrive%`. Le programme install-tl vériﬁe 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’eﬀectue d’abord dans les répertoires système, puis dans les répertoires de l’utilisateur. Une parade sommaire a été prévue : l’installateur crée un raccourci vers une fenêtre de ligne de commande où les exécutables TeX Live sont prioritaires : TeX Live est ainsi utilisable en ligne de commande à partir de ce raccourci. De même, le raccourci pour TeXworks, s’il est installé, fait ce qu’il faut pour que les outils TeX Live soient utilisés.

Vous devez savoir que, même si vous êtes connecté en tant qu’administrateur, vous devez explicitement demander les privilèges d’administrateur. En fait, il ne sert pas à grand-chose de se connecter en tant qu’administrateur; le mieux est de faire un clic droit sur le programme ou raccourci à utiliser, et de choisir l’entrée « exécuter en tant qu’administrateur ».

#### 7.7 Augmentation de la limite de mémoire sous Windows et Cygwin

Les utilisateurs de Windows et Cygwin (voir la section 3.1.4 pour les spéciﬁcités de l’installation sous Cygwin) peuvent parfois arriver à court de mémoire en utilisant certains des programmes fournis avec TeX Live. Par exemple, asy peut manquer de mémoire si vous essayez d’allouer un tableau de 25 000 000 réels, et LuaTeX aussi si vous essayez de traiter un document avec beaucoup de fontes lourdes.

Pour Cygwin, vous pouvez augmenter la quantité de mémoire disponible en suivant les instructions données dans le guide de l’utilisateur Cygwin ( https://www.cygwin.com/cygwin-ug-net/setup-maxmem.html).

Pour Windows, il vous faudra créer un ﬁchier, nommé par exemple ajoutmemoire.ref, contenant les quatre lignes suivantes.

    Windows Registry Editor Version 5.00

    [HKEY_LOCAL_MACHINE\Software\Cygwin]
    "heap_chunk_in_mb"=dword:ffffff00

puis exécuter la commande regedit /s ajoutmemoire.reg en tant qu’administrateur. Si vous souhaitez modiﬁer la limite mémoire uniquement pour l’utilisateur courant plutôt qu’au niveau du système, utilisez HKEY_CURRENT_USER.

### 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 https://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 ﬁles 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, sur macOS 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

  – gestion des bibliographies.

dvicopy

  – copie de ﬁchier DVI en supprimant les fontes virtuelles.

dvitomp

  – conversion de ﬁchier DVI en MPX (dessins MetaPost).

dvitype

  – conversion le ﬁchier DVI en un texte lisible.

gftodvi

  – visualisation de fontes génériques GF.

gftopk

  – conversion des fontes génériques GF en fontes bitmap PK.

gftype

  – conversion de ﬁchier GF en un texte lisible.

mf

  – création de fontes.

mft

  – mise en page de code source Metafont.

mpost

  – création de diagrammes techniques.

patgen

  – création de motifs de césure.

pktogf

  – conversion des fontes bitmap PK en fontes génériques GF.

pktype

  – conversion des fontes PK en un texte lisible.

pltotf

  – conversion des ﬁchiers PL (lisibles) en TFM.

pooltype

  – aﬃchage des ﬁchiers WEB pool.

tangle

  – WEB vers Pascal.

tex

  – composition de textes.

tftopl

  – conversion des ﬁchiers TFM en PL (lisibles).

vftovp

  – conversion des fontes virtuelles VF en VPL (lisibles).

vptovf

  – conversion des 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;

--version

  imprime seulement le numéro de version.

Et la plupart honorent :

--verbose

  imprime le rapport détaillé du processus.

Pour localiser les ﬁchiers, les programmes Web2C utilisent la bibliothèque de recherche Kpathsea (https://tug.org/kpathsea). Cette bibliothèque utilise une combinaison de variables d’environnement et un certain nombre de ﬁchiers 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. Aﬁn d’accélérer la recherche de ﬁchiers, la racine de chaque arborescence possède un ﬁchier ls-R contenant une entrée donnant le nom et le chemin de chaque ﬁchier situé sous la racine.

#### 8.1 Kpathsea et la recherche de ﬁchiers

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

Nous appelons chemin de recherche une liste d’éléments, séparés par « deux-points » ou « point-virgule », et 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 ﬁchier « my-file » le long d’un chemin « .:/dir », Kpathsea vériﬁe chaque élément du chemin : d’abord ./my-file, puis /dir/my-file, etc. Puis Kpathsea renvoie la première occurrence (voire toutes).

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

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

Bien que l’élément de chemin le plus simple et le plus fréquent soit un nom de répertoire, Kpathsea prend en charge d’autres types d’éléments dans les chemins de recherche : des valeurs par défaut diﬀérentes pour chaque programme, des noms de variables d’environnement, des valeurs de ﬁchiers de conﬁguration, 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éciﬁcations en noms de répertoires de base. Cette opération est décrite dans les sections suivantes.

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

##### 8.1.1 Les diﬀé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éﬁnie 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 ﬁchier de conﬁguration de programme spéciﬁque, par exemple une ligne « S /a:/b » dans le ﬁchier config.ps de dvips.

3. Un ﬁchier de conﬁguration 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 101).

##### 8.1.2 Fichiers de conﬁguration

Kpathsea lit les chemins de recherche et d’autres déﬁnitions dans des ﬁchiers de conﬁguration à l’exécution nommés texmf.cnf. Le chemin TEXMFCNF est utilisé pour rechercher ces ﬁchiers, mais nous ne recommandons pas de déﬁnir cette variable d’environnement (ou toute autre) pour passer outre les répertoires du système.

À la place, un ﬁchier .../2024/texmf.cnf est créé à la suite d’une installation normale. Si vous devez changer les valeurs par défaut de certaines variables (ce qui n’est en général pas nécessaire), c’est le bon endroit pour le faire. Le ﬁchier de conﬁguration principal est dans .../2024/texmf-dist/web2c/texmf.cnf. Vous ne devriez jamais éditer ce ﬁchier car vos changements seraient alors perdus lors de futures mises à jour de la distribution.

En passant, si vous souhaitez simplement ajouter un répertoire personnel à un chemin de recherche particulier, une méthode raisonnable consiste à déﬁnir une variable d’environnement :

      TEXINPUTS=.:/my/macro/dir:

Pour que cette conﬁguration puisse être maintenue et portable au ﬁl des ans, utilisez un « : » ﬁnal (« ; » sur Windows) pour insérer les chemins d’accès système, au lieu d’essayer de les écrire tous explicitement (voir section 8.1.4). Une autre option consiste à utiliser l’arborescence TEXMFHOME (voir section 3.2.3).

Il est important de noter que tous les ﬁchiers texmf.cnf trouvés seront lus et que, en cas de conﬂit, la première déﬁnition lue l’emporte. Par exemple, si les ﬁchiers texmf.cnf sont cherchés dans le chemin `.:$TEXMF`, les valeurs de ./texmf.cnf l’emportent sur celles de `$TEXMF/texmf.cnf`.

- Les commentaires sont signalés par un %, soit au début d’une ligne, soit précédés d’un espace, et se terminent à la ﬁn de la ligne.

- Les lignes vides sont ignorées.

- Un \ à la ﬁn d’une ligne joue le rôle d’un lien entre deux lignes, c’est-à-dire que la ligne courante se poursuit à la ligne suivante. Dans ce cas, les espaces présents au début de la ligne suivante ne sont pas ignorés.

- Toutes les autres lignes sont de la forme :
  variable [.progname] [=] value
  où le « = » et les espaces autour sont optionnels. (Mais si valeur commence par « . », il est plus simple d’utiliser le « = » pour éviter que le point ne soit interprété comme le qualiﬁcatif du nom du programme).

- Le nom de la variable peut contenir n’importe quel caractère autre que les espaces, « = », ou « . » mais on recommande d’utiliser « A-Za-z_ » pour éviter les problèmes.

- Si « .progname » est présent, sa déﬁnition s’applique seulement si le programme exécuté se nomme progname ou progname.exe. Ceci permet par exemple à diﬀérentes variantes de TeX d’avoir des chemins de recherche diﬀérents.

- value peut contenir n’importe quel caractère excepté « % » et « @ ». L’option $var.prog n’est pas disponible à droite du signe « = »; à la place, on doit utiliser une variable supplémentaire. Un « ; » dans value est compris comme un « : » si on travaille sous Unix; ceci est très utile et permet d’avoir un seul texmf.cnf pour les systèmes Unix, MS-DOS et Windows.

- Considérée comme une chaîne de caractères, valeur peut contenir n’importe quel caractère. Toutefois, dans la pratique, la plupart des valeurs texmf.cnf sont liées l’expansion du chemin et, comme divers caractères spéciaux sont utilisés dans l’expansion (voir section 8.1.7), tels les accolades et les virgules, ils ne peuvent pas être utilisés dans les noms de répertoires.

  Un « ; » dans value est traduit par « : » s’il est exécuté sous Unix, aﬁn de disposer d’un seul texmf.cnf qui puisse prendre en charge à la fois les systèmes Unix et Windows. Cette traduction se produit pour toute valeur, et pas seulement pour les chemins de recherche mais, heureusement, en pratique, le « ; » n’est pas nécessaire dans d’autres valeurs.

  La fonction $var.prog n’est pas disponible du côté droit; vous devez à la place utiliser une variable supplémentaire.

- Avant tout désarchivage ou décompactage, toutes les déﬁnitions sont lues de telle façon que les variables peuvent être référencées avant d’être déﬁnies.

Voici un ﬁchier de conﬁguration 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 `~$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 ﬁchier 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 ﬁn de ligne ou double), Kpathsea insère à cet endroit le chemin suivant dont la priorité déﬁnie 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éﬁnie ainsi :

> setenv TEXINPUTS /home/karl:
la valeur de TEXINPUTS d’après le ﬁchier texmf.cnf étant :
.:$TEXMF//tex
alors la valeur ﬁnale 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 ﬁn de ligne et enﬁn un double « : ».

##### 8.1.5 Expansion spéciﬁée par les accolades

Option utile, l’expansion par le biais des accolades signiﬁe, par exemple, que `v{a,b}w` va permettre la recherche dans `vaw:vbw`. Les déﬁnitions emboîtées sont autorisées. Ceci peut être utilisé pour établir des hiérarchies TeX multiples en attribuant une liste entre accolades à $TEXMF. Dans le ﬁchier texmf.cnf fourni, on trouve une déﬁnition qui ressemble (il y a en fait plus de répertoires) à la suivante.

      TEXMF = {$TEXMFVAR,$TEXMFHOME,!!$TEXMFLOCAL,!!$TEXMFDIST}

Nous utilisons ensuite ceci pour déﬁnir, par exemple, le chemin d’accès TeX :

      TEXINPUTS = .;$TEXMF/tex//

ce qui signiﬁe que, après avoir cherché dans le répertoire courant, les arborescences complètes $TEXMFVAR/tex, $TEXMFHOME/tex, $TEXMFLOCAL/tex et $TEXMFDIST/tex seront inspectées (les deux derniers utilisant les ﬁchiers de référence ls-R).

##### 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éciﬁe une partie de nom de ﬁchier 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 Récapitulatif des caractères spéciaux dans les ﬁchiers texmf.cnf

La liste suivante récapitule les caractères spéciaux et les constructions dans les ﬁchiers de conﬁguration de Kpathsea.

:

  Séparateur dans un chemin de recherche; au début ou à la ﬁn d’un chemin, ou doublé au milieu, 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`.

,

  Sépare les éléments dans une expansion spéciﬁée par accolades.

//

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

% et #

  Début d’un commentaire.

\

  À la ﬁn d’une ligne, caractère de continuation pour permettre les entrées à plusieurs lignes.

!!

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

Quant à savoir quand un caractère sera considéré comme spécial ou agira comme tel, cela dépend du contexte dans lequel il est utilisé. Les règles sont inhérentes aux multiples niveaux d’interprétation de la conﬁguration (analyse, expansion, recherche, ...) et ne peuvent donc malheureusement pas être énoncées de manière concise. Il n’y a pas de mécanisme général d’échappement; en particulier, « \ » n’est pas un « caractère d’échappement » dans les ﬁchiers texmf.cnf.

Lorsqu’il s’agit de choisir les noms de répertoires pour l’installation, il est plus sûr d’éviter tous les caractères spéciaux.

#### 8.2 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 la TeX Live ou de distributions comprenant beaucoup de répertoires, inspecter tous les répertoires possibles pour un ﬁchier donné durera 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 ﬁchier texte appelé ls-R — en fait une base de données construite au préalable — qui fait correspondre les ﬁchiers à leur répertoire, ce qui permet d’éviter une recherche exhaustive sur le disque.

Un deuxième ﬁchier appelé aliases (qui est également une base de données) permet de donner des noms diﬀérents aux ﬁchiers listés dans ls-R.

##### 8.2.1 Le ﬁchier base de données

Comme nous l’avons expliqué ci-dessus, le nom du principal ﬁchier-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 inspectée ($TEXMF par défaut); la plupart des sites ont une seule arborescence TeX. Kpathsea cherche les ﬁchiers ls-R dans le chemin spéciﬁé dans la variable TEXMFDBS.

La meilleure façon de créer et mettre à jour le ﬁchier 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 ﬁchier ls-R prenne automatiquement en compte les changements dans les ﬁchiers installés, par exemple après une installation ou une mise à jour d’un composant LaTeX.

Si un ﬁchier n’est pas trouvé dans la base de données, par défaut Kpathsea décide de le chercher sur le disque. En revanche, 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 eﬀectue une recherche dans une arborescence indépendamment de toute application. On peut le considérer comme une sorte de find pour localiser des ﬁchiers dans les arborescences TeX (ceci est largement utilisé dans les scripts mktex... de la distribution).

> kpsewhich option... ﬁlename...
Les options spéciﬁé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 ﬁchier et renvoie la première occurrence trouvée. Il n’y a pas d’option pour renvoyer tous les ﬁchiers ayant un nom particulier (vous pouvez utiliser le ﬁnd d’Unix pour cela).

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

--dpi=num

  Déﬁnit la résolution à num ; ceci aﬀecte seulement la recherche des ﬁchiers « gf » et « pk ». « -D » est un synonyme pour assurer la compatibilité avec dvips. Le défaut est 600.

--format=name

  Déﬁnit le format pour la recherche à name. Par défaut, le format est estimé en fonction du nom de ﬁchier. Pour les formats qui n’ont pas de suﬃxe clair associé, comme les ﬁchiers de prise en charge MetaPost et les ﬁchiers de conﬁguration dvips, vous devez spéciﬁer le nom connu de Kpathsea, comme tex ou enc files. Exécutez la commande kpsewhich --help-formats pour en obtenir la liste précise.

--mode=string

  Déﬁnit le nom du mode comme étant string ; ceci aﬀecte 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 ﬁchiers, 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’eﬃcacité.

--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 ﬁchier. « // » et toutes les expansions habituelles sont prises en charge. Les options « --path » et « --format » s’excluent mutuellement.

--progname=name

  Déﬁnit le nom de programme comme étant name. Ceci peut aﬀecter les chemins de recherche via l’option .progname dans les ﬁchiers de conﬁguration. Le défaut est kpsewhich.

--show-path=name

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

--debug=num

  Déﬁnit 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 ﬁchier article.cls. Puisque le suﬃxe .cls est non ambigu, nous n’avons pas besoin de spéciﬁer que nous voulons rechercher un ﬁchier de type tex (répertoires des ﬁchiers sources de TeX). Nous le trouvons dans le sous-répertoire tex/latex/base du répertoire racine « TEXMF ». De même, le suﬃxe non ambigu permet de trouver facilement les autres ﬁchiers.
> 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 ﬁchiers de glyphes de fontes bitmaps, de type .pk, sont utilisés pour l’aﬃchage par des programmes comme dvips et xdvi. Rien n’est renvoyé dans ce cas puisqu’il n’y a pas de ﬁchier Computer Modern .pk créé en amont sur nos systèmes (nous utilisons les versions type 1).
> kpsewhich wsuipa10.pk
/usr/local/texmf-var/fonts/pk/ljfour/public/wsuipa/wsuipa10.600pk
Pour ces fontes (alphabet phonétique de l’université de Washington), nous avons dû créer les ﬁchiers .pk et, puisque le mode Metafont par défaut sur notre installation est ljfour avec une résolution de base de 600 dpi (dots per inch), cette instance est trouvée.
> kpsewhich -dpi=300 wsuipa10.pk
Dans ce cas, lorsque l’on spéciﬁe que nous recherchons une résolution de 300 dpi (-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 ﬁchiers .pk à la résolution demandée en utilisant le script mktexpk.

Intéressons-nous à présent aux ﬁchiers d’en-tête et de conﬁguration pour dvips. Regardons en premier le ﬁchier tex.pro communément utilisé pour la prise en charge de TeX avant de regarder le ﬁchier de conﬁguration générique (config.ps) et la liste des fontes PostScript psfonts.map. Depuis l’édition 2004, les ﬁchiers .map et les ﬁchiers de codage ont changé de place dans l’arborescence texmf. Comme le suﬃxe .ps est ambigu, nous devons spéciﬁer quel type particulier du ﬁchier 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 ﬁchiers de prise en charge Times PostScript d’URW. Leur nom standard dans le schéma de nommage des fontes est « utm ». Le premier ﬁchier que nous voyons est le ﬁchier de conﬁguration, qui contient le nom du ﬁchier de la liste :

> kpsewhich --format="dvips config" config.utm
/usr/local/texmf-dist/dvips/psnfss/config.utm
Le contenu de ce ﬁchier est
p +utm.map
qui pointe vers le ﬁchier utm.map, que nous cherchons à localiser ensuite.
> kpsewhich utm.map
/usr/local/texmf-dist/fonts/map/dvips/times/utm.map
Ce ﬁchier liste les noms des ﬁchiers 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 ﬁchiers 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 ﬁchier donné. C’est particulièrement important si vous suspectez que c’est, pour une raison quelconque, une mauvaise version du ﬁchier qui est utilisée, puisque kpsewhich va vous montrer le premier ﬁchier trouvé.

##### 8.2.4 Opérations de débogage

Il est quelquefois nécessaire de savoir comment un programme référence les ﬁchiers. Pour permettre cela, Kpathsea oﬀre plusieurs niveaux de débogage :

1

  Appels à stat (test d’existence de ﬁchier). 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 diﬀérentes tables (comme la base de données ls-R, les ﬁchiers de correspondance de fontes, les ﬁchiers de conﬁguration).

4

  Opérations d’ouverture et de fermeture des ﬁchiers.

8

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

16

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

32

  Recherche de ﬁchiers.

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 diﬀérents ﬁchiers. De plus, lorsqu’un ﬁchier n’est pas trouvé, la trace du débogage montre les diﬀérents répertoires dans lesquels le programme va chercher tel ou tel ﬁchier, 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éﬁnissant égale à une 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 ﬁchier sur ces systèmes. À des ﬁns de diagnostic, vous pouvez temporairement aﬀecter KPATHSEA_DEBUG_OUTPUT=err.log pour capturer le ﬂux standard d’erreur dans le ﬁchier err.log.

Considérons comme exemple un petit ﬁchier source LaTeX, hello-world.tex, dont le contenu est le suivant.

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

Ce petit ﬁchier utilise simplement la fonte cmr10, aussi allons voir comment dvips prépare le ﬁchier 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 le manuel de dvips). La sortie (légèrement modiﬁée) apparaît dans la ﬁgure 12.
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 12: Recherche des ﬁchiers de conﬁguration

dvips commence par localiser ses ﬁchiers de fonctionnement. D’abord, texmf.cnf est trouvé, ce qui donne les déﬁnitions pour les chemins de recherche servant à localiser les autres ﬁchiers, ensuite le ﬁchier base de données ls-R (pour optimiser la recherche des ﬁchiers) et le ﬁchier 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 ﬁchier. Ensuite dvips continue en cherchant le ﬁchier de conﬁguration générique config.ps avant de rechercher le ﬁchier de paramétrisation .dvipsrc (qui, dans notre cas, n’est pas trouvé). Enﬁn, dvips localise le ﬁchier de conﬁguration pour les fontes PostScript Computer Modern config.cms (ceci est lancé par l’option -Pcms de la commande dvips). Ce ﬁchier contient la liste des ﬁchiers qui déﬁnissent la relation entre les noms des fontes selon TeX, selon PostScript et dans le système de ﬁchiers.

> 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 ﬁchiers, y compris le ﬁchier 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 ﬁchier d’association PostScript).

Arrivé là, dvips s’identiﬁe à l’utilisateur :

This is dvips(k) 5.92b Copyright 2002 Radical Eye Software

pour continuer ensuite en cherchant le ﬁchier 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 ﬁchier, dvips aﬃche la date et l’heure, nous informe qu’il va générer le ﬁchier hello-world.ps puis qu’il a besoin du ﬁchier 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 ﬁchier cmr10.tfm, qui est trouvé, puis quelques ﬁchiers de prologue de plus (non montrés) sont référencés; ﬁnalement le ﬁchier de la fonte type 1 cmr10.pfb est localisé et inclus dans le ﬁchier 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 oﬀre 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 ﬁchier texmf.cnf qui est lu par Kpathsea. Les paramètres en question se trouvent dans la troisième partie du ﬁchier 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 ﬁchier de format pour chaque nouveau paramétrage. Par exemple, vous pouvez générer une version large de TeX et appeler le ﬁchier de format hugetex.fmt. En utilisant la méthode prise en charge par Kpathsea qui consiste à suﬃxer la variable par le nom du programme, la valeur particulière de la variable main_memory destinée à ce ﬁchier de format sera lue dans le ﬁchier 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 ﬁchiers TFM lus.

hash_extra

  Espace supplémentaire pour la table de hachage des noms de séquences de contrôle; sa valeur par défaut est 600000.

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.

#### 8.4 $TEXMFDOTDIR

À divers endroits ci-dessus, nous avons indiqué diﬀérents chemins de recherche commençant par . (pour rechercher d’abord dans le répertoire actuel), comme dans

TEXINPUTS=.;$TEXMF/tex//

Il s’agit d’une simpliﬁcation. Au lieu de simplement « . », le ﬁchier texmf.cnf que nous distribuons dans TeX Live utilise $TEXMFDOTDIR comme dans :

TEXINPUTS=$TEXMFDOTDIR;$TEXMF/tex//
(Dans le ﬁchier distribué, le deuxième élément du chemin d’accès est également légèrement plus compliqué que $TEXMF/tex//. Mais c’est mineur; ici nous voulons pour discuter de la fonctionnalité $TEXMFDOTDIR).

La raison pure et simple de l’utilisation de la variable $TEXMFDOTDIR dans le chemin au lieu d’un simple « . » est qu’il puisse être surchargé. Par exemple, un document complexe peut avoir de nombreux ﬁchiers sources disposés dans de nombreux sous-répertoires. Pour gérer cela, vous pouvez déﬁnir $TEXMFDOTDIR comme étant .// (par exemple, dans le cas où vous compilez le document) et ces sous-répertoires seront tous fouillés. (Attention : ne pas utiliser .// par défaut; il est en général hautement non désirable, et potentiellement peu sûr, de rechercher un document arbitraire dans tous les sous-répertoires.)

Autre exemple : vous pouvez ne pas du tout chercher dans le répertoire actuel, par exemple si vous avez fait en sorte que tous les dossiers soient trouvés via des chemins explicites. Vous pouvez pour cela par exemple déﬁnir $TEXMFDOTDIR comme /riendetel ou tout répertoire inexistant.

La valeur par défaut de $TEXMFDOTDIR est juste « . », comme déﬁni dans notre texmf.cnf.

### 9 Remerciements

TeX Live est le résultat des eﬀorts 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 associations d’utilisateurs anglaise, allemande, néerlandaise et polonaise (TUG, DANTE e.V., NTG, et GUST, respectivement) qui contribuent ensemble à l’infrastructure technique et administrative. Soutenez votre association locale (voir la liste https://tug.org/usergroups.html)!

- L’équipe du CTAN (https://ctan.org) qui distribue les images des distributions TeX Live et fournit les sites d’hébergement pour le stockage et la mise à jour des extensions qui sont la base de TeX Live.

- Nelson Beebe, pour avoir permis l’accès à de nombreuses plateformes aux développeurs TeX Live, avoir lui-même participé aux tests de façon étendue et pour ses eﬀorts bibliographiques sans pareil.

- John Bowman, pour avoir eﬀectué de nombreux changements dans son programme Asymptote pour le faire fonctionner dans TeX Live.

- Peter Breitenlohner et toute l’équipe e-TeX qui construisent les bases des successeurs de TeX, Peter tout particulièrement pour des années d’aide concernant l’usage des autotools de GNU partout dans TeX Live et pour avoir conservé à jour les sources. Peter est décédé en octobre 2015 et nous dédions à sa mémoire la poursuite de notre travail.

- Jin-Hwan Cho et toute l’équipe de DVIPDFMx pour leur excellent programme et leur réactivité face aux problèmes de conﬁguration.

- Thomas Esser et sa merveilleuse distribution teTeX sans laquelle TeX Live n’aurait jamais vu le jour.

- Michel Goossens, en tant que coauteur de la documentation initiale.

- Eitan Gurari, dont le programme TeX4ht est utilisé pour créer la version HTML de cette documentation et qui travaillait inlassablement à l’améliorer, ce dans des délais très courts. Eitan nous a quittés prématurément en juin 2009, et nous dédions la présente documentation à sa mémoire.

- Hans Hagen qui, outre sa participation active aux tests, a adapté l’extension ConTeXt (https://pragma-ade.com/) aux besoins de TeX Live, et qui est un moteur permanent du développement de TeX.

- Hàn Thế Thành, Martin Schröder et toute l’équipe pdfTeX qui continuent inlassablement à étendre les performances de TeX.

- Hartmut Henkel, pour ses contributions au développement de pdfTeX et LuaTeX entre autres.

- Shunshaku Hirata, pour son travail original and permanent sur DVIPDFMx.

- Taco Hoekwater, pour son travail important et incessant sur le développement de MetaPost et de (Lua)TeX (http://luatex.org) lui-même, pour l’intégration de ConTeXt dans TeX Live, pour les nouvelles fonctionnalités multi-thread de Kpathsea, et bien plus encore.

- Khaled Hosny, pour son travail substantiel sur XeTeXet DVIPDFMx et ses eﬀorts concernant les fontes arabes et autres.

- Paweł Jackowski pour l’installateur Windows tlpm et Tomasz Łuczak pour la version graphique tlpmgui utilisée dans l’édition précédente.

- Akira Kakuto, pour son aide précieuse qui nous a permis d’intégrer dans TeX Live les binaires Windows de ses distributions W32TEX et W64TEX ( https://www.w32tex.org/).

- Jonathan Kew, pour avoir produit XeTeX, pour l’avoir intégré dans TeX Live, pour avoir créé la première version de l’installateur MacTeXet enﬁn pour l’éditeur TeXworks que nous recommandons.

- Hironori Kitagawa, pour la maintenance de (e)pTeX et la prise en charge aﬀérente.

- Dick Koch, pour la maintenance de MacTeX (https://tug.org/mactex) faite en symbiose avec TeX Live.

- Reinhard Kotucha, pour ses contributions majeures à l’infrastructure de TeX Live 2008 et à son programme d’installation, pour ses contributions sous Windows et pour son script getnonfreefonts en particulier.

- Siep Kroonenberg, également pour ses contributions majeures à l’infrastructure de TeX Live 2008 et à son programme d’installation ainsi que pour la réécriture de cette documentation concernant ces fonctionnalités.

- Clerk Ma, pour les corrections de bugs de moteurs et leurs extensions.

- Mojca Miklavec, pour son aide précieuse concernant ConTeXt, ses nombreux exécutables et autres.

- Heiko Oberdiek, pour le paquet epstopdf et bien d’autres, pour avoir compressé l’énorme pst-geo de façon à ce que nous puissions l’inclure, et, par-dessus tout, son travail remarquable sur hyperref.

- Phelype Oleinik, pour le \input délimité par des groupes sur plusieurs moteurs en 2020, et plus encore.

- Petr Olšak, qui coordonna et vériﬁa minutieusement toute la partie tchèque et slovaque.

- Toshio Oshima, pour le visualisateur dviout pour Windows.

- Manuel Pégourié-Gonnard, pour son aide concernant le programme de mise à jour de la distribution, la documentation et pour le développement de texdoc.

- Fabrice Popineau, pionnier du développement de TeX Live sous Windows et pour son travail sur la documentation française.

- Norbert Preining, principal architecte de la présente infrastructure TeX Live et de son installateur, coordinateur (avec Frank Küster) de la version Debian de TeX Live, et important contributeur de longue date.

- Sebastian Rahtz, qui a créé la distribution TeX Live et en a assuré la maintenance pendant de nombreuses années. Sebastian est décédé en mars 2016 et nous dédions à sa mémoire la poursuite de notre travail.

- Luigi Scarso, pour continuer le développement de MetaPost, LuaTeX, et bien plus encore.

- Andreas Scherer, pour cwebbin, l’implémentation de CWEB utilisée dans TeX Live.

- Takuji Tanaka, pour la maintenance de (e)(u)pTeX et la prise en charge aﬀérente.

- Tomasz Trzeciak, pour son aide générale concernant Windows.

- Vladimir Volovich, pour son aide substantielle, en particulier pour avoir rendu possible l’intégration de xindy dans TeX Live.

- Staszek Wawrykiewicz, un des principaux testeurs de TeX Live et coordinateur des contributions polonaises (fontes, installation Windows, etc.). Staszek est décédé en février 2018 et nous dédions à sa mémoire la poursuite de notre travail.

- Olaf Weber, pour son patient assemblage de Web2C les années précédentes.

- Gerben Wierda, qui a créé et maintenu initialement la partie macOS.

- Graham Williams, l’auteur original du catalogue TeX.

- Joseph Wright, pour son travail conséquent sur la mise à disposition de la même fonctionnalité primitive sur tous les moteurs.

- Hironobu Yamashita, pour son travail sur pTeX et la prise en charge associée.

Les binaires ont été compilés par :

- Marc Baudoin (amd64-netbsd, i386-netbsd);

- Karl Berry (i386-linux);

- Ken Brown (x86_64-cygwin);

- Simon Dales (armhf-linux);

- Akira Kakuto (windows);

- Dick Koch (universal-darwin);

- Mojca Miklavec (amd64-freebsd, armhf-linux, i386-freebsd, x86_64-darwinlegacy, i386-solaris, x86_64-solaris, sparc-solaris),;

- Norbert Preining (aarch64-linux, armhf-linux, x86_64-linuxmusl, i386-freebsd, amd64-freebsd, i386-linux, x86_64-linux, i386-solaris, x86_64-solaris).

Pour des informations concernant la compilation de TeX Live, cf. https://tug.org/texlive/build.html.

Traducteurs de ce manuel :

- Takuto Asakura (japonais),

- Denis Bitouzé & Patrick Bideault (français);

- Carlos Enriquez Figueras (castillan);

- Jjgod Jiang, Jinsong Zhao, Yue Wang, & Helin Gai (mandarin);

- Marco Pallante & Carla Maggi (italien);

- Nikola Lečić (serbe);

- Petr Sojka & Jan Busa (tchèque et slovaque);

- Boris Veytsman & Vladimir Lomov (russe);

- Uwe Ziegenhagen (allemand).

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

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

### 10 Historique des versions successives

#### 10.1 Éditions précédentes

La discussion commença à la ﬁn 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 : https://tug.org/tds), qui spéciﬁait la gestion des ﬁchiers TeX sous une forme logique. La mouture ﬁnale 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 conﬁguration idéale, car il prenait en charge déjà plusieurs plateformes 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 grâce à Fabrice Popineau.

Pour la cinquième édition (mars 2000), de nombreuses parties du CD ont été vériﬁées et révisées, des centaines de composants mis à jour. Le contenu détaillé des composants était décrit par des ﬁchiers 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 : https://debian.org/intro/free); nous avons fait de notre mieux pour vériﬁer 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 ﬁchier language.dat adéquat.

La septième édition (mai 2002) a comme ajout majeur une installation pour macOS 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.

##### 10.1.1 2003

En 2003, le ﬂot 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 13). Par ailleurs :

- À la demande de l’équipe LaTeX, nous avons modiﬁé les commandes standard latex et pdﬂatex pour qu’elles utilisent e-TeX (voir page 18).

- Les nouvelles fontes Latin Modern sont disponibles (et recommandées).

- La prise en charge pour Alpha OSF a été supprimée (celui pour HPUX l’avait été auparavant), car personne disposant des machines nécessaires ne s’est proposé pour compiler les nouveaux binaires.

- L’installation pour Windows a été largement modiﬁée; un environnement de travail intégré basé sur XEmacs a été introduit.

- Des programmes supplémentaires importants pour Windows (Perl, Ghostscript, ImageMagick, Ispell) sont maintenant installés dans le répertoire d’installation de TeX Live.

- Les ﬁchiers font map utilisés par dvips, dvipdfm et pdftex sont maintenant générés par le nouveau programme updmap et installés dans texmf/fonts/map.

- Dorénavant, TeX, Metafont et MetaPost écrivent les caractères 8 bit présentés en entrée sans modiﬁcation et non pas avec la notation `^^`, que ce soit dans des ﬁchiers (par la commande `write`), dans les ﬁchiers de trace (`.log`) ou sur le terminal. Dans le TeX Live 7, l’écriture de ces caractères 8 bit était inﬂuencée par les paramètres de localisation du système; maintenant ces paramètres n’inﬂuent plus du tout sur le comportement des programmes TeX. Si pour quelque raison que ce soit, vous avez besoin de la notation `^^` en sortie, renommez le ﬁchier `texmf-dist/web2c/cp8bit.tcx`. Les prochaines versions disposeront d’un moyen plus propre pour contrôler cette sortie.

- La documentation de TeX Live a été largement révisée.

- Enﬁn, comme la numérotation séquentielle des versions devenait peu maniable, il a été décidé d’identiﬁer désormais la version de TeX Live par l’année : TeX Live 2003 au lieu de TeX Live 8.

##### 10.1.2 2004

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

- Si vous avez installé des fontes supplémentaires qui ont leur propre ﬁchier .map ou des ﬁchiers .enc spéciﬁques, vous devrez vraisemblablement déplacer ces ﬁchiers.

  Les ﬁchiers .map sont désormais recherchés uniquement dans les sous-répertoires fonts/map (dans chaque arborescence texmf), leur chemin de recherche est donné par la variable TEXFONTMAPS de texmf.cnf. De même, les ﬁchiers .enc sont désormais recherchés uniquement dans les sous-répertoires fonts/enc, leur chemin de recherche est donné par la variable ENCFONTS de texmf.cnf. Le script updmap devrait émettre des messages d’avertissement pour les ﬁchiers .map et .enc mal placés.

  Sur les diﬀérentes façons de traiter le problème, consulter https://tug.org/texlive/mapenc.html.

- La distribution pour Windows a changé cette année : l’installation de la distribution fpTeX (basée sur Web2C) de Fabrice Popineau n’est plus proposée. À la place, vous pouvez tester et installer la distribution proTeXt basée sur MiKTeX (indépendante de Web2C), voir section 2, page 13.

- L’ancien répertoire texmf a été éclaté en trois parties : texmf, texmf-dist et texmf-doc. Voir section 2.2, page 14.

- Tous les ﬁchiers relatifs aux diﬀérents avatars de TeX sont désormais regroupés dans le même sous-répertoire tex des arborescences texmf*, plutôt qu’avoir des répertoires séparés apparentés tex, etex, pdftex, pdfetex, etc. Voir texmf-dist/doc/generic/tds/tds.html#Extensions.

- Les scripts auxiliaires, normalement pas exécutés directement par les utilisateurs, sont regroupés dans des sous-répertoires scripts des arborescences texmf*. On les localise grâce à la commande `kpsewhich -format=texmfscripts`. Au cas où vous en auriez, les programmes utilisant ces scripts nécessiteront une adaptation. Voir https://tug.org/tds/tds.html\#Scripts.

- La plupart des formats aﬃchent en clair (dans les ﬁchiers .log en particulier) les caractères imprimables au lieu de les transcrire en notation hexadécimale `^^`. Ceci se fait grâce au ﬁchier cp227.tcx, qui considère comme imprimables les caractères 32 à 256, ainsi que les tabulations et les changements de page (caractères 9 à 11). Les formats faisant exception sont plain TeX (seuls les caractères 32 à 127 sont déclarés imprimables), ConTeXt (0 à 255 imprimables) et les formats basés sur Omega. Il y a peu de diﬀérence avec le comportement de TeX Live 2003, mais la mise en œuvre est plus propre et plus facilement conﬁgurable. Voir texmf-dist/doc/web2c/web2c.html#TCX-ﬁles. Noter que l’utilisation du codage Unicode en entrée peut provoquer des aﬃchages défectueux en sortie (TeX code sur un seul octet).

- Tous les formats, sauf plain TeX, font appel au moteur pdfetex (qui produit bien sûr par défaut des ﬁchiers DVI lorsque le format choisi est LaTeX). Ceci permet aux formats LaTeX, ConTeXt, etc., d’avoir accès aux fonctionnalités microtypographiques de pdftex (alignement optique des marges par exemple) et aux fonctionnalités de e-TeX ( texmf-dist/doc/etex/base/).

  Ceci rend indispensable le recours à l’extension ifpdf (qui fonctionne aussi bien avec plain que LaTeX) pour déterminer si le format de sortie est DVI ou PDF. Tester si la commande \pdfoutput est déﬁnie ou non n’est pas un moyen ﬁable de le faire.

- pdfTeX (https://tug.org/applications/pdftex/) oﬀre de nouvelles fonctionnalités :

  - Les commandes \pdfmapfile et \pdfmapline permettent de spéciﬁer le choix des ﬁchiers .map à utiliser pour le document en cours.

  - L’amélioration du gris typographique par variation (inﬁme) de la largeur des caractères (font expansion) est plus facile à mettre en œuvre, voir https://www.ntg.nl/pipermail/ntg-pdftex/2004-May/000504.html

  - Le ﬁchier pdftex.cfg n’est plus utilisé. Toutes les aﬀectations de paramètres doivent désormais être faites dans le préambule en utilisant les primitives ad hoc.

  - Pour plus d’informations, consulter le manuel de pdfTeX : texmf-dist/doc/pdftex/manual.

- La primitive \input de tex, mf et mpost, accepte désormais les espaces et autres caractères spéciaux dans les noms de ﬁchiers à condition d’utiliser des double quotes, en voici deux exemples typiques :

             \input "filename with spaces"   % plain
      \input{"filename with spaces"}  % latex

  Consulter le manuel Web2C pour plus d’informations : texmf-dist/doc/web2c.

- Les fonctionnalités de encTeX sont désormais incluses dans Web2C. Ainsi, tous les formats construits avec l’option -enc y ont accès. encTeX permet le transcodage en entrée et en sortie et l’utilisation transparente du codage Unicode UTF-8. Voir texmf-dist/doc/generic/enctex/ et https://olsak.net/enctex.html.

- Un nouveau moteur combinant les fonctionnalités de e-TeX et d’Omega, appelé Aleph, est disponible. Quelques informations se trouvent dans texmf-dist/doc/aleph/base et à https://texfaq.org/FAQ-enginedev. Le format LaTeX utilisant Aleph s’appelle lamed.

- La licence LPPL de LaTeX (version décembre 2003) a changé, elle est désormais compatible avec les prescriptions Debian. Les autres changements sont décrits dans le ﬁchier ltnews, voir texmf-dist/doc/latex/base.

- Un nouveau programme, dvipng, qui convertit les ﬁchiers DVI en images PNG a été ajouté. Voir https://ctan.org/pkg/dvipng.

- Nous avons dû réduire le nombre de fontes incluses dans l’extension cbgreek, ceci a été fait avec l’accord et l’aide de l’auteur (Claudio Beccari). Les fontes exclues (invisibles, transparentes, contours) sont rarement utilisées et la place nous manquait. La collection complète des fontes cbgreek est disponible sur CTAN ( https://ctan.org/pkg/cbgreek-complete).

- La commande oxdvi a été supprimée, il suﬃt d’utiliser xdvi à la place.

- Les commandes initex, virtex et leurs homologues pour mf et mpost ont disparu. Vous pouvez les recréer si nécessaire, mais elles sont avantageusement remplacées, depuis des années maintenant, par l’option -ini (tex -ini pour initex et virtex).

- Les binaires pour l’architecture i386-openbsd ont été supprimés par manque de volontaires pour les compiler.

  Sur sparc-solaris (au moins) il sera probablement nécessaire de positionner la variable d’environnement LD_LIBRARY_PATH pour utiliser les programmes de la famille t1utils. Ceci vient du fait qu’ils sont compilés en C++ et que l’emplacement des bibliothèques dynamiques est variable. Ce n’est pas une nouveauté 2004, mais ce point n’était pas documenté précédemment. De même, sur mips-irix, les bibliothèques dynamiques MIPSpro 7.4 sont nécessaires.

##### 10.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 :

- Trois nouveaux scripts texconﬁg-sys, updmap-sys et fmtutil-sys ont été introduits; ils agissent sur la conﬁguration générale de la machine, comme le faisaient les scripts texconﬁg, updmap et fmtutil jusqu’à l’an dernier. Les nouveaux scripts texconﬁg, updmap et fmtutil modiﬁent maintenant la conﬁguration personnelle de l’utilisateur qui les lance; le résultat est placé dans le répertoire personnel de l’utilisateur (sous $HOME/.texlive2005).

- De nouvelles variables, TEXMFCONFIG (resp. TEXMFSYSCONFIG) ont été introduites; elles déﬁnissent les répertoires où doivent se trouver les ﬁchiers de conﬁguration de l’utilisateur (resp. de la machine), comme fmtutil.cnf et updmap.cfg. Les utilisateurs de ﬁchiers de conﬁguration locaux fmtutil.cnf ou updmap.cfg devront probablement les déplacer; une autre possibilité est de modiﬁer la déﬁnition des variables TEXMFCONFIG ou TEXMFSYSCONFIG dans texmf.cnf. L’important est de s’assurer de la cohérence entre les déﬁnitions de ces variables dans texmf.cnf et l’emplacement réel de ces ﬁchiers. Voir section 2.3, page 15 pour la description des diﬀérentes arborescences texmf utilisées.

- L’an dernier, nous avions rendu « undefined » certaines primitives propres à pdftex (comme `\pdfoutput`) dans les formats créés à partir de pdfetex (latex amstex, context par exemple)). C’était à titre transitoire, aussi cette année, ces primitives sont de nouveau déﬁnies dans tous les formats à base pdf(e)tex, même lorsqu’ils sont utilisés pour produire des ﬁchiers .dvi. Ceci implique qu’il vous faudra modiﬁer vos documents qui utilisent le test `\ifx\pdfoutput\undefined` pour déterminer si la sortie est en DVI ou en PDF. Le mieux est d’utiliser l’extension ifpdf.sty et son test `\ifpdf` qui fonctionne même en plain TeX.

- L’an dernier, nous avions fait en sorte que la plupart des formats impriment dans les sorties .log des caractères 8 bit lisibles à la place des notations hexadécimales `^^` (voir section précédente). Le nouveau ﬁchier TCX empty.tcx permet de revenir facilement à la notation traditionnelle `^^`, il suﬃt de coder :

             latex --translate-file=empty.tcx fichier.tex

- Le nouveau programme dvipdfmx est disponible pour convertir des ﬁchiers DVI en PDF; ce programme remplace dvipdfm, toujours disponible, mais dont l’usage est maintenant déconseillé.

- Les nouveaux programmes pdfopen et pdfclose sont inclus pour permettre de relancer les ﬁchiers PDF dans Adobe Acrobat Reader sans devoir relancer le programme (d’autres aﬃcheurs PDF, notamment xpdf, gv et gsview, n’ont jamais souﬀert de ce problème).

- Les variables HOMETEXMF et VARTEXMF ont été renommées en TEXMFHOME et TEXMFSYSVAR respectivement pour raisons de cohérence avec les autres noms de variables. Il y a aussi TEXMFVAR qui désigne maintenant un répertoire personnel de l’utilisateur (cf. le premier point de la présente liste).

##### 10.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 https://scripts.sil.org/xetex.

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

Le format tex.fmt et les formats pour MetaPost et Metafont ne se trouvent plus dans texmf-dist/web2c mais dans des sous-répertoires de texmf-dist/web2c (la recherche de ﬁchiers .fmt est néanmoins faite aussi dans texmf-dist/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’eﬀet 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 le CTAN (https://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.

Enﬁn, en mai 2006 Thomas Esser a annoncé qu’il renonçait à poursuivre le développement de teTeX (https://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.

##### 10.1.5 2008

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

Ce ﬁchier permet entre autres choses de procéder à des mises à jour par le réseau après l’installation initiale. Cette possibilité était oﬀerte 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 oﬀre 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 ﬁchiers .map lorsque c’est nécessaire.

Les fonctionnalités de tlmgr englobent toutes les tâches dévolues auparavant à texconﬁg 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 plateformes.

L’utilitaire kpsewhich dispose de deux options nouvelles : --all qui retourne toutes les occurrences du ﬁchier 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 conﬂits de codage qu’ils induisaient n’ayant pas pu être résolus.

Le format platex a été supprimé aﬁn de résoudre un conﬂit de nom avec son homonyme japonais; la prise en charge pour le polonais est assurée maintenant par l’extension polski.

Les ﬁchiers WEB d’extension .pool sont maintenant inclus dans les binaires aﬁn de faciliter les mises à jour.

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

##### 10.1.6 2009

En 2009, le format de sortie par défaut de Lua(LA)TeX est maintenant le PDF aﬁn de proﬁter de la prise en charge des polices OpenType et autres fonctionnalités de LuaTeX. De nouveaux exécutables nommés dviluatex et dvilualatex fournissent une sortie DVI. La page d’accueil de LuaTeX est http://luatex.org.

Le moteur Omega ainsi que le format Lambda ont été retirés, après discussion avec les auteurs d’Omega. Les versions à jour d’Aleph et de Lamed ont été conservées, ainsi que les utilitaires Omega.

TeX Live fournit la nouvelle version des polices Type 1 de l’AMS, y compris Computer Modern : les quelques changements de forme faits au cours des ans par Knuth dans les sources Metafont ont été intégrés et le hinting a été amélioré. Les polices Euler ont été en grande partie redessinées par Hermann Zapf (voir https://tug.org/TUGboat/Articles/tb29-2/tb92hagen-euler.pdf). Dans tous les cas, les métriques n’ont pas changé. La page d’accueil des polices de l’AMS est https://ams.org/tex/amsfonts.html.

Le nouvel éditeur intégré TeXworks est fourni pour Windows, ainsi que dans MacTeX. Pour les autres plateformes, ainsi que d’autres informations, voir la page de TeXworks : https://tug.org/texworks. Cet éditeur fonctionnant sur de nombreuses plateformes, inspiré par l’éditeur TeXShop de macOS, vise à faciliter l’utilisation de TeX.

Le programme de création de graphiques Asymptote est fourni pour plusieurs plateformes. Il fournit un langage de description de graphiques en mode texte plus ou moins du même genre que MetaPost, mais avec, entre autres, des fonctionnalités 3D avancées. Sa page d’accueil est https://asymptote.sourceforge.io.

Le programme dvipdfm séparé a été remplacé par dvipdfmx qui, lorsqu’il est appelé par ce nom, travaille dans un mode de compatibilité spéciﬁque. Le programme dvipdfmx fournit des fonctionnalités pour les écritures CJK et inclut de nombreux correctifs accumulés au ﬁl des ans depuis la dernière sortie de dvipdfm.

Des exécutables pour les plateformes cygwin et i386-netbsd sont maintenant fournis, tandis que les autres distributions BSD ont été abandonnées; nous avons entendu dire que OpenBSD et FreeBSD fournissent TeX via leurs propres systèmes de gestion de paquets, et par ailleurs il était diﬃcile sur ces plateformes de fabriquer des binaires qui aient une chance de fonctionner sur plus d’une version.

Quelques autres changements en vrac : nous utilisons maintenant xz, qui remplace lzma ( https://tukaani.org/xz/), pour comprimer nos archives; un `$`littéral est autorisé dans les noms de ﬁchiers s’il n’est pas suivi du nom d’une variable connue; la bibliothèque Kpathsea est maintenant multi-threadée (ce qui sert dans MetaPost); le processus complet de compilation de TeX Live est maintenant basé sur Automake.

Remarque ﬁnale concernant le passé : toutes les anciennes distributions TeX Live ainsi que les jaquettes des CD correspondants sont disponibles ici : ftp://tug.org/historic/systems/texlive.

##### 10.1.7 2010

En 2010, les PDF générés utilisent par défaut la version 1.5 du format PDF, ce qui permet une plus grande compression. Ceci concerne tous les moteurs TeX produisant directement du PDF, ainsi qu’à dvipdfmx. Pour revenir au format PDF 1.4, vous pouvez charger le paquet pdf14 sous LaTeX, ou régler manuellement `\pdfminorversion=4` (sous pdfTeX).

pdf(LA)TeX convertit maintenant automatiquement les ﬁchiers EPS utilisés au format PDF, en utilisant le paquet epstopdf, dans tous les cas où le ﬁchier de conﬁguration LaTeX graphics.cfg est chargé, et que le format de sortie est le PDF. Les options par défaut sont choisies pour éviter autant que possible tout risque d’écrasement d’un ﬁchier PDF créé manuellement, mais vous pouvez aussi empêcher le chargement d’epstopdf en plaçant `\newcommand{\DoNotLoadEpstopdf}{}` (ou `\def...` avant la déclaration \documentclass. Le paquet n’est pas chargé non plus si pst-pdf est utilisé. Pour plus de détails, reportez-vous à la documentation du paquet epstopdf ( https://ctan.org/pkg/epstopdf-pkg).

Un autre changement, relié au précédent, est que l’exécution d’un tout petit nombre de commandes externes depuis TeX (avec le commande `\write18`) est désormais autorisée par défaut. Ces commandes sont repstopdf, makeindex, kpsewhich, bibtex, et bibtex8; cette liste est déﬁnie dans texmf.cnf. Si vous souhaitez désactiver cette fonctionnalité, vous pouvez désélectionner cette option à l’installation (section 3.2.4), ou modiﬁer la valeur après installation en exécutant `tlmgr conf texmf shell_escape 0`.

Un autre changement est encore relié aux deux derniers : BibTeX et Makeindex refusent désormais par défaut d’écrire leur ﬁchier de sortie dans n’importe quel répertoire (ce que TeX refusait déjà). Ceci a pour but de permettre leur inclusion dans la liste ci-dessus. Pour modiﬁer ce comportement, vous pouvez utiliser la variable d’environnement TEXMFOUTPUT, ou modiﬁer la valeur de `openout_any`.

XeTeX oﬀre désormais un ajustement optique des marges similaire à celui de pdfTeX(sans la dilatation des fontes, non disponible actuellement).

Par défaut, tlmgr garde maintenant une copie de sauvegarde de tous les paquets mis à jour (tlmgr option autobackup 1) pour permettre de revenir facilement à l’ancienne version au cas où la nouvelle soit cassée, en utilisant tlmgr restore. Si vous faites des mises à jour après l’installation, et n’avez pas la place de garder ces copies de sauvegarde, exécutez tlmgr option autobackup 0.

De nouveaux programmes sont inclus : le moteur pTeX et les utilitaires reliés pour la composition du japonais; le programme BibTeXU qui est une version de BibTeX gérant Unicode; l’utilitaire chktex (originellement disponible à http://baruch.ev-en.org/proj/chktex) pour vériﬁer les documents (LA)TeX; le programme de conversion DVI vers SVG dvisvgm ( https://dvisvgm.de).

Nous fournissons des exécutables pour les nouvelles plateformes suivantes : amd64-freebsd, amd64-kfreebsd, i386-freebsd, i386-kfreebsd, x86_64-darwin et x86_64-solaris.

Un changement dans TeX Live que nous avions oublié de noter : de nombreux exécutables relatifs à TeX4ht ont été retirés de la liste des exécutables. La commande générique mk4ht permet de lancer les nombreuses variantes de tex4ht.

Enﬁn, TeX Live telle qu’elle est présentée dans le DVD TeX Collection ne peut plus être exécutée de façon portable (en live) — contrairement à ce qu’indique le nom. Il n’y a désormais plus assez de place sur un seul DVD. Un eﬀet secondaire agréable de cette nouvelle disposition est que l’installation depuis un DVD physique est maintenant beaucoup plus rapide.

##### 10.1.8 2011

Les binaires pour macOS (universal-darwin et x86_64-darwin) ne fonctionnent désormais que sous Leopard ou une version ultérieure; Panther et Tiger ne sont plus pris en charge.

Le programme biber pour le traitement des bibliographies est inclus pour les plateformes les plus courantes. Son développement suit de près celui du paquet biblatex qui réimplémente totalement la gestion des bibliographies sous LaTeX.

Le programme MetaPost (mpost) ne crée plus et n’utilise plus de ﬁchiers .mem. Les ﬁchiers utiles, comme plain.mp, sont simplement traités à chaque exécution. Ceci est relié à la prise en charge de MetaPost en tant que bibliothèque, qui est un autre changement important bien que peu visible par les utilisateurs.

L’implémentation en Perl de updmap, qui n’était utilisée que sous Windows, a été remaniée et est désormais utilisée sur toutes les plateformes. Il ne devrait pas y avoir de changement visible par les utilisateurs, mis à part une exécution bien plus rapide.

Les commandes initex et inimf ont été réintroduites (mais aucune autre variante ini*).

##### 10.1.9 2012

tlmgr permet d’utiliser plusieurs dépôts de paquets simultanément pour les mises à jour. Pour plus de détails, consulter la section sur les dépôts multiples dans l’aide de tlmgr (utiliser tlmgr help par exemple).

Le paramètre \XeTeXdashbreakstate est réglé à 1 par défaut, pour xetex et xelatex. Ceci autorise les coupures de lignes après les tirets cadratin et demi-cadratins, ce qui a toujours été le comportement de TeX, LaTeX, LuaTeX, etc. Si des documents XeTeX existants doivent conserver une parfaite compatibilité au niveau des coupures de lignes, il devront mettre \XeTeXdashbreakstate à 0 explicitement.

Les ﬁchiers de sortie générés par pdftex et dvips, entre autres, peuvent maintenant dépasser les 2 gigabytes.

Les 35 polices Postscript standard sont incluses par défaut dans la sortie de dvips, car il y en a trop de versions diﬀérentes dans la nature.

Dans le mode d’exécution par \write18 limité (le mode par défaut), la commande mpost est maintenant autorisée.

Un ﬁchier texmf.cnf placé dans ../texmf-local (par exemple : /usr/local/texlive/texmf-local/web2c/texmf.cnf) sera trouvé et utilisé s’il existe.

Le script updmap lit maintenant un ﬁchier updmap.cfg par arborescence au lieu d’un seul ﬁchier global. Ce changement devrait être invisible à moins que vous n’ayez édité vos ﬁchiers updmap.cfg directement. Voir la sortie de updmap --help pour plus de détails.

Plateformes : armel-linux et mipsel-linux ont été ajoutés; sparc-linux et i386-netbsd ne font plus partie de la distribution principale.

##### 10.1.10 2013

Disposition des ﬁchiers : le répertoire de premier niveau texmf/ a été fusionné avec texmf-dist par souci de simplicité. Les variables Kpathsea TEXMFMAIN et TEXMFDIST pointent désormais toutes les deux sur texmf-dist.

Plusieurs petites collections de langues ont été fusionnées entre elles aﬁn de simpliﬁer l’installation.

MetaPost :

  la gestion native des sorties en PNG, ainsi que des calculs en virgule ﬂottante (IEEE double-précision) ont été ajoutés.

LuaTeX :

  mis à jour vers Lua 5.2 et inclusion d’une nouvelle bibliothèque (pdfscanner) pour traiter le contenu de ﬁchiers PDF externes, ainsi que bien d’autres choses (voir ses pages Web).

XeTeX :

  (voir également ses pages Web pour plus de détails) :

  - la bibliothèque HarfBuzz est maintenant utilisée pour la composition des fontes au lieu d’ICU (qui reste utilisée pour la gestion des encodages d’entrée, la bidirectionnalité, et l’option de coupure de ligne d’Unicode).

  - Graphite2 et HarfBuzz sont utilisés à la place de SilGraphite pour la composition Graphite.

  - Sur Mac, Core Text est utilisé en remplacement d’ATSUI qui est déprécié.

  - Quand deux polices portent le même nom, la version OpenType/TrueType est choisie de préférence à la version Type 1.

  - Une diﬀérence possible entre les recherches de fontes de XeTeX et de dvipdfmx a été corrigée.

  - Gestion des incrustations (cut-ins) OpenType Math.

xdvi :

  utilise désormais FreeType plutôt que t1lib pour le rendu.

microtype.sty :

  entre autres améliorations, plus de fonctionnalités sous XeTeX (protrusion) et LuaTeX (protrusion, expansion de fontes, traking).

tlmgr :

  nouvelle action pinning pour faciliter la gestion de plusieurs dépôts de paquets; voir la section correspondante de `tlmgr --help`, par exemple en ligne : https://tug.org/texlive/doc/tlmgr.html#MULTIPLE-REPOSITORIES.

Plateformes :

  armhf-linux, mips-irix, i386-netbsd, et amd64-netbsd ajoutées ou ressuscitées, powerpc-aix enlevé.

##### 10.1.11 2014

2014 a vu un autre réglage TeX de la part de Knuth; cela aﬀecte tous les moteurs, mais le seul changement visible est probablement la restauration de la chaîne preloaded format sur la ligne bannière. Pour Knuth, elle reﬂète maintenant le format qui devrait être chargé par défaut, plutôt qu’un format non compilé réellement préchargé par le binaire. Cela peut être modiﬁé de multiples façons.

pdfTeX :

  nouveau paramètre \pdfsuppresswarningpagegroup d’avertissement de suppression; nouvelles primitives pour des espaces intermots factices aidant à la mise en forme du texte PDF : \pdfinterwordspaceon, \pdfinterwordspaceoff, \pdffakespace.

LuaTeX :

  des modiﬁcations et corrections notables ont été faites concernant le chargement des fontes et les césures. L’ajout le plus important est la nouvelle variante de moteur, luajittex et ses sœurs texluajit et texluajitc. Cela utilise un compilateur Lua à la volée (détaillé dans l’article du TUGboat https://tug.org/TUGboat/tb34-1/tb106scarso.pdf). luajittex est encore en développement, n’est pas disponible pour toutes les plateformes et est considérablement moins stable que luatex. Ni nous ni ses développeurs ne recommandons de l’utiliser, sauf à des ﬁns de tests avec jit sur du code Lua.

XeTeX :

  les mêmes formats d’images sont acceptés sur toutes les plateformes (dont Mac); éviter en Unicode les décompositions de compatibilité (mais pas les autres variantes); préférer les fontes OpenType aux fontes Graphite, par souci de compatibilité avec les versions précédentes de XeTeX.

MetaPost :

  un nouveau système numérique decimal est accepté, parallèlement à un compagnon interne numberprecision; une nouvelle déﬁnition de drawdot dans plain.mp, par Knuth; corrections de bugs dans les sorties SVG et PNG output, entre autres.

pstopdf :

  cet utilitaire ConTeXt sera retiré en tant que commande autonome à un certain moment après la sortie de la 2014, du fait de conﬂits avec des utilitaires de systèmes d’exploitation de même nom. Il peut encore (et doit désormais) être invoqué via mtxrun --script pstopdf.

psutils :

  a été substantiellement révisé par un nouveau mainteneur. De ce fait, plusieurs utilitaires rarement utilisés (fix*, getafm, psmerge, showchar) se trouvent désormais uniquement dans le répertoire scripts/ plutôt qu’au niveau des exécutables utilisateurs (cela est réversible si ça s’avérait problématique). Un nouveau script, psjoin, a été ajouté.

MacTeX :

  cette redistribution de la TeX Live (section 3.1.2) ne fournit plus les paquets optionnels propres à Mac pour Latin Modern et les fontes TeX Gyre puisqu’il est assez aisé pour les utilisateurs de les rendre accessibles au système. Le programme convert de ImageMagick a aussi été retiré, puisque TeX4ht (spéciﬁquement tex4ht.env) utilise maintenant Ghostscript directement.

langcjk :

  cette collection pour la prise en charge du chinois, du japonais et du coréen a été scindée en collections de langues individuelles par souci de modération de tailles.

Plateformes :

  x86_64-cygwin ajoutée, mips-irix supprimée; Microsoft ne maintient plus Windows XP donc nos programmes peuvent à tout moment commencer à être défaillants sur ce système.

##### 10.1.12 2015

LaTeX2e incorpore maintenant, par défaut, les changements jusqu’ici inclus uniquement en chargeant explicitement le paquet ﬁxltx2e, qui devient non opérationnel. Un nouveau paquet latexrelease et d’autres mécanismes permettent de contrôler ce qui se passe. Des détails se trouvent dans les documents inclus LaTeX News #22 et « LaTeX changes ». Incidemment, les paquets babel et psnfss, quoique parties intégrantes de LaTeX, sont maintenus séparément et ne sont pas aﬀectés par ces changements (et doivent continuer à fonctionner).

En interne, LaTeX2e maintenant inclut une conﬁguration de moteur concernant Unicode (quels caractères sont des lettres, noms des primitives, etc.) qui était auparavant une composante de la TeX Live. Ce changement est supposé invisible pour les utilisateurs; quelques commandes internes de bas niveau ont été renommées ou supprimées, mais le résultat devrait être le même.

pdfTeX :

  prend en charge Exif de JPEG ainsi que JFIF; n’émet même plus d’avertissement si \pdfinclusionerrorlevel est négatif; synchronisation avec xpdf 3.04.

LuaTeX :

  nouvelle librairie newtokenlib pour scanner les lexèmes; corrections de bugs dans le générateur de nombres aléatoires normal et à d’autres endroits.

XeTeX :

  corrections dans la manipulation d’images; binaire xdvipdfmx recherché en premier comme programme frère de xetex ; code opérationnel interne XDV modiﬁé.

MetaPost :

  nouveau système de nombres binary; nouvelle activation japonaise des programmes upmpost et updvitomp, analogues à up*tex.

MacTeX :

  mises à jour du paquet Ghostscript inclus pour la prise en charge CJK. Le panneau de préférence de la distribution TeX fonctionne maintenant sur Yosemite (macOS 10.10). Les valises de polices du type « ressources » (« resource-fork font suitcases »), qui ont des noms généralement sans extension, ne sont plus prises en charge par XeTeX; les valises de polices du type « data » (extension .dfont) continuent elles à l’être.

Infrastructure :

  le script fmtutil a été réimplémenté pour lire fmtutil.cnf sur une base « par arborescence », de façon analogue à updmap. Les scripts Web2C mktex* (dont mktexlsr, mktextfm, mktexpk) préfèrent maintenant les programmes dans leurs répertoires propres, plutôt que recourir systématiquement au PATH existant.

Plateformes :

  *-kfreebsd supprimé, puisque TeX Live est maintenant facilement disponible au travers des mécanismes de plateformes systèmes. Prise en charge pour quelques plateformes additionnelles disponibles en tant que binaires personnalisés ( https://tug.org/texlive/custom-bin.html). De plus, quelques plateformes sont désormais omises du DVD (simplement pour gagner de la place), mais peuvent être installées normalement depuis le réseau.

##### 10.1.13 2016

LuaTeX :

  modiﬁcations radicales concernant les primitives, à la fois renommées et supprimées, parallèlement à des réorganisations dans la structure des nœuds. Les changements sont résumés dans un article de Hans Hagen, « LuaTeX 0.90 backend changes for PDF and more » (https://tug.org/TUGboat/tb37-1/tb115hagen-pdf.pdf). Les détails se trouvent dans le manuel de LuaTeX, texmf-dist/doc/luatex/base/luatex.pdf.

METAFONT :

  MFlua et MFluajit, nouveaux programmes hautement expérimentaux qui intègrent Lua à Metafont(à ﬁns de tests).

MetaPost :

  corrections de bugs et préparations internes pour MetaPost 2.0.

pdfTeX :

  trois nouvelles primitives \pdfinfoomitdate, \pdfsuppressptexinfo, et \pdftrailerid, pour contrôler les valeurs apparaissant dans la sortie qui changent normalement à chaque exécution. Ces fonctionnalités ne concernent que les sorties PDF, et non les sorties DVI.

XeTeX :

  nouvelles primitives

  - \XeTeXhyphenatablelength,

  - \XeTeXgenerateactualtext,

  - \XeTeXinterwordspaceshaping,

  - \mdfivesum;

  augmentation de la limite de caractères de classe à 4096; identiﬁant byte du DVI incrémenté.

Autres utilitaires :

  - gregorio est un nouveau programme faisant partie du package gregoriotex dédié à la composition de partitions de chants grégoriens; il est par défaut inclus dans shell_escape_commands.

  - upmendex est un programme de création d’index, presque complètement compatible avec makeindex, proposant une prise en charge pour le classement Unicode, entre autres diﬀérences.

  - afm2tfm désormais ne fait des ajustements à la hausse que sur la base de la hauteur des accents; une nouvelle option -a omet tous les ajustements.

  - ps2pk peut traiter les fontes PK/GF étendues.

MacTeX :

  le panneau de préférence de la distribution a disparu; sa fonctionnalité se trouve désormais dans la « TeX Live Utility »; l’interface graphique utilisateur a été mise à jour; un nouveau script cjk-gs-integrate à lancer par les utilisateurs qui souhaitent incorporer diverses fontes CJK dans Ghostscript.

Infrastructure :

  ﬁchier de conﬁguration au niveau du système pris en charge; vériﬁcation des sommes de contrôle des packages; si GPG est disponible, vériﬁcation de la signature des mises à jour réseau (dans le cas contraire, les mises à jour se font comme par le passé).

Plateformes :

  alpha-linux et mipsel-linux supprimées.

##### 10.1.14 2017

LuaTeX :

  davantage de « callbacks » 4, de contrôle de composition, d’accès aux fonctions internes; bibliothèque ffi pour un chargement dynamique de code ajoutée à certaines plateformes.

pdfTeX :

  variable d’environnement `SOURCE_DATE_EPOCH_TEX_PRIMITIVES` de l’an passé renommée en `FORCE_SOURCE_DATE` sans changement de fonctionnalité; si la liste de lexèmes \pdfpageattr contient la chaîne /MediaBox, omission de la sortie par défaut /MediaBox.

XeTeX :

  mathématiques Unicode/OpenType maintenant basées sur le prise en charge de la table MATH HarfBuzz’s; quelques corrections de bogues.

Dvips :

  le « special » de taille de papier pris en compte est le dernier stipulé, par cohérence avec dvipdfmx et avec ce qu’attendent les extensions; l’option -L0 (conﬁguration L0) restaure le comportement précédent en ce qui concerne le premier « special » pris en compte.

epTeX, eupTeX :

  nouvelles primitives provenant de pdfTeX :

  - \pdfuniformdeviate;

  - \pdfnormaldeviate;

  - \pdfrandomseed;

  - \pdfsetrandomseed;

  - \pdfelapsedtime;

  - \pdfresettimer.

MacTeX :

  à compter de cette année, seules les versions de macOS pour lesquelles Apple fournit encore des mises à jour de sécurité seront prises en charge dans la MacTeX, sous le nom de plateforme `x86_64-darwin`; actuellement, cela recouvre les versions Yosemite, El Capitan et Sierra (10.10 et suivantes). Les binaires pour les versions plus anciennes de macOS ne sont pas incluses dans la MacTeX mais sont toujours disponibles dans la TeX Live (`x86_64-darwinlegacy`, i386-darwin, powerpc-darwin).

Infrastructure :

  par défaut, l’arborescence TEXMFLOCAL est maintenant cherchée avant les arborescences TEXMFSYSCONFIG et TEXMFSYSVAR; le but est de correspondre davantage à ce qui est attendu par les ﬁchiers locaux destinés à prendre le pas sur les ﬁchiers système. De plus, tlmgr a un nouveau mode shell pour un usage interactif et via des scripts, et une nouvelle action conf auxtrees permettant de facilement ajouter et supprimer des arborescences supplémentaires.

updmap et fmtutil :

  ces scripts émettent désormais un avertissement quand ils sont invoqués sans que soient spéciﬁés

  - soit le mode dit « système » (updmap-sys, fmtutil-sys ou option -sys);

  - soit le mode « utilisateur » (updmap-user, fmtutil-user ou option -user).

  Le but est de réduire le problème récurrent consistant à invoquer par accident le mode utilisateur et ainsi perdre les mises à jour système ultérieures. Cf. https://tug.org/texlive/scripts-sys-user.html pour plus de détails.

install-tl :

  les arborescences personnelles telles que TEXMFHOME sont désormais ﬁxées sur Mac aux valeurs par défaut (`~/Library/...`). Nouvelle option -init-from-profile pour démarrer une installation avec des valeurs ﬁxées par un proﬁl donné; nouvelle commande P pour explicitement sauvegarder un proﬁl; nouveaux noms de variable de proﬁl (mais les précédents sont toujours acceptés).

SyncTeX :

  l’extension du nom du ﬁchier temporaire est désormais .synctex(busy), et non plus .synctex.gz(busy) (absence de .gz). Les interfaces graphiques et systèmes de compilation qui veulent supprimer les ﬁchiers temporaires peuvent devoir ajuster en conséquence.

Autres utilitaires :

  texosquery-jre8 est un programme multi-plateforme nouveau permettant de retrouver la « locale » et autres informations du système d’exploitation depuis un document TeX; il est par défaut inclus dans les `shell_escape_commands` autorisant les exécutions shell restreintes. (Les anciennes versions de JRE sont prises en charge par texosquery, mais ne peuvent être activées en mode restreint car elles ne sont plus prises en charge par Oracle, même pour des problèmes de sécurité.)

Plateformes :

  cf. entrée MacTeX ci-dessus; pas d’autres changements.

##### 10.1.15 2018

Kpathsea :

  par défaut, la recherche est désormais insensible à la casse, et ce pour tous les répertoires. Pour désactiver cette fonctionnalité, il faut changer texmf.cnf ou donner à la variable d’environnement texmf_casefold_search la valeur 0. Vous trouverez tous les détails nécessaires dans le manuel de Kpathsea ( https://tug.org/kpathsea).

epTeX, eupTeX :

  nouvelle primitive \epTeXversion.

LuaTeX :

  préparation de la migration vers LuaTeX 5.3 en 2019 : un exécutable luatex53 est désormais disponible pour la plupart des architectures, mais doit être renommé en luatex pour être utilisé. Il est également possible d’utiliser les ﬁchiers de ConTeXt Garden (https://wiki.contextgarden.net) en suivant les informations fournies par ledit site.

MetaPost :

  rustines corrigeant les chemins erronés, sorties TFM et PNG.

pdfTeX :

  possibilité de coder des vecteurs pour fontes bitmap; le titre des ﬁchiers PDF ne fait plus mention de leur répertoire; rustines pour \pdfprimitive et ﬁchiers y aﬀérant.

XeTeX :

  la fonction /Rotate est désormais utilisable lors de l’inclusion d’un ﬁchier PDF; code de retour d’erreur non nul si le pilote de sortie échoue; plusieurs rustines subtiles concernant l’UTF-8 et autres primitives.

MacTeX :

  voir les changements de prise en charge de version ci-dessous. De surcroît, et pour plus de limpidité, les ﬁchiers installés par MacTeX dans le dossier /Applications/TeX/ ont subi une réorganisation; ce dossier contient désormais, au premier niveau, quatre applications graphiques (BibDesk, LaTeXiT, TeX Live Utility, et TeXShop) ainsi que des dossiers comprenant les utilitaires additionnels et la documentation.

tlmgr :

  nouvelles applications graphiques tlshell (rédigée en Tcl/Tk) et tlcockpit (rédigée en Java); sortie JSON; uninstall est désormais synonyme de remove; nouvelle commande/option print-platform-info.

Architectures :

  - deux suppressions : armel-linux et powerpc-linux.

  - Mac :

    - x86_64-darwin prend en charge 10.10–10.13 (Yosemite, El Capitan, Sierra et High Sierra).

    - x86_64-darwinlegacy prend en charge 10.6–10.10 (mais x86_64-darwin est préférable pour 10.10). 10.5 (Leopard) n’est plus pris en charge, ce qui implique que powerpc-darwin et les architectures i386-darwin ne le sont également plus.

  - Windows : XP n’est désormais plus pris en charge.

##### 10.1.16 2019

Kpathsea :

  expansion d’accolades et découpage de chemin plus cohérent; nouvelle variable TEXMFDOTDIR au lieu du . codé en dur dans les chemins : permet de facilement rechercher des répertoires additionnels ou inclus (cf. commentaires dans le ﬁchier texmf.cnf).

epTeX, eupTeX :

  nouvelles primitives \readpapersizespecial et \expanded.

LuaTeX :

  Lua 5.3 désormais utilisé, avec les changements concomitants de l’arithmétique et de l’interface. La librairie propre pplib est utilisée pour lire les ﬁchiers PDF, éliminant ainsi la dépendance de poppler (et la nécessité de C++); interface Lua modiﬁée en conséquence.

MetaPost :

  nom de commande r-mpost reconnu comme un alias pour l’invocation avec l’option --restricted, et ajout à la liste des commandes restreintes disponibles par défaut. Précision minimale désormais 2 pour les modes décimal et binaire. Mode binaire désormais indisponible avec MPlib, mais toujours disponible avec MetaPost autonome.

pdfTeX :

  nouvelle primitive \expanded; si le nouveau paramètre de primitive \pdfomitcharset est ﬁxé à 1, la chaîne /CharSet est supprimée de la sortie PDF, car il est impossible de garantir qu’elle soit correcte, ce qui est requis par PDF/A-2 et PDF/A-3.

XeTeX :

  - nouvelles primitives :

    - \expanded;

    - \creationdate;

    - \elapsedtime;

    - \filedump;

    - \filemoddate;

    - \filesize;

    - \resettimer;

    - \normaldeviate;

    - \uniformdeviate;

    - \randomseed;

  - \Ucharcat étendu pour produire des caractères actifs.

tlmgr :

  prise en charge de curl comme programme de téléchargement; si disponibles, utilise lz4 et gzip avant xz pour les sauvegardes locales; en ce qui concerne les programmes de compression et de téléchargement, priorité aux exécutables fournis par le système d’exploitation sur ceux fournis par la TeX Live, à moins que la variable d’environnement TEXLIVE_PREFER_OWN soit conﬁgurée.

install-tl :

  la nouvelle option -gui (sans argument) est celle par défaut sous Windows et Mac, et invoque une nouvelle interface graphical Tcl/TK GUI (voir sections 1.3 et 3.1.6).

Utilitaires :

  cwebbin (https://ctan.org/pkg/cwebbin)

    est désormais l’implémentation CWEB dans la TeX Live, avec une prise en charge élargie des dialectes, et incluant le programme ctwill permettant de créer des mini-index.

  chkdvifont :

    rapporte les informations de fontes fournies par les ﬁchiers DVI, y compris les fontes tfm/ofm, vf, gf, pk.

  dvispc :

    crée un ﬁchier DVI indépendant des pages vis-à-vis des « specials ».

MacTeX :

  x86_64-darwin prend en charge désormais les systèmes 10.12 et plus (Sierra, High Sierra, Mojave); x86_64-darwinlegacy prend en charge encore les systèmes 10.6 et plus. Le correcteur orthographique Excalibur n’est plus inclus puisqu’il requiert la prise en charge des architectures 32 bit.

Architectures :

  sparc-solaris supprimée.

##### 10.1.17 2020

Général :

  - Dans tous les moteurs TeX, y compris tex, la primitive \input accepte désormais également un argument de nom de ﬁchier délimité par groupe, en tant que extension dépendant du système. L’utilisation avec un nom de ﬁchier délimité par un espace/token est totalement inchangée. La délimitation par groupe était auparavant implémentée dans LuaTeX; maintenant, elle est disponible dans tous les moteurs. Les doubles guillemets ASCII (") sont supprimés du nom de ﬁchier, mais ils restent inchangés après tokenisation. Cela n’aﬀecte actuellement pas la commande \input de LaTeX, car c’est une redéﬁnition de macro de la primitive standard \input.

  - Nouvelle option --cnf-line pour kpsewhich, tex, mf, et tous les autres moteurs, pour prendre en charge une conﬁguration arbitraire en ligne de commande.

  - L’ajout de diverses primitives à divers moteurs cette année et les précédentes est destiné à aboutir à un ensemble commun de fonctionnalités disponible sur tous les moteurs (LaTeX News #31, https://latex-project.org/news).

epTeX, eupTeX :

  plusieurs nouvelles primitives, principalement pour la prise en charge inter-moteurs : \Uchar, \Ucharcat, \current(x)spacingmode, \ifincsname; également, révision de \fontchar?? et \iffontchar. Pour eupTeX uniquement : \currentcjktoken.

LuaTeX :

  intégration avec la bibliothèque HarfBuzz, disponible sous forme de nouveaux moteurs luahbtex (utilisé pour lualatex) et luajithbtex. Nouvelles primitives : \eTeXgluestretch, \eTeXglueshrink.

pdfTeX :

  nouvelle primitive \pdfmajorversion; cela ne fait que changer le numéro de version dans la sortie PDF; ça n’a aucun eﬀet sur le contenu du PDF. \pdfximage et similaires recherchent maintenant les ﬁchiers images de la même manière que \openin.

pTeX :

  nouvelles primitives : \ifjfont, \iftfont. Aussi dans epTeX, upTeX, eupTeX.

XeTeX :

  corrections pour \Umathchardef, \XeTeXinterchartoks, \pdfsavepos.

Dvips :

  codages de sortie pour les polices bitmap, pour de meilleures capacités de copier/coller ( https://tug.org/TUGboat/tb40-2/tb125rokicki-type3search.pdf).

MacTeX :

  MacTeX et x86_64-darwin requièrent désormais la version 10.13 ou plus élevé de Mac OS (High Sierra, Mojave et Catalina); x86_64-darwinlegacy prend en charge 10.6 et plus récent. MacTeX est certiﬁé et les programmes en ligne de commande ont des « lancements renforcés » (hardened runtimes), comme maintenant requis par Apple pour l’installation des paquets. BibDesk et TeX Live Utility ne sont pas dans MacTeX parce qu’ils ne sont pas certiﬁés, mais un ﬁchier README donne la liste des URL où ils peuvent être obtenus.

x86_64-darwinlegacy :

  abandon de la prise en charge de X11, y compris xdvi.

tlmgr et infrastructure :

  - Réessayer automatiquement (une fois) les téléchargements de paquets qui ont échoué.

  - Nouvelle option tlmgr check texmfdbs, pour vériﬁer pour chaque arborescence la cohérence des ﬁchiers ls-R et !!.

  - Utilisation des noms de ﬁchiers versionnés pour les conteneurs de paquets, comme dans : tlnet/archive/pkgname.rNNN.tar.xz. Cela devrait être invisible pour les utilisateurs, mais c’est un changement notable dans la distribution.

  - Les informations catalogue-date ne sont plus propagées à partir du catalogue TeX car il n’était souvent pas lié aux mises à jour des paquets.

##### 10.1.18 2021

Général :

  - Les modiﬁcations apportées par Donald Knuth pour la mise au point 2021 de TeX et Metafont sont incorporées (https://tug.org/TUGboat/tb42-1/tb130knuth-tuneup21.pdf). Elles sont également disponibles sur le CTAN sous les packages knuth-dist et knuth-local. Comme prévu, les corrections concernent des cas obscurs et n’aﬀectent rien en pratique.

  - (Sauf dans l’original TeX.) Si \tracinglostchars est réglé sur 3 ou de plus, les caractères manquants n’entraîneront pas seulement un message dans le ﬁchier journal, mais une erreur et le code de caractère manquant sera aﬃché en hexadécimal.

  - (Sauf dans l’original TeX.) Nouveau paramètre entier \tracingstacklevels qui, si positif ainsi que \tracingmacros, provoque un préﬁxe indiquant la profondeur de la macro-expansion à sortir sur chaque ligne de journal pertinente (par exemple, `~..` à la profondeur 2). En outre, l’enregistrement des macros est tronqué à une profondeur ≥ la valeur du paramètre.

Aleph :

  Le format LaTeX basé sur Aleph, appelé lamed, a été supprimé. Le binaire aleph lui-même est toujours inclus et pris en charge.

LuaTeX :

  - Lua 5.3.6.

  - Callback pour les niveaux imbriqués dans \tracingmacros, en tant que variante généralisée des nouveaux \tracingstacklevels.

  - Marque les glyphes mathématiques comme étant protégés pour éviter qu’ils ne soient traités comme du texte.

  - Suppression de la compensation width/ic pour le chemin de code mathématique traditionnel.

MetaPost :

  - `SOURCE_DATE_EPOCH` : prise en charge de variable d’environnement pour une sortie reproductible.

  - Évite un mauvais % ﬁnal dans mpto.

  - Documente l’option -T; autres corrections au manuel.

  - Valeur de epsilon modiﬁée en modes binaire et décimal, de sorte que la fonction `mp_solve_rising_cubic` fonctionne comme prévu.

pdfTeX :

  - Nouvelles primitives \pdfrunninglinkoff et \pdfrunninglinkon; par exemple pour désactiver la génération de liens dans les en-têtes et les pieds de page.

  - Avertir au lieu d’interrompre quand « cspdfendlink ended up in diﬀerent nesting level than \pdfstartlink ».

  - Dump des assignations \pdfglyphtounicode dans le ﬁchier fmt.

  - Source : prise en charge de poppler supprimé car il était trop diﬃcile de rester en phase avec l’original. Dans la TL native, pdfTeX a toujours utilisé libs/xpdf, qui est un code réduit et adapté de xpdf.

XeTeX :

  Corrections pour le crénage mathématique.

Dvipdfmx :

  - Ghostscript est maintenant par défaut invoqué en toute sécurité; pour outrepasser cela (supposant ainsi que tous les ﬁchiers d’entrée sont ﬁables), utilisez `-i dvipdfmx-unsafe.cfg`.

    Attention! Pour utiliser PSTricks avec XeTeX, cette dernière option est nécessaire. Ainsi, avec un ﬁchier foo.tex qui contient du code PSTricks, vous devez lancer :

    `xetex -output-driver="xdvipdfmx -i dvipdfmx-unsafe.cfg -q -E" foo`

  - Si un ﬁchier image n’est pas trouvé, interruption avec un statut « mauvais ».

  - Syntaxe spéciale étendue pour la prise en charge des couleurs.

  - Specials pour la manipulation de `ExtGState`.

  - Compatibilité des specials pdfcolorstack et pdffontattr.

  - Prise en charge expérimentale pour les `fnt_def` étendus de dviluatex.

  - Prise en charge d’une nouvelle fonctionnalité de la police virtuelle pour la déﬁnition de la police japonaise.

Dvips :

  - Le titre du document PostScript par défaut est maintenant le nom de base du ﬁchier d’entrée et peut être remplacé par la nouvelle option -title.

  - Si un .eps ou un autre ﬁchier image n’est pas trouvé, interruption avec un statut « mauvais ».

  - Prise en charge de la nouvelle fonctionnalité de la police virtuelle comme solution de repli sur la déﬁnition de la police japonaise.

MacTeX :

  MacTeX et son nouveau dossier binaire universal-darwin nécessitent maintenant macOS 10.14 ou plus (Mojave, Catalina, et Big Sur); le dossier binaire `x86_64-darwin` n’est plus présent. Le dossier binaire `x86_64-darwinlegacy`, disponible uniquement avec l’installateur Unix install-tl, prend en charge les versions 10.6 et plus récentes.

  C’est une année importante pour le Macintosh car Apple, qui a introduit les processeurs ARM en novembre, vendra et prendra en charge pendant de nombreuses années des processeurs à la fois ARM et Intel. Tous les programmes dans universal-darwin ont un code exécutable pour ARM et Intel. Les deux binaires sont compilés à partir du même code source.

  Les programmes supplémentaires Ghostscript, LaTeXiT, TeX Live Utility et TeXShop, tous universels et signés avec un « lancement renforcé » (hardened runtime), sont inclus dans MacTeX cette année.

tlmgr et l’infrastructure :

  - Une seule sauvegarde du dépôt principal texlive.tlpdb est conservée.

  - Davantage de portabilité entre les systèmes et les versions Perl.

  - tlmgr info signale les nouveaux lcat-* et rcat-* pour les données du catalogue local ou distant.

  - Enregistrement complet des sous-commandes transféré dans un nouveau ﬁchier journal texmf-var/web2c/tlmgr-commands.log.

##### 10.1.19 2022

Général :

  - Nouveau moteur hitex, qui produit son propre format HINT, conçu spécialement pour la lecture de documents techniques sur des appareils mobiles. Les visionneurs HINT pour GNU/Linux, Windows et Android sont disponibles séparément de TeX Live.

  - tangle, weave : prise en charge d’un troisième argument facultatif pour spéciﬁer le ﬁchier de sortie.

  - twill, le programme de Knuth permettant de créer des mini-index pour les programmes WEB originaux, est maintenant inclus.

Extensions inter-moteurs :

  (sauf dans les versions originales TeX, Aleph et hiTeX)

  - Nouvelle primitive \showstream pour rediriger la sortie \show vers un ﬁchier.

  - Les nouvelles primitives \partokenname et \partokencontext permettent de modiﬁer le nom du lexème \par émis aux lignes vides, à la ﬁn des « vboxes », etc.

epTeX, eupTeX :

  - Nouvelles primitives :

    - \lastnodefont;

    - \suppresslongerror;

    - \suppressoutererror;

    - \suppressmathparerror.

  - extension pdfTeX \vadjust pre maintenant disponible.

LuaTeX :

  - Prise en charge des destinations structurées à partir de PDF 2.0.

  - PNG /Smask pour PDF 2.0.

  - Interface de police variable pour luahbtex.

  - Diﬀérents styles de radicaux par défaut dans mathdefaultsmode.

  - Blocage optionnel de la création discrétionnaire sélectionnée.

  - Améliorations de l’implémentation des polices TrueType.

  - Allocation plus eﬃcace des \fontdimen.

  - Paragraphes comportant uniquement un nœud par local suivi de nœuds de synchronisation de direction ignorés.

MetaPost :

  Correction d’un bogue relatif à l’expansion inﬁnie des macros.

pdfTeX :

  - Prise en charge des destinations structurées à partir de PDF 2.0.

  - Pour les polices à espacement de lettres, usage explicite de \fontdimen6 si spéciﬁé.

  - Tous les avertissements commencent en début de ligne.

  - Pour les caractères avec autokern (\pdfappendkern et \pdfprependkern), faites toujours la protrusion; de même, autokern implicite et explicite des traits d’union.

pTeX et al. :

  - Mise à jour majeure de pTeX vers la version 4.0.0 pour mieux prendre en charge la version actuelle de LaTeX.

  - Nouvelles primitives \ptexlineendmode et \toucs.

  - \ucs (auparavant disponible dans uptex, euptex) désormais disponible également dans pTeX et epTeX.

  - Distinction des caractères 8 bit et des caractères japonais, comme indiqué dans un article du TUGboat rédigé par Hironori Kitagawa ( https://tug.org/TUGboat/tb41-3/tb129kitagawa-char.pdf).

XeTeX :

  xetex-unsafe et xelatex-unsafe, nouveaux scripts enveloppants (« wrappers ») pour une invocation plus simple des documents nécessitant à la fois XeTeX et les opérateurs de transparence PSTricks, ce qui est intrinsèquement dangereux (jusqu’à ce que la réimplémentation dans Ghostscript ait lieu). Par mesure de sécurité, utilisez plutôt Lua(LA)TeX.

Dvipdfmx :

  - Prise en charge de PSTricks sans nécessité de recourir à -dNOSAFER, sauf pour la transparence.

  - Option -r permettant de déﬁnir la résolution des polices bitmap à nouveau fonctionnelle.

Dvips :

  Par défaut, pas de tentative d’ajustement automatique de la prise en charge pour les formats de papier pivotés; la nouvelle option --landscaperotate l’active à nouveau.

upmendex :

  Prise en charge expérimentale des écritures arabe et hébraïque; amélioration de la classiﬁcation des caractères et de la prise en charge des langues.

Kpathsea :

  Le premier chemin renvoyé par kpsewhich -all est maintenant le même qu’avec une recherche régulière (non « -all »).

tlmgr et infrastructure :

  - Utilisation par défaut de https pour mirror.ctan.org.

  - utilisation de TEXMFROOT à la place de SELFAUTOPARENT pour faciliter la relocalisation.

  - install-tl : si le téléchargement ou l’installation échoue pour un package donné, poursuite automatique de l’installation avec nouvel essai ultérieur (unique).

MacTeX :

  MacTeX et son dossier binaire universal-darwin nécessitent macOS 10.14 ou supérieur (Mojave, Catalina, Big Sur, Monterey). Le dossier binaire `x86_64-darwinlegacy`, disponible uniquement avec le install-tl d’Unix, prend en charge les versions 10.6 (Snow Leopard) et plus récentes.

Plateformes :

  Aucun changement dans la prise en charge des plateformes pour cette année (2022). Cependant, pour la version de l’année prochaine (2023), nous prévoyons de faire passer les binaires Windows de 32 à 64 bit. Malheureusement, nous ne pouvons pas prendre en charge les deux simultanément.

##### 10.1.20 2023

Windows :

  Comme annoncé précédemment, TeX Live contient maintenant des binaires Windows 64 bit au lieu de 32 bit. Le nouveau nom du répertoire est bin/windows (il ne semblait pas correct de mettre les binaires 64 bit dans un répertoire nommé « 32 »). Nous savons que cela entraînera un surcroît de travail pour les utilisateurs de Windows, mais il n’y avait pas de meilleure solution. Si vous avez besoin de la prise en charge de Windows 32 bits, vous devrez installer TeX Live 2022. À partir de Windows 11, Windows sur ARM prend en charge l’émulation des AMD/Intel 64-bit et peut donc utiliser la TeX Live actuelle. Cependant, Windows 10 sur ARM ne peut pas émuler Intel/AMD 64-bit, et aura donc besoin d’un TeX Live 32-bit. Voir la page web TeX Live Windows ( https://tug.org/texlive/windows.html).

Extensions inter-moteurs 5 :

  \special suivi d’un nouveau mot-clé « shipout » retarde l’expansion des tokens de l’argument jusqu’au moment \shipout, comme avec un non-`\immediate\write`.

epTeX, eupTeX :

  - « Raw » (u)ptex n’est plus construit; (u)ptex fonctionne maintenant dans le mode de compatibilité d’e(u)ptex. Idem pour les outils pTeX, listés ci-dessous.

  - Nouvelles primitives : \tojis, \ptextracingfonts, \ptexfontname.

  - Pour \font, la nouvelle syntaxe pour JIS/UCS est prise en charge.

LuaTeX :

  - nouvelle primitive \variablefam pour permettre aux caractères mathématiques de conserver leur classe tout en laissant la famille s’adapter.

  - amélioration des zones d’annotation r2l

  - « \special retardé » inter-moteurs décrit ci-dessus.

  - dans LuaTeX 1.17.0, publié en mai 2023 : la bibliothèque socket est maintenant désactivée par défaut; une nouvelle option de ligne de commande --socket l’active, ainsi que --shell-escape (et non --shell-restricted. De plus, la bibliothèque `mime` est maintenant toujours disponible, et les nouvelles fonctions os.socketsleep et os.socketgettime sont également toujours disponibles. Enﬁn, certaines façons obscures de contourner diverses fonctionnalités de sécurité ont été corrigées.

MetaPost :

  Correction de bogues. svg->dx et svg->dy sont maintenant double, pour une meilleure précision; `mp_begin_iteration` mis à jour; fuite de mémoire dans mplib corrigée.

pdfTeX :

  - nouvelle primitive \pdfomitinfodict pour omettre complètement le dictionnaire /Info.

  - nouvelle primitive \pdfomitprocset pour contrôler l’omission du tableau /ProcSet : /ProcSet est inclus si ce paramètre est négatif, ou si ce paramètre est zéro et que pdftex génère une sortie PDF 1.x.

  - avec \pdfinterwordspaceon, si l’encodage de la police actuelle possède un caractère /space à l’emplacement 32, il est utilisé; sinon, le /space de la (nouvelle) police par défaut pdftexspace est utilisé. Cette police par défaut peut être remplacée par la nouvelle primitive \pdfspacefont. Cette même nouvelle procédure est utilisée pour \pdffakespace.

pTeX et al. :

  - Comme mentionné ci-dessus, ptex exécute maintenant eptex en mode de compatibilité au lieu d’être construit séparément.

  - Les outils pTeX (pbibtex, pdvitype, ppltotf, ptftopl) ont été fusionnés en versions upTeX correspondantes, fonctionnant en mode de compatibilité.

XeTeX :

  correction :

  - du calcul de \topskip et \splittopskip lorsque \XeTeXupwardsmode est actif;

  - de « \special retardé » décrit ci-dessus.

Dvipdfmx :

  nouvelle option --pdfm-str-utf8 pour créer un « pdfmark » et/ou un signet.

BibTeXu :

  - Cette variante de BibTeX est principalement compatible avec BibTeX, avec une bien meilleure prise en charge multilingue (basé sur Unicode). Elle est présente dans TeX Live depuis quelques années.

  - Cette année, des fonctionnalités supplémentaires ont été ajoutées pour la prise en charge des langues CJK, dont certaines ont été étendues à partir du programme japonais (u)pbibtex et d’autres programmes.

Kpathsea :

  Prise en charge de l’encodage des ﬁchiers d’entrée pour les plates-formes Unix, comme sous Windows; activé pour (e)p(la)tex, pbibtex, mendex.

tlmgr et infrastructure :

  - l’interface texte par défaut sur macOS;

  - installer les paquets de base en premier, réessayer les autres paquets une fois;

  - vériﬁcation simpliste eﬀectuée pour savoir si l’espace disque est suﬃsant.

MacTeX :

  - MacTeX et son dossier binaire universal-darwin nécessitent macOS 10.14 ou supérieur (Mojave, Catalina, Big Sur, Monterey, Ventura). Le dossier binaire x86_64-darwinlegacy, disponible uniquement avec le programme Unix install-tl, prend en charge les versions 10.6 (Snow Leopard) et ultérieures.

  - Le package GUI de MacTeX contient désormais hintview, un visualisateur macOS pour les documents HINT (créés par les programmes hitex et hilatex pour les appareils mobiles; voir la page Web HiTeX, https://hint.userweb.mwn.de/hint/hitex.html). Le package GUI n’installe plus de dossier de documents, il les remplace par un bref READ ME pour les nouveaux utilisateurs et une page sur hintview.

  - Le dossier Extras de logiciels TeX supplémentaires sur le DVD a été remplacé par un document contenant des liens vers des sites de téléchargement.

Plates-formes :

  - Comme mentionné ci-dessus, le nouveau répertoire binaire windows contient les binaires Windows 64 bit, et

  - le répertoire binaire bin/win32 a disparu, puisque nous ne pouvons pas prendre en charge Windows 32 bit et 64 bit simultanément.

  - Le répertoire binaire i386-cygwin a disparu, car Cygwin ne ne prend plus en charge i386.

#### 10.2 Présent : 2024

Changements inter-moteurs (sauf TeX d’origine, e-TeX et LuaTeX) :

  - Éviter les plantages lors de l’utilisation détournée des accolades \output et \write.

  - Petite optimisation de la boucle interne.

  (Ces deux changements sont dus à David Fuchs.)

LuaTeX :

  - Les vériﬁcations au niveau de Lua pour l’écriture dans les ﬁchiers sont maintenant similaires aux vériﬁcations au niveau de TeX.

  - Si la valeur Lua texconfig.trace_extra_newline est déﬁnie, des lignes vierges sont aﬃchées dans le journal entre les paramètres de la macro. En 2020–2023, c’était le cas par défaut; avant cela, de telles lignes vides n’étaient jamais aﬃchées, ce qui est le comportement des autres moteurs.

MetaPost :

  La bibliothèque MPFI est maintenant incluse pour l’arithmétique d’intervalle; activée avec --numbersystem=interval.

pdfTeX :

  - Extraction de texte plus ﬁable sur les systèmes BigEndian.

  - Davantage de vériﬁcations concernant les ﬁchiers pfb, fmt, pdf corrompus.

  - Écriture d’un pdf corrompu évitée en cas d’inclusions pdf inhabituelles.

  - Manuel converti en LaTeX et révisé en profondeur, bien que les mises à jour substantielles soient minimales.

epTeX, eupTeX :

  - Nouvel utilitaire de conversion de codage simple ptekf.

  - Construction de eptex désormais plus séparée; il fonctionne dans le mode d’encodage hérité de euptex.

XeTeX :

  Les caractères Unicode autres que BMP dans les noms de ﬁchiers sont pris en charge.

Dvipdfmx :

  - Calcul du décalage de fuseau horaire identique à celui de pdfTeX.

  - Gestion des sélecteurs de variation pour tenir compte de la nouvelle CMap Adobe-Japan1-UCS2.

  - Solution de repli des caractères multi-octets dans les polices virtuelles vers les polices OFM pour (u)pTeX.

Kpathsea :

  - Prise en charge d’une vériﬁcation étendue des noms de ﬁchiers sûrs qui permet également d’écrire sous TEXMF[SYS]VAR, pour Lua(LA)TeX; nouvelles fonctions et options kpsewhich correspondantes.

  - Prise en charge d’une nouvelle variable TEXMF_OUTPUT_DIRECTORY (à côté de la traditionnelle TEXMFOUTPUT), de sorte que les sous-programmes puissent avoir accès à un paramètre --output-directory lors d’une invocation du moteur.

CWEB :

  - Prise en charge de LuaTeX en tant que moteur TeX dorsal (back-end).

  - Correction d’un dépassement de tampon sur les lignes sans point d’arrêt.

tlmgr :

  - Nouvelle action bug pour aider à trouver des informations sur les rapports de bogues.

  - Utilisation de notre propre paquet de certiﬁcats racine sur toutes les plateformes, pour prendre en charge LWP plus largement, notamment sur macOS.

  - Détection d’un dépôt distant plus ancien que l’installation locale (c’est-à-dire un miroir périmé), et alors prévention de la mise à jour, aﬁn d’éviter les suppressions incorrectes de paquets.

  - Prise en charge du paramètre de taille de papier ConTeXt.

  - Élagage des sauvegardes des ﬁchiers tlpdb pour les dépôts miroirs (main et tlcontrib).

MacTeX :

  contient maintenant la dernière version de Ghostscript 10.02.1, les mises à jour des quatre programmes d’interface graphique, ainsi que (comme toujours) tous les nouveaux changements de TeX Live. Les binaires sont toujours compatibles avec macOS 10.14 (Mojave, 2018) et les versions ultérieures. (Comme d’habitude, les versions antérieures de Mac sont prises en charge par les binaires x86_64-darwinlegacy, qui font partie de TeX Live, mais pas MacTeX).

#### 10.3 Versions futures

Nous prévoyons de continuer à produire de nouvelles versions et aimerions fournir plus de documentation, plus d’applications, une arborescence améliorée et vériﬁée de macros et de fontes... et tout ce qui concerne TeX. Ce travail est eﬀectué par des volontaires sur leur temps libre, et il y a toujours plus à faire. Si vous pouvez nous aider, n’hésitez pas à nous contacter (cf. https://tug.org/texlive/contribute.html).

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

> tex-live@tug.org (il n’est pas nécessaire de s’abonner pour pouvoir poster)
> https://tug.org/texlive

Bon travail avec TeX!

∗Précédentes versions françaises par Manuel Pégourié-Gonnard, Daniel Flipo, Éric Picheral, Jacques André, Fabrice Popineau et peut-être d’autres avant eux — qu’ils en soient tous remerciés. Nos remerciements aussi aux aimables relecteurs; nous sommes bien sûr responsables des erreurs restantes. N’hésitez pas à les signaler par mail à denis.bitouze@univ-littoral.fr!

1. Si vous utilisez un système Mac, il vous faut utiliser l’application « Terminal » pour avoir accès à l’émulateur de commandes. Sur systèmes Windows, il vous faut taper Win-R puis cmd. Enﬁn, si vous utilisez un système de type Unix, il est vraisemblable que vous sachiez déjà comment utiliser cette commande.

2. Vraisemblablement TEXLIVE_INSTALL_PREFIX ou TEXLIVE_INSTALL_TEXDIR.

3. En supposant que ces TeX Live ont été installées dans le dossier /usr/local/texlive/, sous-dossiers respectivement 2023 et 2024.

4. N.d.T. : fonctions de rappel

5. Sauf dans les versions originales TeX et e-TeX.