diff options
Diffstat (limited to 'Master/texmf-dist/doc/texlive/texlive-fr/texlive-fr.tex')
-rw-r--r-- | Master/texmf-dist/doc/texlive/texlive-fr/texlive-fr.tex | 3653 |
1 files changed, 3653 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/texlive/texlive-fr/texlive-fr.tex b/Master/texmf-dist/doc/texlive/texlive-fr/texlive-fr.tex new file mode 100644 index 00000000000..b37ad2475af --- /dev/null +++ b/Master/texmf-dist/doc/texlive/texlive-fr/texlive-fr.tex @@ -0,0 +1,3653 @@ +% $Id$ +% +% French translation of the TeX Live documentation. +% See ../texlive-en for original version. +% This translation is released under the terms of the WTFPL v2. +% +% Last update based on ../texlive-en/texlive-en.tex r26703 +% +% Change history (started May 18th 2002) +% 2009/09/21: synced with 2009 English version, by Manuel Pégourié-Gonnard +% 2008/07/26: synced with 2008 English version, by Daniel Flipo +% 2007/01/18: synced with 2007 English version, by Daniel Flipo +% 2005/11/01: synced with 2005 English version, by Daniel Flipo +% 2005/05/05: re-added section on building binaries (Daniel Flipo) +% 2004/10/28: synced with 2004 English version, by Daniel Flipo +% 2003/08/28: synced with 2003 English version, by Éric Picheral & Jacques André +% 2002/05/25: proof-reading and corrections, by Daniel Flipo +% 2002/05/18: synced with English version, by Fabrice + +\documentclass{article} + +\usepackage[utf8]{inputenc} +\usepackage[T1]{fontenc} +\let\tldocfrench=1 % pour live4ht.cfg (ou en fait inutilisé?) (mpg) + +\usepackage[english, frenchb]{babel} +\usepackage{xspace} +\frenchbsetup{AutoSpacePunctuation=false, og=«, fg=»} + +\usepackage{tex-live} + +% Francisation de tex-live.sty (df) +\renewcommand{\samp}[1]{\og \texttt{#1}\fg{}} +% (df) La commande \TeXLive n'est pas utilisée en v.f. +\renewcommand{\TL}{\TeX{} Live\xspace}% Robuste (pas besoin de \protect)... +\renewcommand{\TK}{\TeX{} Collection\xspace}% idem. +% tex-live.sty fait précéder les no de page d'une fine... +% en français, une insécable normale est préférable +\def\p.{page~} + +% correction du support pour tex4ht relatif à frenchb.ldf 2.3 ou supérieur +\ifnum\Status=2 % generating html + \makeatletter + \AtBeginDocument{\let\FDP@space\FDP@colonspace} + \makeatother +\fi + +% plus de macros (mpg) +\newcommand\eng[1]{\foreignlanguage{english}{\emph{#1}}} +\newcommand*\semail[1]{\href{mailto:#1}{#1}} + +\setlength{\parindent}{0mm} +\addtolength{\parskip}{.25\baselineskip} + +\begin{document} + +\title{% + {\huge\itshape Guide pratique de \TL \\\smallskip}% + {\LARGE\sffamily \TL 2012}% +} + +\author{ + Karl Berry, éditeur \\[3mm] + \url{http://tug.org/texlive/} \\[6mm] + \textit{Version française} \\[3mm] + Manuel Pégourié-Gonnard\thanks{% + Précédentes versions françaises par Daniel + Flipo, Éric Picheral, Jacques André, Fabrice Popineau et peut-être + d'autres avant eux --- qu'ils en soient tous remerciés. Mes remerciements + aussi aux aimables relecteurs : + Arnaud Schmittbuhl, + Denis Bitouzé, + Élie Roux, + Hervé Vigier, + Jean-Yves Beaudais, + Laurent Méhats, + tdc + ; je suis bien sûr responsable des erreurs restantes. N'hésitez pas à me + les signaler par mail à \semail{mpg@elzevir.fr} ! + } +} + +% relecteurs 2009 : +% Denis Bitouzé, +% Élie Roux, +% Hervé Vigier, +% Jean-Yves Beaudais, +% Laurent Méhats, +% tdc +% relecteurs 2010 : +% Denis Bitouzé, +% Hervé Vigier, +% Arnaud Schmittbuhl + +\date{Juin 2012} + +\maketitle + +\begin{multicols}{2} +\tableofcontents +\end{multicols} + +\section{Introduction} +\label{sec:intro} + +\subsection{\TeX\ Live et \TeX\ Collection} + +Ce document décrit les principales caractéristiques de la +distribution \TL{}, une distribution complète de \TeX{} +pour Linux et autres Unix, \MacOSX{} et systèmes Windows. + +Cette distribution peut être obtenue par téléchargement, sur le \DVD{} \TK{} +distribué par les groupes d'utilisateurs de \TeX{} à leurs membres, ou par +d'autres moyens. +La section \ref{sec:tl-coll-dists} décrit brièvement le contenu du \DVD. +\TL{} et \TK{} sont le fruit des efforts des groupes d'utilisateurs de +\TeX. La description qui suit porte essentiellement sur \TL. + +La distribution \TL comprend les binaires +pré-compilés de \TeX, \LaTeXe, \ConTeXt, \MF, \MP, \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 fin du document, section~\ref{sec:history} +(page~\pageref{sec:history}), un bref historique des principales modifications +apportées au fil du temps à la distribution \TL. + +Les utilisateurs des éditions précédentes de \TL{} sont invités à lire, +\emph{avant toute mise à jour}, la section~\ref{sec:tlcurrent} +page~\pageref{sec:tlcurrent} qui présente les principaux changements +intervenus cette année. + +\htmlanchor{platforms} +\subsection{Support des différents systèmes d'exploitation} +\label{sec:os-support} + +\TL{} contient les exécutables pour les principales architectures Unix, dont +\GNU/Linux, \MacOSX et Cygwin. Les sources inclus dans +la distribution devraient être compilables sur des plate-formes pour lesquelles +nous ne fournissons pas d'exécutables. + +Concernant Windows, \acro{XP} et les versions ultérieures sont supportés. +Windows~2000 devrait probablement fonctionner (en bonne partie). Il n'y a pas +d'exécutables spécifiques 64-bit pour Windows, mais les exécutables 32-bit +devraient fonctionner sur les systèmes 64-bit. + +Consulter la section~\ref{sec:tl-coll-dists} pour des solutions alternatives +sous Windows et \MacOSX. + +\subsection{Installation élémentaire de \TL{}} +\label{sec:basic} + +Vous pouvez installer \TL{} de deux façons différentes : soit depuis le \DVD, +soit depuis Internet (\url{http://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. Il n'est +plus possible de lancer \TL directement depuis le \DVD{} \TK{} (ou une image +\code{.iso}), mais vous pouvez créer une installation portable, par exemple +sur une clé \USB{} (voir section~\ref{sec:portable-tl}). + +La procédure d'installation est décrite en détail dans les sections suivantes +(\p.\pageref{sec:install}), mais voici de quoi commencer rapidement. + +\begin{itemize*} + +\item Le script d'installation s'appelle \filename{install-tl}. Il peut + fonctionner en mode « magique\footnote{\eng{wizard mode} en anglais} » avec + l'option \code{-gui=wizard} (c'est le mode par défaut sous Windows), en mode + texte avec l'option \code{-gui=text} (mode par défaut partout ailleurs), ou + en mode graphique expert avec \code{-gui=perltk}. + +\item Ce script installe en particulier le programme « \TL\ Manager » appelé + \prog{tlmgr}. Comme l'installeur, il peut être utilisé en mode graphique ou + en mode texte. Il permet d'ajouter ou de supprimer des composants et de + procéder à différents réglages de configuration. + +\end{itemize*} + +\htmlanchor{security} +\subsection{Remarques sur la sécurité} +\label{sec:security} + +À 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 +\TL{} 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 confiance. Pour +plus de sécurité, travaillez dans un nouveau répertoire créé à cet effet. + +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éfini. 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érifier s'il n'y a pas de +fichiers 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. + +Enfin, \TeX{} (et les programmes associés) ont la capacité d'écrire des +fichiers en compilant des documents, capacité qui peut être exploitée à des +fins malignes de nombreuses façons. Ici aussi, la meilleure protection est de +compiler les documents inconnus dans un répertoire nouvellement créé. + +\subsection{Obtenir de l'aide} +\label{sec:help} + +La communauté \TeX{} est active et conviviale ; la plupart des questions +finissent par obtenir une réponse. Par contre, le support est informel, assuré +par des volontaires et des lecteurs occasionnels, aussi est-il +particulièrement important que vous fassiez votre propre travail de recherche +avant de poser une question (si vous préférez un support commercial, vous +pouvez renoncer à \TL{} et acheter un système payant ; voir une liste à +\url{http://tug.org/interest.html#vendors}). + +Voici une liste de ressources, classées selon l'ordre dans lequel nous +recommandons de les utiliser : + +\begin{description} +\item [Getting Started] -- pour ceux qui débutent en \TeX, la page web +\url{http://tug.org/begin.html} contient une courte description +du système. + +\item [\acro{FAQ} \TeX{}] -- la \acro{FAQ} \TeX{} est un vaste recueil + de réponses à toutes sortes de questions, de la plus élémentaire à la + plus complexe. Elle est enregistrée sur le \DVD{} dans + \OnCD{texmf-dist/doc/generic/FAQ-en/html/index.html} + et elle est disponible sur Internet à + l'adresse \url{http://www.tex.ac.uk/faq}. + Merci de consulter cette FAQ avant toute question. + +\item [Catalogue \TeX{}] -- si vous recherchez une extension, une fonte, + un programme, etc., le mieux est de consulter le catalogue + \TeX{} ici : \url{http://mirror.ctan.org/help/Catalogue/}. + +\item [Ressources \TeX{} sur le Web] -- la page web + \url{http://tug.org/interest.html} propose + beaucoup de liens relatifs à \TeX{}, en particulier concernant des + livres, manuels et articles portant sur tous les aspects du système. + +\item [Archives des forums d'aide] -- les principaux forums dédiés + au support de \TeX{} sont les groupes de nouvelles Usenet + \url{news:comp.text.tex} (en anglais) et \url{news:fr.comp.text.tex} + (en français) ainsi que les listes de diffusion + \email{texhax@tug.org} (en anglais) et \email{gut@ens.fr} (en français). + Les archives correspondantes contiennent des + milliers de questions et réponses déjà traitées et permettent + une recherche fructueuse. Voir + \url{http://groups.google.com/groups?group=fr.comp.text.tex} + et \url{http://tug.org/mail-archives/texhax}, respectivement. Une + question posée sur un moteur de recherche, tel que + \url{http://google.com}, peut aussi fournir des réponses pertinentes. + +\item [Poster une question] -- si vous ne trouvez pas de réponse, vous pouvez + poser la question (en français) sur \dirname{fr.comp.text.tex} via Google ou + votre lecteur de nouvelles, ou encore par messagerie à + \email{texhax@tug.org} (en + anglais). Mais avant de le faire, merci de lire l'introduction de la + \acro{FAQ} donnant les conseils sur la façon de rédiger la question pour + avoir des chances d'obtenir une réponse pertinente : + \url{http://www.tex.ac.uk/cgi-bin/texfaq2html?label=askquestion}. Pour de + l'aide en anglais, vous pouvez également vous tourner vers le site \LaTeX{} + Community : \url{http://www.latex-community.org/} et son forum + \url{http://www.latex-community.org/forum/}, ainsi que le site \TeX\ + StackExchange à \url{http://tex.stackexchange.com/}. + +\item [Support de \TL{}] -- si vous voulez faire un rapport + d'anomalie, émettre des suggestions ou des commentaires sur la + distribution \TL{}, son installation ou sa documentation, utilisez + la liste de diffusion \email{tex-live@tug.org}. Mais attention, si + la question concerne l'utilisation d'un programme particulier inclus + dans \TL{}, il vaut mieux que vous vous adressiez directement à la + personne ou à la liste de diffusion qui maintient le programme. Il suffit + souvent d'ajouter l'option \code{-{}-help} lors de l'exécution du programme + pour trouver à qui adresser le rapport. + +\end{description} + +L'autre aspect du sujet concerne l'aide à apporter aux personnes +soumettant des questions. Les forums \dirname{comp.text.tex}, +\dirname{fr.comp.text.tex} ainsi que les listes de diffusion \code{texhax} +et \code{gut} +sont ouverts à tous, aussi n'hésitez pas à vous y joindre, à commencer +la lecture et à fournir de l'aide là où cela vous est possible. + +% No \protect needed as \TL is defined in French with \newcommand (robust). +\section{Structure de \TK} +\label{sec:overview-tl} + +Nous décrivons ici le contenu de \TK{} qui est un sur-ensemble de \TL. + +\subsection {\TK{} : \TL, pro\TeX{}t, Mac\TeX} +\label{sec:tl-coll-dists} + +Le \DVD{} \TK{} contient les éléments suivants : + +\begin{description} + +\item [\TL{}] -- un système \TeX{} complet à installer. Sa + page web est \url{http://tug.org/texlive/}. + +\item [Mac\TeX] -- un système \TeX\ pour \MacOSX, qui ajoute à \TL un + installateur spécifique à \MacOSX{} et quelques applications propres au + système Mac. Le site de Mac\TeX{} est \url{http://tug.org/mactex/}. + +\item [pro\TeX{}t] -- une extension du système \MIKTEX\ pour Windows qui en + facilite l'installation et ajoute quelques outils. Cette distribution est + totalement indépendante de \TL{}, elle nécessite un mode d'installation + spécifique. Le site de \ProTeXt\ est \url{http://tug.org/protext}. + +\item [CTAN] -- une image du site d'archives \CTAN. + +\item [\texttt{texmf-extra}] -- un répertoire contenant quelques extensions + supplémentaires. + +\end{description} + +Les droits d'utilisation des fichiers présents dans \CTAN, \ProTeXt{} +et \texttt{texmf-extra} diffèrent de ceux de \TL{}, pensez à lire +les licences si vous envisagez de modifier ou de redistribuer certains de +ces fichiers. + +\subsection{Répertoires situés à la racine de \TL{}} +\label{sec:tld} + +Voici une petite liste des répertoires situés à la racine d'une installation +\TL avec une courte description. + +\begin{ttdescription} +\item[bin] -- programmes de la famille \TeX{}, rangés dans des + sous-répertoires selon les plates-formes. +% +\item[readme-*.dir] -- une brève introduction et quelques liens utiles pour + \TL, dans divers langages, sous forme de pages \HTML\ ou de texte brut. +% +\item[source] -- le code source de tous les programmes, dont les principaux + programmes \TeX{} basés sur \Webc{}. +% +\item[texmf] -- répertoire contenant les programmes et leur documentation ; ne + contient ni les formats ni les extensions (la variable \envname{TEXMFMAIN} + de la section suivante pointe sur ce répertoire). +% +\item[texmf-dist] -- répertoire principal où se trouvent les extensions, + les fontes, etc., avec leur documentation (la variable \envname{TEXMFDIST} + de la section suivante pointe sur ce répertoire). +% +\item[tlpkg] -- scripts et programmes d'installation, et + éléments spécifiques pour Windows. +\end{ttdescription} + +On trouve également, au même niveau que les répertoires mentionnés ci-dessus, +les scripts d'installation et le fichier \filename{README} principal en +anglais (disponible en différentes langues dans les répertoires +\filename{readme-*.dir} susmentionnés). + +Concernant la documentation, le fichier \OnCD{doc.html}, qui contient une +liste exhaustive de liens vers les fichiers de documentation, peut être bien +utile. La documentation des programmes (manuels, pages de \cmdname{man}, +fichiers \cmdname{info}) se trouve dans \dirname{texmf/doc}. Celle des autres +paquets et des formats est dans \dirname{texmf-dist/doc}. Vous pouvez utiliser +le programme \cmdname{texdoc} pour trouver chaque fichier de documentation, où +qu'il soit. + +La documentation de \TL\ proprement dite (que vous consultez actuellement) est +disponible dans le répertoire \dirname{texmf/doc/texlive} en plusieurs +langues, + +\begin{itemize*} +\item{anglais :} \OnCD{texmf/doc/texlive/texlive-en}, +\item{allemand :} \OnCD{texmf/doc/texlive/texlive-de}, +\item{chinois (simplifié) :} \OnCD{texmf/doc/texlive/texlive-zh-cn}, +\item{français :} \OnCD{texmf/doc/texlive/texlive-fr}, +\item{italien :} \OnCD{texmf/doc/texlive/texlive-it} +\item{polonais :} \OnCD{texmf/doc/texlive/texlive-pl}, +\item{russe :} \OnCD{texmf/doc/texlive/texlive-ru}, +\item{tchèque \& slovaque :} \OnCD{texmf/doc/texlive/texlive-cz}. +\end{itemize*} + +\subsection{Description des arborescences « texmf » de \TL} +\label{sec:texmftrees} + +Nous donnons ici la liste des variables prédéfinies qui contiennent les noms +des différentes arborescences de type « texmf », l'usage qui en est fait, et +leurs valeurs par défaut dans \TL. La commande \cmdname{tlmgr~conf} montre +les valeurs de ces variables, ce qui permet de savoir où se trouvent ces +diffé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{} : \url{http://tug.org/tds}) avec sa pléthore de sous-répertoires, ou +les fichiers ne seront pas pris en compte. La section +\ref{sec:local-personal-macros} page \pageref{sec:local-personal-macros} +donne plus de détails à ce sujet. + +\begin{ttdescription} +\item [TEXMFMAIN] -- contient les éléments essentiels du système, comme les + fichiers de configuration, des scripts utilitaires, et la documentation des + programmes. +\item [TEXMFDIST] -- contient les fichiers de macros (Plain, \LaTeX, \ConTeXt, + etc.), les fontes, etc. Rien ne devrait être ajouté, modifié ni supprimé + manuellement dans cette arborescence. +\item [TEXMFLOCAL] -- c'est là que l'administrateur de la machine doit + placer les classes et extensions locales, les fontes non disponibles + dans \TL, etc. +\item [TEXMFHOME] -- contient les fichiers personnels (extensions, classes, + fontes) de l'utilisateur ; ce répertoire est installé automatiquement dans + le répertoire personnel de l'utilisateur. +\item [TEXMFCONFIG] -- c'est là que les scripts \cmdname{texconfig} + \cmdname{updmap} et \cmdname{fmtutil} recherchent leurs fichiers de + configuration (personnelles) en priorité. +\item [TEXMFSYSCONFIG] -- c'est là que les scripts \cmdname{texconfig-sys}, + \cmdname{updmap-sys} et \cmdname{fmtutil-sys} recherchent leurs fichiers de + configuration (globaux) en priorité. +\item [TEXMFVAR] -- c'est là que les scripts \cmdname{texconfig}, + \cmdname{updmap} et \cmdname{fmtutil} rangent les (versions personnelles de) + données générées, comme les formats et les fichiers \verb+.map+. +\item [TEXMFSYSVAR] -- c'est là que les scripts \cmdname{texconfig-sys}, + \cmdname{updmap-sys} et \cmdname{fmtutil-sys} rangent les (versions globales + des) données générées, comme les formats et les fichiers \verb+.map+. +\item [TEXMFCACHE] -- arborescence(s) utilisée(s) par \ConTeXt\ Mk\acro{IV} + pour stocker des (versions de cache de) fichiers de travails. +\end{ttdescription} + +La structure de l'arborescence \TL{} est par défaut la suivante : +\begin{description} +\item[racine multi-utilisateur] (par exemple \verb|/usr/local/texlive|, + \verb|D:\texlive|,\dots) qui contient éventuellement plusieurs + distributions : + \begin{ttdescription} + \item[2011] -- la distribution précédente, + \item[2012] -- la distribution actuelle, + \begin{ttdescription} + \item [bin] ~ + \begin{ttdescription} + \item [i386-linux] -- exécutables Linux, + \item [...] + \item [universal-darwin] -- exécutables \MacOSX, + \item [win32] -- exécutables Windows, + \end{ttdescription} + \item [texmf\ \ \ \ \ \ \ ] -- correspond à \envname{TEXMFMAIN}, + \item [texmf-dist\ \ ] -- correspond à \envname{TEXMFDIST}, + \item [texmf-var\ \ \ ] -- correspond à \envname{TEXMFSYSVAR}, + \item [texmf-config] -- correspond à \envname{TEXMFSYSCONFIG}, + \end{ttdescription} + \item [texmf-local] -- correspond à \envname{TEXMFLOCAL}, normalement + commun à plusieurs distributions \TL{} (2007, 2008, etc.), + \end{ttdescription} + \item[répertoire personnel de l'utilisateur] \texttt{\$HOME} ou + \texttt{\%USERPROFILE\%} : + \begin{ttdescription} + \item[.texlive2011] -- fichiers propres à l'utilisateur générés + automatiquement par la distribution \TL{} précédente, + \item[.texlive2012] -- fichiers propres à l'utilisateur générés + automatiquement par la distribution \TL{} actuelle, + \begin{ttdescription} + \item [texmf-var\ \ \ ] -- correspond à \envname{TEXMFVAR}, + \envname{TEXMFCACHE}, + \item [texmf-config] -- correspond à \envname{TEXMFCONFIG}, + \end{ttdescription} + \item[texmf] -- correspond à \envname{TEXMFHOME}, répertoire regroupant + tous les répertoires de macros personnelles : \dirname{texmf/tex/latex} + par exemple pour les fichiers de macros \LaTeX, etc. + \end{ttdescription} +\end{description} + +\subsection{Les extensions de \TeX} +\label{sec:tex-extensions} + +Le programme \TeX\ original de Knuth est figé, sauf corrections de bugs, +rares. C'est toujours le programme \prog{tex} présent dans \TL, et ceci ne +changera pas autant dans un futur prévisible. \TL contient plusieurs variantes +étendues de \TeX. + +\begin{description} + +\item [\eTeX{}] \label{text:etex} ajoute un jeu de nouvelles + primitives et les extensions \TeXXeT{} pour l'écriture de droite + à gauche ; \eTeX{} est, en mode normal, 100\% compatible avec + \TeX{} standard. Pour plus de détails consulter le + fichier \OnCD{texmf-dist/doc/etex/base/etex_man.pdf} du \DVD{}. + +\item [pdf\TeX{}] inclut les extensions \eTeX{} et produit, au choix, des + fichiers au format Acrobat \acro{PDF} ou au format \dvi{} ; il inclut aussi + de nombreuses extensions indépendantes du format de sortie. C'est le moteur + de base sur lequel sont construits tous les formats autres que plain\TeX{}, + comme \prog{etex}, \prog{latex} et \prog{pdflatex}. Son site web est + \url{http://www.pdftex.org/}. Le manuel d'utilisation se trouve sur le + \DVD{} dans \OnCD{texmf/doc/pdftex/manual/}. Le fichier + \OnCD{texmf/doc/pdftex/pdftex/manual/samplepdf/samplepdf.tex} donne des + exemples d'utilisation. + +\item [Lua\TeX] est le successeur de pdf\TeX{} avec lequel il reste en grande + partie (mais pas totalement) compatible. Ses possibilités sont aussi censées + être un sur-ensemble de celles d'Aleph (voir ci-dessous), bien qu'il ne soit + pas prévu pour être techniquement compatible. Lua\TeX{} inclut le langage + de script Lua (voir \url{http://www.lua.org/}) qui apporte des solutions + élégantes à beaucoup de problèmes épineux en \TeX{} pur. La commande + \filename{texlua} fonctionne comme un interpréteur Lua indépendant, et est + déjà utilisée en tant que telle dans \TL. Voir \url{http://www.luatex.org/} + et \OnCD{texmf-dist/doc/luatex/luatexref-t.pdf}. + +\item [Xe\TeX] ajoute la possibilité d'utiliser en entrée le codage Unicode + et en sortie les fontes OpenType et les fontes système de la machine, ceci + grâce à des bibliothèques externes : voir \url{http://tug.org/xetex/}. + +\item [\OMEGA{} (Omega)] fonctionne en utilisant Unicode et des caractères 16 + bits, ce qui lui permet de travailler directement et simultanément avec + presque toutes les écritures du monde. L'extension supporte aussi le + chargement dynamique d'\acro{OTP} (\OMEGA{} \emph{Translation Processes}) + qui permet à l'utilisateur d'appliquer sur des flux d'entrée quelconques des + transformations complexes qu'il aura lui-même définies. \TL n'inclut plus + Omega en tant que programme séparé ; seul Alpeh est fourni. + +\item [Aleph] combine les fonctionnalités de \OMEGA\ et de \eTeX ; voir + \OnCD{texmf-dist/doc/aleph/base}. + +\end{description} + +\subsection{Quelques autres programmes intéressants + dans \TL} + +Voici quelques autres programmes couramment utilisés et présents dans +\TL{} : + +\begin{cmddescription} + +\item [bibtex, bibtex8] -- traitement des bibliographies. + +\item [makeindex, xindy] -- traitement des index. + +\item [dvips] -- conversion \dvi{} vers \PS{}. + +\item [xdvi] -- visualisation \dvi{} pour le système X Window. + +\item [dvilj] -- pilote \dvi{} pour les imprimantes HP LaserJet. + +\item [dviconcat, dviselect] -- couper/Coller de pages à partir de fichiers + \dvi{}. + +\item [dvipdfmx] -- conversion \dvi{} vers \acro{PDF}, une alternative à + pdf\TeX{} (mentionné ci-dessus) pour produire des fichiers \acro{PDF}. + +\item [psselect, psnup, \ldots] -- utilitaires \PS{}. + +\item [pdfjam, pdfjoin, \ldots] -- utilitaires \acro{PDF}. + +\item [texexec, texmfstart] -- processeurs Con\TeX{}t et \acro{PDF}. + +\item [tex4ht] -- conversion \TeX{} vers \acro{HTML} et \acro{XML}. + +\end{cmddescription} + +\subsection{Fontes incluses dans \TL} +\label{sec:tl-fonts} + +La distribution \TL{} contient un grand nombre de fontes vectorielles de haute +qualité : voir \url{http://tug.org/fonts} et +\OnCD{texmf-dist/doc/fonts/free-math-fonts-survey}. + + +\htmlanchor{installation} +\section{Installation} +\label{sec:install} + +\subsection{Démarrage de l'installation} +\label{sec:inst_start} + +La première chose à faire est de récupérer le \DVD{} \TK ou de +télécharger le programme d'installation par le réseau. +Le programme d'installation s'appelle \filename{install-tl} pour Unix +et \filename{install-tl.bat} pour Windows. La page +\url{http://tug.org/texlive/acquire.html} donne plus d'informations sur les +différentes façons d'obtenir le logiciel. + +\begin{description} +\item [Installeur réseau] -- à télécharger sur CTAN dans + \dirname{systems/texlive/tlnet}; l'url + \url{http://mirror.ctan.org/systems/texlive/tlnet} vous redirigera + automatiquement vers le serveur d'archive le plus proche de chez vous. + Deux versions sont disponibles, \filename{install-tl.zip} utilisable sous + Unix et Windows, et \filename{install-unx.tar.gz} pour Unix seulement + (y compris \MacOSX). Après décompression de l'un de ces deux fichiers, les + scripts \filename{install-tl} et \filename{install-tl.bat} se trouveront + dans le sous-répertoire \dirname{install-tl}. + +\item [\DVD \TK{}] -- aller dans son répertoire \dirname{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 \filename{install-tl} ou \filename{install-tl.bat}. + Le \DVD \TK{} est distribué gratuitement aux membres des groupes + d'utilisateurs de \TeX{} (Gutenberg par exemple en France, voir la liste + des groupes sur \url{http://tug.org/usergroups.html}). Il est également + possible de l'acheter séparément (\url{http://tug.org/store}) ou de graver + une image \ISO{} téléchargée, voire de la monter directement, sur la plupart + des systèmes. Après avoir installé depuis le \DVD{}, si vous voulez accéder + aux mises à jour en continu depuis Internet, consultez la + section~\ref{sec:dvd-install-net-updates}. +\end{description} + +Le même programme d'installation est utilisé quelle que soit la source +d'installation. La différence la plus visible entre ces deux modes et qu'avec +l'installation par le réseau, vous obtenez les version courantes des +différents paquets, contrairement au \DVD{} (ou image \ISO) qui n'est pas mis +à jour entre deux versions majeures. + +Les sections suivantes expliquent plus en détails le fonctionnement de +l'installateur. + +\subsubsection{Installation sous Unix} + +Dans ce qui suit l'invite du \textit{shell} est notée \texttt{>} ; les +commandes de l'utilisateur sont en \Ucom{\texttt{gras}}. Le programme +\filename{install-tl} est un script Perl ; la façon la plus simple de +le démarrer sur un système Unix est la suivante. +\begin{alltt} +> \Ucom{cd /chemin/de/installateur} +> \Ucom{perl install-tl} +\end{alltt} +(Vous pouvez aussi invoquer \Ucom{perl /chemin/de/installateur/install-tl} ou +\Ucom{./install-tl} si le fichier est toujours exécutable, etc. ; 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 (figure~\ref{fig:text-main}). + +Pour travailler en mode graphique expert (figure~\ref{fig:gui-main} -- +attention, le module \dirname{Perl/TK} doit être disponible, avec le support +de \acro{XFT}, ce qui est en général le cas sous \GNU/Linux, mais pas +nécessairement sous d'autres systèmes) : +\begin{alltt} +> \Ucom{cd /chemin/de/installeur} +> \Ucom{./install-tl -gui} +\end{alltt} + +La liste complète des options est donnée par +\begin{alltt} +> \Ucom{perl install-tl -help} +\end{alltt} + +\textbf{Attention} : le matériel installé doit normalement être accessible à +tous les utilisateurs de la machine ; si celui qui installe n'est pas +\textit{root}, il devra s'assurer que son \code{umask} est adapté, par +exemple \code{umask 022} ou \code{umask 002}. +Consulter la documentation système pour plus de précisions. + +\textbf{Remarques particulières pour Cygwin} : contrairement aux autres +système compatibles Unix, Cygwin ne comprend pas par défaut tous les +programmes requis pour faire fonctionner l'installateur \TL. Voir la +section~\ref{sec:cygwin} pour plus de détails. + +\subsubsection{Installation sous Mac\,OS\,X} + +Une distribution spécifique, Mac\TeX\ (\url{http://tug.org/mactex}), a été +mise au point pour \MacOSX. Nous recommandons d'utiliser son installateur +natif, plutôt que d'installer la distribution \TL{} en suivant la procédure +indiquée pour Unix. En effet, Mac\TeX{} comprend des ajustements spécifiques +pour le système \MacOSX{} et facilite la cohabitation entre plusieurs +distributions \TeX{} (Mac\TeX, Fink, MacPorts, etc.). + +Mac\TeX\ est fortement basée sur \TL et les arborescences principales sont en +tous points identiques. Quelques répertoires contenant de la documentation et +des applications spécifiques au Mac sont ajoutés. + +\subsubsection{Installation sous Windows} + +Si vous utilisez l'installeur réseau ou si l'insertion du \DVD{} ne lance pas +l'installation automatiquement, double-cliquez sur \filename{install-tl.bat}. +Pour disposer de plus d'options, par exemple pour sélectionner des collections +de paquets spécifiques au lieu de faire une installation complète, utilisez +plutôt \filename{install-tl-advanced.bat}. + +Il est également possible de travailler en ligne de commande ; +dans ce qui suit l'invite du \textit{shell} est notée \texttt{>}, les +commandes de l'utilisateur sont notées \Ucom{\texttt{en gras}}. Voici les +commandes à lancer : +\begin{alltt} +> \Ucom{install-tl} +\end{alltt} +à condition d'être dans le répertoire du script d'installation, sinon +\begin{alltt} +> \Ucom{D:\bs{}texlive\bs{}install-tl} +\end{alltt} +où \texttt{D:} désigne le lecteur de \DVD où se trouve la collection \TeX. +La figure~\ref{fig:wizard-w32} montre l'installateur en mode magique, qui est +le mode par défaut pour Windows. + +Pour travailler en mode texte : +\begin{alltt} +> \Ucom{install-tl -no-gui} +\end{alltt} +La liste complète des options est donnée par +\begin{alltt} +> \Ucom{install-tl -help} +\end{alltt} + +\begin{figure}[tb] +\begin{boxedverbatim} +Installing TeX Live 2012 from: ... +Platform: i386-linux => 'Intel x86 with GNU/Linux' +Distribution: inst (compressed) +... + Detected platform: Intel x86 with GNU/Linux + + <B> platforms: 1 out of 19 + + <S> installation scheme (scheme-full) + 84 collections out of 85, disk space required: 3091 MB + + Customizing installation scheme: + <C> standard collections + <L> language collections + + <D> directories: + TEXDIR (the main TeX directory): + /usr/local/texlive/2012 + ... + + <O> options: + [ ] use letter size instead of A4 by default + ... + + <V> set up for portable installation + +Actions: + <I> start installation to hard disk + <H> help + <Q> quit +\end{boxedverbatim} +\caption{Écran principal de l'installateur en mode texte (\GNU/Linux)}% +\label{fig:text-main} +\end{figure} + +\begin{figure}[tb] +\tlpng{install-lnx-main}{\linewidth, trim=10 4 0 20, clip} +\caption{Installateur graphique en mode expert (\GNU/Linux)} +\label{fig:gui-main} +\end{figure} + +\begin{figure}[tb] +\tlpng{wizard-w32}{\linewidth,trim=0 4 0 0,clip} +\caption{Installateur graphique en mode expert (Windows)} +\label{fig:wizard-w32} +\end{figure} + + +\htmlanchor{cygwin} +\subsubsection{Installation sous Cygwin} +\label{sec:cygwin} + +L'installateur \TL fonctionne uniquement sous Cygwin 1.7. Avant de commencer +l'installation, utilisez le programme \filename{setup.exe} de Cygwin pour +installer les paquets \filename{perl} et \filename{wget} si ce n'est déjà +fait. Il est également recommandé d'installer les paquets suivants : +\begin{itemize*} +\item \filename{fontconfig}, utilisé par \XeTeX ; +\item \filename{ghostscript}, nécessaire pour divers utilitaires ; +\item \filename{libXaw7}, utilisé par \code{xdvi} ; +\item \filename{ncurses}, qui fournit la commande \code{clear} utilisée par + l'installateur. +\end{itemize*} + +\subsubsection{Installation en mode texte} + +La figure~\ref{fig:text-main} présente l'écran principal de configuration 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), l'écran se +mettra automatiquement à jour. + +L'interface est volontairement rudimentaire afin de permettre son utilisation +sur le plus grand nombre possible de systèmes même avec des versions très +dépouillées de Perl. + +\subsubsection{Installation en mode graphique-expert} + +La figure~\ref{fig:gui-main} page~\pageref{fig:gui-main} présente l'écran +principal de configuration en mode graphique sous \GNU/Linux. À part +l'utilisation de boutons et menus, cet installateur ne diffère pas beaucoup de +l'installateur en mode texte. + +Ce mode peut être demandé explicitement avec +\begin{alltt} +> \Ucom{install-tl -gui=perltk} +\end{alltt} + +\subsubsection{L'installation en mode magique} + +Sous Windows, l'installateur démarre par défaut dans le mode le plus simple +que nous avons pu concevoir, le mode « magique » (figure~\ref{fig:wizard-w32}. +Dans ce mode, tout est installé et presque aucune question n'est posée. Par +contre, si vous souhaitez personnaliser votre installation, vous devriez +utiliser un des autres modes. + +Ce mode peut être demandé explicitement avec +\begin{alltt} +> \Ucom{install-tl -gui=wizard} +\end{alltt} + +\subsection{Choix des options d'installation} +\label{sec:runinstall} + +Les options proposées sont censées être assez explicites, voici cependant +quelques précisions. + +\subsubsection{Choix des binaires (Unix seulement)} +\label{sec:binary} + +\begin{figure}[tbh] +\centering +\begin{boxedverbatim} +Available platforms: +=============================================================================== + a [ ] alpha-linux DEC Alpha with GNU/Linux + b [ ] amd64-freebsd x86_64 with FreeBSD + c [ ] amd64-kfreebsd x86_64 with GNU/FreeBSD + d [ ] i386-cygwin Intel x86 with Cygwin + e [ ] i386-freebsd Intel x86 with FreeBSD + f [ ] i386-kfreebsd Intel x86 with GNU/FreeBSD + g [X] i386-linux Intel x86 with GNU/Linux + h [ ] i386-netbsd Intel x86 with NetBSD + i [ ] i386-solaris Intel x86 with Solaris + j [ ] mips-irix SGI IRIX + k [ ] powerpc-aix PowerPC with AIX + l [ ] powerpc-linux PowerPC with GNU/Linux + m [ ] sparc-linux Sparc with GNU/Linux + o [ ] sparc-solaris Sparc with Solaris + p [ ] universal-darwin universal binaries for MacOSX/Darwin + s [ ] win32 Windows + t [ ] x86_64-darwin x86_64 with MacOSX/Darwin + u [ ] x86_64-linux x86_64 with GNU/Linux + v [ ] x86_64-solaris x86_64 with Solaris +\end{boxedverbatim} +\caption{Menu pour le choix des binaires}\label{fig:bin-text} +\end{figure} + +La figure~\ref{fig:bin-text} présente les choix de binaires possibles en mode +texte. Seuls les binaires correspondant à l'architecture détectée seront +installés par défaut. Rien n'empêche d'en sélectionner d'autres si nécessaire, +ce qui peut être intéressant dans le cas de machines en réseau ou sur des +systèmes en « double boot ». + +\subsubsection{Sélection de ce qui va être installé} +\label{sec:components} + +\begin{figure}[tbh] +\centering +\begin{boxedverbatim} +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 [ ] ConTeXt scheme + g [ ] GUST TeX Live scheme + h [ ] teTeX scheme (more than medium, but nowhere near full) + i [ ] XML scheme + j [ ] custom selection of collections +\end{boxedverbatim} +\caption{Menu « Scheme »}\label{fig:scheme-text} +\end{figure} + +Dans le menu « Scheme » (voir figure~\ref{fig:scheme-text}) on choisit un +schéma général de configuration qui détermine un ensemble de collections à +installer. Le schéma par défaut (\optname{full}) consiste à tout installer, +ce qui est recommandé. Vous pouvez également choisir \optname{basic} pour un +petit système, \optname{minimal} pour des tests uniquement, \optname{medium} +ou \optname{teTeX} pour quelque chose d'intermédiaire. Il existe aussi des +schémas spécialisés ou spécifiques à un pays. + +\begin{figure}[tbh] +\centering +\tlpng{stdcoll}{.7\linewidth,trim=0 4 0 0,clip} +\caption{Menu « Collections » (Linux)}\label{fig:collections-gui} +\end{figure} + +Une fois choisi le schéma (\eng{scheme}) général, il est possible d'ajouter ou +de supprimer des composants, appelés +ici collections. Il y a deux types de collections : les +« Standard Collections » qui concernent les fontes, les extensions, les +formats, etc. (voir figure~\ref{fig:collections-gui}) et les +« Language Collections » qui permettent de préciser la liste des langues +qui seront utilisables sur le système (indispensable !). Attention, si vous +travaillez en mode texte, dans ces menus la casse des lettres est importante. +En mode graphique, il suffit de cocher ou de décocher les cases en cliquant. + +Il est possible de raffiner encore les choix mais il faudra alors utiliser le +gestionnaire de paquets TeX Live (\prog{tlmgr}) ultérieurement, voir la +section~\ref{sec:tlmgr}. + +\subsubsection{Répertoires d'installation} +\label{sec:directories} + +L'arrangement par défaut des différents répertoire est donné à la +section~\ref{sec:texmftrees}, page~\pageref{sec:texmftrees}. La racine de +l'installation principale, \dirname{TEXDIR}, vaut par défaut +\dirname{/usr/local/texlive/2012} sous Unix et |%SystemDrive%\texlive\2012| +sous Windows. + +Il peut être nécessaire de changer la valeur de \dirname{TEXDIR} +lorsque celui qui procède à l'installation n'a pas les droits d'écriture +sur le répertoire \dirname{TEXDIR} (l'installation n'est pas réservée au +superutilisateur \eng{root} ou « Administrateur », il suffit d'avoir les droits +en écriture sur le répertoire \dirname{TEXDIR}). + +Un autre choix raisonnable est d'installer \TL{} dans votre répertoire +personnel, surtout si vous prévoyez d'en être le seul utilisateur. Vous +pouvez utiliser |~| à cet effet, par exemple |~/texlive/2012|. + +Dans tous les cas, il est recommandé d'inclure l'année dans le chemin afin de +pouvoir conserver plusieurs versions de \TL{} en parallèle. +Rien n'empêche d'ajouter un lien symbolique (par exemple +\dirname{/usr/local/texlive-current}) qui pointe sur la version actuellement +utilisée. Ceci facilite les basculements d'une version à une autre. + +Le répertoire \envname{TEXMFHOME} est destiné à +regrouper les répertoires de macros personnelles. Par défaut, son emplacement +est |~/texmf| ; ici, le |~| est préservé dans les fichiers de configurations +crées, de façon à être remplacé dynamiquement pour chaque utilisateur de \TeX, +par la valeur des variables d'environnement \dirname{\$HOME} sous Unix et +|%USERPROFILE%| sous Windows. +Attention, comme tous les autres répertoires, \envname{TEXMFHOME} doit +respecter la structure \TDS{} ou les fichier ne seront pas trouvés. + +Enfin, \dirname{TEXMFVAR} est l'emplacement où sont stockées les fichiers de +cache spécifiques à chaque utilisateur. \dirname{TEXMFCACHE} est utilisé par +\ConTeXt\ Mk\acro{IV} pour le même but (voir la section~\ref{sec:context-mkiv} +page~\pageref{sec:context-mkiv}). + +\subsubsection{Options} +\label{sec:options} + +\begin{figure}[tbh] +\begin{boxedverbatim} +Options setup: +=============================================================================== + <P> use letter size instead of A4 by default: [ ] + <E> execution of restricted list of programs: [X] + <F> create 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 installation, get package updates from CTAN: [X] +\end{boxedverbatim} +\caption{menu « Options » (Unix)}\label{fig:options-text} +\end{figure} + +La figure~\ref{fig:options-text} présente le menu « Options » en mode +texte, sur lesquelles voici quelques précisions. + +\begin{description} +\item[use letter size instead of A4 by default] -- la taille du papier + par défaut pour des outils comme \prog{dvips}, \prog{pdftex}, \prog{xdvi}. + Cette option n'a pas d'influence sur les tailles par défaut utilisées par + des jeux de macros comme les classes standard de \LaTeX\ ou ses modules, qui + seront prioritaires. Dans tous les cas, il est possible et recommandé de + préciser la taille de papier souhaitée au sein de chaque document. + +\item[execution of restricted list of programs] -- à compter de \TL 2010, + l'exécutions 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 + fichier \filename{texmf.cnf}. Voir la section~\ref{sec:2010news} pour plus + de détails. + +\item[create format files] -- création de tous les formats à l'installation. + Bien que cette opération prenne un peu de temps, il est conseillé de ne pas + la supprimer, sinon les formats seront créés au coup par coup dans les + répertoires personnels des utilisateurs (sous \envname{TEXMFVAR}). Les + formats personnels ainsi créés ne bénéficieront pas des mises à jour + éventuelles effectuées ultérieurement sur l'installation \TL{}, ce qui + peut engendrer des incompatibilités. + +\item[install font/macro \ldots\ tree] -- ces options permettent de ne pas + installer les fichiers de documentation et les sources présents dans la + plupart des paquets. Il est recommandé de conserver la valeur par défaut. + +\item[create symlinks in standard directories] -- + cette option (pour Unix seulement) permet d'éviter d'avoir à modifier les + variables d'environnement + \envname{PATH}, \envname{MANPATH} et \envname{INFOPATH} après + l'installation. Elle nécessite les droits d'écriture dans les répertoires + cibles. Il est fortement recommandé de \emph{ne pas} utiliser cette option + si un système \TeX\ est déjà installé par votre système d'exploitation. Elle + est destinée uniquement à permettre l'accès à \TeX\ depuis des répertoires + standard comme \dirname{/usr/local/bin} sur les systèmes où aucune autre + installation \TeX\ n'est présente. + +\item[after installation \ldots\ \CTAN] -- lors d'une installation depuis le + \DVD, cette option est activés par défaut, car on souhaite généralement + bénéficier 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 \TL\ + 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~\ref{sec:location} + et~\ref{sec:dvd-install-net-updates}. +\end{description} + +Lorsque vous êtes satisfait des réglages faits, il vous reste à taper +\code{I} pour lancer le processus d'installation. Lorsque celui-ci sera +terminé, sautez à la section~\ref{sec:postinstall} pour voir s'il y a +d'autres choses à faire. + +\subsection{Options de install-tl en ligne de commande} +\label{sec:cmdline} + +Tapez +\begin{alltt} +> \Ucom{install-tl -help} +\end{alltt} +pour obtenir la liste de toutes les options disponibles. Vous pouvez utiliser +|-| ou |--| pour introduire le noms des options. Voici les plus courantes : + +\begin{ttdescription} +\item[-gui] : exécution en mode graphique (si possible). Ceci nécessite le + module Perl/Tk (\url{http://tug.org/texlive/distro.html#perltk}) avec + support de \acro{XFT} ; si + Perl/Tk n'est pas disponible, l'installation se poursuit en mode texte. + +\item[-no-gui] : exécution en mode texte, même sous Windows. + +\item[-lang {\sl LL}] : langue utilisé par l'interface de l'installateur, + spécifiée par son code standard (généralement sur deux lettres). + Le programme s'efforce 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 \code{install-tl --help}. + +\htmlanchor{opt-in-place} +\item[-in-place] : si vous possédez déjà une copie de \TL{} acquise par rsync, + svn ou un autre moyen (voir + \url{http://tug.org/texlive/acquire-mirror.html}), cette option vous permet + de l'utiliser directement, en l'état, de de procéder uniquement aux + opération post-installation. Attention, ceci peut écraser le fichier + \filename{tlpkg/texlive.tlpdb}, c'est à vous de le sauvegarder auparavant si + vous le désirez. Aussi, une éventuelle déinstallation 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. + +\item[-portable] : créer une installation utilisable de façon portable sur une + clé \acro{USB} ou un \DVD ; peut aussi être activé depuis l'interface + textuelle de l'installateur avec la commande \code{V}, ainsi que depuis + l'interface graphique. Voir la section~\ref{sec:portable-tl} pour les + détails. + +\item[-profile {\sl fichier}] : charger le profil d'installation depuis le + \var{fichier} et installer sans interaction avec l'utilisateur. + À chaque exécution, le script d'installation + écrit un compte-rendu dans le fichier \filename{texlive.profile} du + sous-répertoire \dirname{tlpkg} de votre installation \TL. Ce fichier peut + être donné en argument pour refaire exactement la même installation sur une + machine différente, par exemple. Sinon, vous pouvez utiliser un profil + personnalisé ; la façon la plus facile de le créer est de partir d'un profil + généré et de modifier les valeurs, ou d'utiliser un fichier vide pour + utiliser toutes les valeurs par défaut. + +\item [-repository {\sl url-ou-répertoire}] : choix d'une source où récupérer + le matériel à installer, voir ci-dessous. +\end{ttdescription} + +\subsubsection{L'option \optname{-repository}} +\label{sec:location} + +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 +\url{http://mirror.ctan.org/}. + +Si vous voulez en utiliser un autre, vous pouvez utiliser l'option +\optname{-repository} avec pour valeur une url commençant par \texttt{ftp:}, +\texttt{http:} ou \texttt{file:/}, ou un chemin vers un répertoire local. +(Dans le cas d'une url en \texttt{http:} ou \texttt{ftp:}, un éventuel +caractère « \texttt{/} » à la fin, de même qu'une éventuelle composante +\texttt{tlpkg/} finale, sont ignorés.) + +Par exemple, vous pouvez choisir un miroir du \CTAN{} en particulier avec un +valeur comme \url{http://ctan.example.org/tex-archive/systems/texlive/tlnet/}, +en substituant le nom d'un vrai miroir et le chemine ver l'archive \TeX{} +spécifique à la place de |ctan.example.org|. La liste des miroirs du CTAN est +disponible sur \url{http://ctan.org/mirrors}. + +Si l'argument donné est local (un chemin ou une url en \texttt{file:/}) et que +les paquets sont présents à la fois sous forme de fichiers non compressés et +d'archives compressées, ces dernières seront utilisées. + +\subsection{Étapes post-installation} +\label{sec:postinstall} + +Selon les cas quelques opérations supplémentaires peuvent être nécessaires. + + +\subsubsection{Variables d'environnement sous Unix} +\label{sec:env} + +Si vous avez choisi de créer des liens symboliques dans les répertoires +standard (voir la section~\ref{sec:options}), alors il est inutile de modifier +vos variables d'environnement. Sinon, sur les systèmes Unix, le répertoire +contenant les binaires pour votre plateforme doit être ajouté au \envname{PATH}. +(Sous Windows, l'installateur s'en occupe, il n'y a rien à faire.) + +À chaque architecture correspond un sous-répertoire +de \dirname{TEXDIR/bin}, voir la liste à la figure~\ref{fig:bin-text} +\pageref{fig:bin-text}. + +Si vous voulez que votre système trouve les fichiers de documentation +concernant \TL{} aux formats man et Info, il faut également ajuster les +variables \envname{MANPATH} et \envname{INFOPATH}. Sur certains systèmes, ceci +ne sera pas nécessaire et il suffira de régler le \envname{PATH} pour que les +pages de man et d'Info soient trouvées. + +Pour les \textit{shells} dits « Bourne-compatible » tels que +\prog{bash} sous GNU/Linux, le fichier à éditer peut être +\filename{\$HOME/.bash_profile} ou \filename{\$HOME/.profile} et les lignes à +ajouter sont de la forme suivante : + +\begin{sverbatim} +PATH=/usr/local/texlive/2012/bin/i386-linux:$PATH; export PATH +MANPATH=/usr/local/texlive/2012/texmf/doc/man:$MANPATH; export MANPATH +INFOPATH=/usr/local/texlive/2012/texmf/doc/info:$INFOPATH; export INFOPATH +\end{sverbatim} +%stopzone + +Pour les \textit{shells} \prog{csh} ou \prog{tcsh}, le fichier à éditer +est en principe \filename{$HOME/.cshrc} %$ +et les lignes à ajouter sont de la forme suivante : +\begin{sverbatim} +setenv PATH /usr/local/texlive/2012/bin/i386-linux:$PATH +setenv MANPATH /usr/local/texlive/2012/texmf/doc/man:$MANPATH +setenv INFOPATH /usr/local/texlive/2012/texmf/doc/info:$INFOPATH +\end{sverbatim} + +Si vous avez déjà des réglages concernant ces variables dans vos fichiers de +configurations, il suffit bien sûr d'y rajouter les répertoires concernant +\TL{}. + +\subsubsection{Variables d'environnement : configuration multi-utilisateur} +\label{sec:envglobal} + +Il est possible d'ajuster les variables \envname{PATH}, \envname{MANPATH} +et \envname{INFOPATH} globalement pour tous les utilisateurs présents et +futurs sans avoir à éditer les fichiers personnels de chacun mais les façons +de le faire sont trop différentes d'un système à l'autre pour être présentées +ici. + +Voici quelques pistes : pour \envname{MANPATH} chercher un fichier +\filename{/etc/manpath.config}, s'il est présent lui ajouter +des lignes comme +\begin{sverbatim} +MANPATH_MAP /usr/local/texlive/2012/bin/i386-linux \ + /usr/local/texlive/2012/texmf/doc/man +\end{sverbatim} +Pour les deux autres, chercher un fichier\filename{/etc/environment}, il est +éventuellement possible d'y définir les valeurs des variables d'environnement +telles que \envname{PATH} et \envname{INFOPATH}. + +Nous créons aussi à l'installation un lien symbolique nommé \code{man} dans +les répertoires des binaires Unix. Certains programmes \code{man}, comme celui +livré en standard sur \MacOSX{}, l'utilisent pour trouver automatiquement les +pages de \code{man}, rendant inutile tout réglage de \envname{MANPATH}. + +\subsubsection{Mises à jour par Internet après une installation par le \DVD} +\label{sec:dvd-install-net-updates} + +Si vous avez installé \TL{} 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 \envname{PATH} si nécessaire, comme expliqué à la section +précédente) : + +\begin{alltt} +> \Ucom{tlmgr option repository http://mirror.ctan.org/systems/texlive/tlnet} +\end{alltt} + +Ceci dit à \cmdname{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~\ref{sec:options}. + +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 +\url{http://ctan.org/mirrors}. Utilisez le chemin complet vers le répertoir +\dirname{tlnet} pour ce miroir, comme ci-dessus. + + +\htmlanchor{xetexfontconfig} % keep historical anchor working +\htmlanchor{sysfontconfig} +\subsection{Configuration des fontes pour \XeTeX\ et Lua\TeX} +\label{sec:font-conf-sys} + +\XeTeX\ et Lua\TeX\ peuvent utiliser toutes les polices installées au niveau du +système et pas seulement celles des arborescences \TeX. Pour cela, ils +utilisent des méthodes différentes mais pas tout à fait indépendantes. + +Sous Windows, les fontes livrées avec \TL\ sont automatiquement rendues +utilisables par \XeTeX, mais si vous avez installé le paquet \pkgname{xetex} +sur un système de type Unix, vous avez besoin de le configurer un peu pour que +\XeTeX{} puisse trouver les fontes installées par \TL{} par leur nom sans être +obligé d'utiliser le nom du fichier. + +Pour faciliter ce réglage, lorsque le paquet \pkgname{xetex} est installé, un +fichier de configuration adéquat est créé : +\filename{TEXMFSYSVAR/fonts/conf/texlive-fontconfig.conf}. + +Pour permettre à votre système l'accès aux polices \TL, si vous avez les +privilèges suffisants, vous pouvez procéder ainsi : +\begin{enumerate*} +\item Copiez le fichier \filename{texlive-fontconfig.conf} dans +\dirname{/etc/fonts/conf.d/09-texlive.conf}. +\item Exécutez \Ucom{fc-cache -fsv}. +\end{enumerate*} + +Si vous n'avez pas les privilèges suffisants pour utiliser la méthode +ci-dessus, ou si vous préférez ne rendre les polices disponibles que pour un +utilisateur, vous pouvez procéder comme suit. +\begin{enumerate*} +\item Copiez le fichier \filename{texlive-fontconfig.conf} vers + \filename{~/.fonts.conf}, où \filename{~} représente votre répertoire + personnel. +\item Exécutez \Ucom{fc-cache -fv}. +\end{enumerate*} + +Vous pouvez utiliser \code{fc-list} pour voir les noms des polices du système. +L'incantation \code{fc-list : family style file spacing} (avec ces arguments +tels quels) donne en général des informations utiles. + +\subsubsection{\ConTeXt{} Mark IV} +\label{sec:context-mkiv} + +La \og vieille\fg version de \ConTeXt{} (Mark \acro{II}) ainsi que la \og +nouvelle \fg version (Mark \acro{IV}) devraient fonctionner directement après +l'installation de \TL et ne réclamer aucune action particulière tant que vous +n'utilisez que \code{tlmgr} pour les mises à jour. + +Cependant, comme \ConTeXt{} Mk\acro{IV} n'utilise pas la bibliothèque +kpathsea, il faudra mettre à jour manuellement le cache de fichiers de +\ConTeXt{} si jamais vous installez des nouveaux fichiers manuellement +(c'est-à-dire sans utiliser \code{tlmgr}). Pour cela, exécutez +\begin{sverbatim} +context --generate +\end{sverbatim} +après chaque installation manuelle. Les fichiers résultants sont stockés dans +\code{TEXMFCACHE}, dont la valeur par défaut sous \TL{} est +\envname{TEXMFSYSVAR;TEXMFVAR}. + +\ConTeXt\ Mk\acro{IV} lira les fichiers de toutes les arborescences +mentionnées dans \envname{TEXMFCACHE} et les écrira dans le premier de ces +répertoire accessible en écriture. Lors de la lecture, les dernières +informations lues sont prises en compte de façon prioritaire par rapport à +celles lues précédemment, dans le cas où certaines données de cache seraient +dupliquées. + +Pour plus d'informations, voir +\url{http://wiki.contextgarden.net/Running_Mark_IV}. + + +\subsubsection{Ajout de fichiers locaux ou personnels} +\label{sec:local-personal-macros} + +Comme cela a déjà été indiqué à la section~\ref{sec:texmftrees}, +\envname{TEXMFLOCAL} (par défaut \dirname{/usr/local/texlive/texmf-local} ou +\verb|%SystemDrive%\texlive\texmf-local| sous Windows) est la racine de +l'arborescence prévue pour regrouper les fichiers de macros, les fontes et le +matériel utilisable par l'ensemble des utilisateurs du système. +D'autre part \envname{TEXMFHOME} (par défaut \dirname{\$HOME/texmf} %$ +(ou |%USERPROFILE%\texmf|) regroupe le matériel personnel de chaque +utilisateur. + +Dans les deux cas, les fichiers ajoutés doivent être placés, non pas en vrac à +la racine de \envname{TEXMFLOCAL} ou \envname{TEXMFHOME} mais dans des +sous-répertoires bien choisis (voir \url{http://tug.org/tds} ou lire le +fichier \filename{texmf.cnf}). Par exemple, une classe ou une extension +\LaTeX{} ne sera trouvée que si elle est dans \dirname{TEXMFLOCAL/tex/latex} ou +\dirname{TEXMFHOME/tex/latex} ou dans un sous-répertoire de ceux-ci. + +Enfin, si les ajouts ont été faits sous \envname{TEXMFLOCAL}, il y a lieu de +régénérer les bases de données \filename{ls-R} (commande \cmdname{mktexlsr} +ou, en mode graphique, bouton « Reinit file database » du gestionnaire de +paquets \TL). + +L'emplacement des répertoires \envname{TEXMFLOCAL} et \envname{TEXMFHOME} est +fixe (il ne change pas d'une version à l'autre de \TL{}). Leur contenu est +pris en compte par toutes les versions de \TL{} aussi est-il préférable de ne +pas changer la valeur des variables \envname{TEXMFLOCAL} et \envname{TEXMFHOME} +à l'installation. + +Par défaut, chacune de ces variables est définie comme étant un seul +répertoire, comme illustré ci-dessus. Cependant, ceci n'est pas obligatoire. +Si vous voulez par exemple changer rapidement de versions pour des paquets +importants vous pouvez maintenir plusieurs arborescences pour votre usage +personne, en spécifiant dans \dirname{TEXMFHOME} une liste de répertoires +entre accolades, séparés par des virgules : + +\begin{verbatim} + TEXMFHOME = {/my/dir1,/mydir2,/a/third/dir} +\end{verbatim} + +La section~\ref{sec:brace-expansion} décrit plus en détails la façon dont sont +traitées de telles listes entre accolades. + +\subsubsection{Ajout de fontes externes à \TL{}} + +Cette question est malheureusement trop complexe pour être abordée ici. +Renoncez-y sauf si vous connaissez bien les arcanes d'une installation \TeX. +Vérifiez en premier lieu ce qui existe déjà en libre : voir la +section~\ref{sec:tl-fonts}. + +Une alternative possible est d'utiliser \XeTeX{} ou Lua\TeX{} (voir +section~\ref{sec:tex-extensions}) qui permettent l'accès aux fontes disponibles +sur le système sans aucune installation supplémentaire. + +Si vous ne pouvez pas y couper, le document essayant au mieux de décrire la +procédure est \url{http://tug.org/fonts/fontinstall.html}. Si vous maintenez +vos propres associations de fontes (fichiers \code{.map}) localement, la +commande \texttt{tlmgr generate updmap} pourrait \emph{éventuellement} vous +être utile ; consultez la documentation de \cmdname{tlmgr} pour les détails. + + +\subsection{Tester l'installation} +\label{sec:test-install} + +Une fois l'installation de \TL{} terminée, il faut la tester avant de créer +des documents ou des fontes. Les tests doivent être faits par un utilisateur +non privilégié (autre que \eng{root}). + +On donne ici quelques procédures de base pour vérifier que le nouveau +système est opérationnel. On les décrit pour Unix ; pour \MacOSX{} ou +Windows, il vaut mieux tester au travers d'une interface graphique +mais les principes sont les mêmes. + +\begin{enumerate} + +\item S'assurer en premier lieu que le programme \cmdname{tex} fonctionne : + +\begin{alltt} +> \Ucom{tex -{}-version} +TeX 3.1415926 (TeX Live ...) +kpathsea version 6.0.1 +Copyright ... D.E. Knuth. +... +\end{alltt} + +Si la réponse est \texttt{command not found} ou si le numéro de version est +différent, il est fort probable que vous n'ayez pas le bon répertoire +de binaires dans votre \envname{PATH}. +Voir les informations sur l'environnement page~\pageref{sec:env}. + +\item Traiter un fichier \LaTeX{} simple : + +\begin{alltt} +> \Ucom{latex sample2e.tex} +pdfTeX 3.1415926-... (TeX Live ...) +... +Output written on sample2e.dvi (3 pages, 7484 bytes). +Transcript written on sample2e.log. +\end{alltt} +Si le fichier \filename{sample2e.tex} ou d'autres ne sont pas trouvés, +il y a probablement des interférences avec vos anciennes variables +d'environnement ou fichiers de configuration. Pour analyser en détail +votre problème, vous pouvez demander à \TeX{} de dire exactement ce +qu'il cherche et trouve ; voir la section~\ref{sec:debugging} +page~\pageref{sec:debugging}. + +\item Prévisualiser les résultats : +\begin{alltt} +> \Ucom{xdvi sample2e.dvi} # Unix +> \Ucom{dviout sample2e.dvi} # Windows +\end{alltt} +Une nouvelle fenêtre doit s'ouvrir et montrer un joli document expliquant les +bases de \LaTeX{} (document dont la lecture attentive est recommandée si vous +êtes débutant !). +Vous devez travailler sous X pour que \cmdname{xdvi} fonctionne. Dans le cas contraire, votre +variable d'environnement \envname{DISPLAY} ne sera pas correcte et vous +obtiendrez l'erreur \samp{Can't open display}. + +\item Créer un fichier \PS{} pour l'imprimer ou l'afficher : + +\begin{alltt} +> \Ucom{dvips sample2e.dvi -o sample2e.ps} +\end{alltt} + +\item Créer un fichier \acro{PDF} au lieu de \dvi{} ; +cet exemple traite le fichier \filename{sample2e.tex} et crée directement +un fichier \acro{PDF} : + +\begin{alltt} +> \Ucom{pdflatex sample2e.tex} +\end{alltt} + +\item Prévisualiser le fichier \acro{PDF} : + +\begin{alltt} +> \Ucom{gv sample2e.pdf} +\textrm{ou} +> \Ucom{xpdf sample2e.pdf} +\end{alltt} + +Ni \cmdname{gv} ni \cmdname{xpdf} ne sont inclus dans +\TL{}, aussi devez-vous les installer séparément si ce n'est déjà fait. +Voir respectivement +\url{http://www.gnu.org/software/gv} et +\url{http://www.foolabs.com/xpdf}. Il y a bien d'autres lecteurs de +fichiers \acro{PDF} ; pour Windows, nous recommandons Sumatra PDF +(\url{http://blog.kowalczyk.info/software/sumatrapdf}). + + +\item Autres fichiers de tests utiles en plus de \filename{sample2e.tex} : + +\begin{ttdescription} + +\item [small2e.tex] à compiler avant \filename{sample2e} si celui-ci pose des + problèmes. + +\item [testpage.tex] teste que l'imprimante n'introduit pas de décalages. + +\item [nfssfont.tex] imprime des tables des fontes et des tests. +\item [testfont.tex] aussi pour les tables de fontes mais en (plain)\TeX. +\item [story.tex] le fichier de test de (plain)\TeX{} le plus canonique +de tous. Il faut taper \samp{\bs bye} à l'invite \code{*} après +\samp{tex story.tex}. +\end{ttdescription} + +\item Si vous avez installé le paquet \pkgname{xetex}, vous pouvez vérifier + s'il a bien accès aux polices du système ainsi +\begin{alltt} +> \Ucom{xetex opentype-info.tex} +This is XeTeX, Version 3.1415926\dots +... +Output written on opentype-info.pdf (1 page). +Transcript written on opentype-info.log. +\end{alltt} +(De même pour \filename{luatex}.) + +Si vous obtenez un message d'erreur disant « \samp{Invalid fontname `Latin Modern +Roman/ICU'\dots} », alors vous devez revoir la configuration de votre système +pour que \XeTeX{} puisse accéder aux polices livrées avec \TL comme indiqué en +section~\ref{sec:font-conf-sys}. + +\end{enumerate} + +\subsection{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 +\url{http://tug.org/begin.html}. + +% liens GUTenberg + +Voici quelques liens vers d'autres outils qui peuvent être utiles à installer. +\begin{description} +\item[Ghostscript] \url{http://www.cs.wisc.edu/~ghost/} +\item[Perl] \url{http://www.perl.org/} avec des paquets supplémentaires du + \acro{CPAN}, \url{http://www.cpan.org/} +\item[ImageMagick] \url{http://www.imagemagick.com} pour les conversions entre + formats graphiques, notamment. +\item[NetPBM] \url{http://netpbm.sourceforge.net/} également pour les + graphiques. + +\item[É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). + \begin{itemize*} + \item \cmdname{GNU Emacs} existe en version native pour Windows, + \url{http://www.gnu.org/software/emacs/windows/ntemacs.html}. + \item \cmdname{Emacs} avec Auc\TeX\ pour Windows est disponible sur le + \CTAN. Sa page est \url{http://www.gnu.org/software/auctex}. + \item \cmdname{LEd} (Windows seulement, non libre) est disponible sur + \url{http://mirror.ctan.org/support/LEd}. + \item \cmdname{SciTE} (Windows seulement) est disponible sur + \url{http://www.scintilla.org/SciTE.html}. + \item \cmdname{Texmaker} est disponible sur + \url{http://www.xm1math.net/texmaker/index_fr.html }. + \item \cmdname{TexmakerX} est un \eng{fork} de \cmdname{Texmaker} avec des + fonctionnalités supplémentaires : \url{http://texmakerx.sourceforge.net}. + \item \cmdname{TeXnicCenter} est disponible sur + \url{http://www.texniccenter.org} et dans la distribution pro\TeX{}t + \item \cmdname{TeXworks} est disponible sur + \url{http://tug.org/texworks} et inclus dans \TL sur Windows et + \MacOSX. + \item \cmdname{Vim} est disponible sur \url{http://www.vim.org}. + \item \cmdname{WinEdt} (Windows seulement, non libre) est disponible sur + \url{http://tug.org/winedt} or \url{http://www.winedt.com}. + \item \cmdname{WinShell} (Windows seulement) est disponible sur + \url{http://www.winshell.de}. + \end{itemize*} +\end{description} +Voir \url{http://tug.org/interest.html} pour une liste plus complète de +programmes. + + +\section{Installations spécialisées} + +Les sections précédentes décrivaient le processus pour installation \og +normale \fg. Celle-ci concerne des cas plus spécialisés. + +\htmlanchor{tlsharedinstall} +\subsection{Installation partagée entre plusieurs utilisateurs ou machines} +\label{sec:sharedinstall} + +\TL a été conçue pour pouvoir être partagée par plusieurs utilisateurs sur le +même système et/ou différents systèmes sur un réseau. +Avec la disposition standard des répertoires, aucun chemin n'est +codé en dur : les emplacements des fichiers dont \TL a besoin sont trouvés +automatiquement à partir des emplacements des programmes. Vous pouvez le +constater dans le fichier de configuration principal +\filename{\$TEXMFMAIN/web2c/texmf.cnf}, qui contient des lignes comme +\begin{sverbatim} +TEXMFMAIN = $SELFAUTOPARENT/texmf +... +TEXMFLOCAL = $SELFAUTOPARENT/../texmf-local +\end{sverbatim} +Ceci signifie qu'il suffit aux utilisateurs d'ajouter à leur \envname{PATH} le +chemin des exécutables pour leurs plate-formes, pour obtenir une configuration +qui marche. + +Pour la même raison, vous pouvez aussi installer \TL localement et ensuite +déplacer l'arborescence complète vers un emplacement réseau. + +Pour Windows, un exemple de script d'installation nommé \filename{w32client} +peut être téléchargé sur \url{http://tug.org/texlive/w32client.html}. Il +installe les réglages et les raccourcis pour utiliser un système \TL installé +sur un réseau local. Il déclare aussi un désinstallateur \filename{w32client}, +disponible dans la même archive zip. Consultez la page web pour plus de +détails. + +\htmlanchor{tlportable} +\section{Installations « portable » de \TL} +\label{sec:portable-tl} + +L'option \code{-portable} de l'installateur (ou la commande \code{V} dans +l'installateur en mode texte ou l'option correspondante en mode grapghique) +crée une installation de \TL{} entièrement contenue dans une seul répertoire +et n'effectue 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. + +Pour utiliser \TeX\ depuis cette installation portable, il suffit d'ajouter le +bon répertoire de binaires à votre \code{path} pour la session de terminal en +cours, comme d'habitude. Sous Windows, vous pouvez double-cliquer sur le +fichier \filename{tl-tray-menu} à la racine de l'installation pour choisir +parmi quelques actions communes, comme dans cette capture d'écran : + +\medskip +\tlpng{tray-menu}{4cm} +\smallskip + +\noindent L'entrée « More\dots » explique comment personnaliser ce menu. + +\htmlanchor{tlisoinstall} +\subsection{Installation sur \DVD ou image \ISO} +\label{sec:isoinstall} + +Si vous n'avez pas besoin de mettre à jour ni de modifier votre installation +souvent, et/ou que vous désirez utiliser \TL{} sur plusieurs systèmes, il peut +être commode de créer une image \ISO\ de votre installation \TL, pour les +raisons suivantes : + +\begin{itemize} + \item il est nettement plus rapide de copier d'une machine à l'autre une + image \ISO\ qu'une installation classique ; + \item si vous êtes en multi-boot sur plusieurs systèmes et voulez leur faire + partager une même installation de \TL, une image \ISO\ vous isole des + idiosyncrasies et limitations des divers systèmes de fichiers + (\acro{FAT32}, \acro{NTFS}, \acro{HFS+}). + \item les machines virtuelles peuvent monter une image \ISO\ très + simplement. +\end{itemize} + +Bien sûr vous pouvez aussi graver votre image \ISO\ sur une \DVD, si cela vous +est utile. + +Les systèmes \GNU/Linux et autres Unix de bureau, y compris \MacOSX, sont +capables de monter une image \ISO. À part ce montage, rien de change par +rapport à une installation normale sur le disque dur, voir la +section~\ref{sec:env}. + +Dans la préparation d'une telle installation, il est préférable d'omettre le +sous-répertoire avec le numéro de l'année, et d'avoir \filename{texmf-local} +au même niveau que les autres arborescences (\filename{texmf}, +\filename{texmf-dist}, etc.), ce qui est possible avec les options habituelles +de l'installateur. + +Pour une machine Windows physique (et non virtuelle) vous pouvez graver +l'\ISO\ sur un \DVD. Cependant, il est peut-être plus rentable pour vous de +vous renseigner sur les différentes options libres ou gratuites de montage +d'images \ISO. Pour \acro{XP}, Microsoft propose +\filename{winxpvirtualcdcontrolpanel}. + +Pour l'intégration au système sous Windows, vous pouvez inclure dans l'image +le script \filename{w32client} décrit en section~\ref{sec:sharedinstall} et à +l'adresse \url{http://tug.org/texlive/w32client.html} ; il fonctionne aussi +bien pour une image \ISO\ que pour une installation partagée par le réseau. + +Sous \MacOSX, TeXshop et \TeX{}works peuvent utiliser une telle installation +si un lien symbolique \filename{/usr/texbin} existe et pointe vers le bon +répertoire, par exemple +\begin{verbatim} +sudo ln -s /Volumes/MyTeXLive/bin/universal-darwin /usr/texbin +\end{verbatim} + +Remarque historique : \TL\ 2010 a été la première édition à ne pas être +distribuée en version « live ». Cependant, toutes les éditions précédentes +exigeaient quelques acrobaties pour être utilisées depuis le \DVD ; en +particulier il n'y avait pas moyen de s'en sortir sans devoir régler au moins +une variable d'environnement supplémentaire. Si vous créez votre \ISO\ ou +\DVD\ depuis une installation existante ceci n'est plus nécessaire. + +\htmlanchor{tlmgr} +\section{Maintenance de l'installation avec \cmdname{tlmgr}} +\label{sec:tlmgr} + +\begin{figure}[tb] +\tlpng{tlmgr-gui}{\linewidth} +\caption{\prog{tlmgr} en mode graphique. La liste des paquets, collections et + schémas d'installation n'apparaît qu'après avoir cliqué sur le bouton « + Charger le dépôt par défaut »).}% +\label{fig:tlmgr-gui} +\end{figure} + +\begin{figure}[tb] +\hbox to \hsize{% + \vtop{\hsize=.59\linewidth + \null % make figures align at the top + \tlpng{tlmgr-general-options}{\hsize} + \caption{\texttt{tlmgr} en mode graphique : options générales} + \label{fig:tlmgr-general-options} + } + \hfil + \vtop{\hsize=.39\linewidth + \null + \tlpng{tlmgr-paper-options}{\hsize} + \caption{\texttt{tlmgr} en mode graphique : options de taille du papier} + \label{fig:tlmgr-paper-options} + } +} +\end{figure} + +\TL fournit un programme appelé \prog{tlmgr} pour assurer la maintenance de la +distribution après son installation initiale. Les programmes \prog{updmap}, +\prog{fmtutil} et \prog{texconfig} ont été conservés et le seront à l'avenir, +mais \prog{tlmgr} est désormais considéré comme l'interface standard pour ces +opérations. \prog{tlmgr} permet en particulier +\begin{itemize} +\item d'installer, de mettre à jour ou de désinstaller des paquets + individuellement, éventuellement en respectant les dépendances ; +\item de rechercher des paquets, d'obtenir leur liste, etc. ; +\item de voir la liste des plate-formes binaires et d'en installer ou d'en + supprimer ; +\item de modifier la configuration, par exemple la taille du papier par défaut, + le dépôt de paquets par défaut (voir la section~\ref{sec:location}). +\end{itemize} + +\subsection{\cmdname{tlmgr} en mode graphique} + +On lance \prog{tlmgr} en mode graphique (figure~\ref{fig:tlmgr-gui}) par la +commande +\begin{alltt} +> \Ucom{tlmgr -gui} +\end{alltt} +ou sous Windows dans le menu « Démarrer » : \texttt{Démarrer} $\rightarrow$ +\texttt{Programmes} $\rightarrow$ \texttt{TeX Live 2012} $\rightarrow$ +\texttt{TeX Live Manager}. +La première chose à faire est de cliquer sur le bouton « Load% +\footnote{Dans la description qui suit, le nom des boutons est celui de la + version anglaise par souci de cohérence avec les figures. L'affichage se + fait normalement dans la langue de l'utilisateur (variable \envname{LANG} + sous Unix).} » ce qui affiche la liste des collections, extensions, etc. (à +condition bien sûr qu'il soit possible de se connecter au dépôt utilisé). + +Les figures~\ref{fig:tlmgr-general-options} et~\ref{fig:tlmgr-paper-options} +montrent les écrans de réglage des options générales et de celles concernant +la taille du papier. + +\subsection{Exemples d'utilisation de \cmdname{tlmgr} en ligne de commande} + +Après l'installation initiale, vous pouvez mettre à jour votre système en +utilisant : + +\begin{alltt} +> \Ucom{tlmgr update -all} +\end{alltt} +Si cela vous inquiète, vous pouvez commencer par +\begin{alltt} +> \Ucom{tlmgr update -all -dry-run} +\end{alltt} +ou (moins bavard) : +\begin{alltt} +> \Ucom{tlmgr update -list} +\end{alltt} + +L'exemple suivant, plus complexe, ajoute une collection, pour le moteur +\XeTeX, depuis un dépôt local. + +\begin{alltt} +> \Ucom{tlmgr -repository /local/mirror/tlnet install collection-xetex} +\end{alltt} +La sortie, abrégée, ressemble à ceci : +\begin{fverbatim} +install: collection-xetex +install: arabxetex +... +install: xetex +install: xetexconfig +install: xetex.i386-linux +running post install action for xetex +install: xetex-def +... +running mktexlsr +mktexlsr: Updating /usr/local/texlive/2012/texmf/ls-R... +... +running fmtutil-sys --missing +... +Transcript written on xelatex.log. +fmtutil: /usr/local/texlive/2012/texmf-var/web2c/xetex/xelatex.fmt installed. +\end{fverbatim} +Comme vous pouvez le constater, \prog{tlmgr} prend en compte les dépendances +et effectue automatiquement toutes les opérations nécessaires, comme la mise à +jour des bases de données de fichiers 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. +\begin{alltt} +> \Ucom{tlmgr show collection-latexextra} +\end{alltt} +Elle retourne par exemple : +\begin{fverbatim} +package: collection-latexextra +category: Collection +shortdesc: LaTeX supplementary packages +longdesc: A large collection of add-on packages for LaTeX. +installed: Yes +revision: 14675 +\end{fverbatim} + +Enfin, le plus important, pour la documentation complète, consultez +\url{http://tug.org/texlive/tlmgr.html}, ou tapez : +\begin{alltt} +> \Ucom{tlmgr help} +\end{alltt} + +\section{Notes concernant Windows} +\label{sec:windows} + +\subsection{Fonctionnalités supplémentaires à l'installation} +\label{sec:winfeatures} + +Sous Windows le programme d'installation effectue quelques tâches +supplémentaires : +\begin{description} +\item[Menus et raccourcis] -- un sous-menu «\TL{}» est ajouté au menu + « Démarrer », contenant des entrées pour quelques programmes graphiques + comme \prog{tlmgr}, \prog{texdoctk}, PS\_View (\prog{psv}) et pour de la + documentation. +\item[Associations de fichiers] -- si cette option n'est pas désactivée, + \prog{TeXworks}, \prog{Dviout} et \prog{PS\_view} deviennent le programme + par défaut pour ouvrir leurs types de fichiers respectifs, ou, s'il y a déjà + un tel programme, sont ajoutés à la liste « Ouvrir avec... » du menu + contextuel. +\item[Convertisseur bitmap vers eps] -- une entrée \cmdname{bitmap2eps} est + ajoutée à l'entrée « Ouvrir avec... » du menu contextuel pour de nombreux + formats d'images bitmap. \prog{Bitmap2eps} est un script simple qui utilise + \cmdname{sam2p} ou \cmdname{bmeps} pour faire le vrai travail. +\item[Ajustement automatique du \code{path}] -- aucune intervention manuelle + n'est nécessaire. +\item[Désinstallation] -- une entrée est ajoutée pour \TL{} dans le menu + « Ajout et suppression de programmes ». L'onglet « Uninstall » de + \prog{tlmgr} renvoie à ceci. +\end{description} + +\subsection{Programmes supplémentaires} + +Pour être complète, une installation \TL a besoin de quelques utilitaires qui +ne sont pas présents en général sur les machines Windows. \TL comprend donc +les outils suivants. +\begin{description} +\item[Perl et Ghostscript] -- \TL{} installe des copies « cachées » de ces + programmes : ce sont des versions spécifiques adaptées à \TL{}, elles + sont invisibles hors de \TL{} et n'interfèrent donc en aucune façon avec + d'autres versions éventuellement présentes sur la machine. + +\item[PS\_View] -- nouveau lecteur PostScript et \acro{PDF} sous licence libre, + voir figure~\ref{fig:psview}. + +\begin{figure}[tb] \centering +\tlpng{psview}{.6\linewidth} +\caption{PS\_View: de très forts grossissements sont possibles !}% +\label{fig:psview} +\end{figure} + +\item[dviout] -- lecteur de \acro{DVI}. La première fois que vous + visualisez un fichier avec \prog{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). + +\item[\TeX{}works] \TeX{}works est un éditeur conçu pour les fichiers \TeX, avec + un lecteur de \acro{PDF} intégré. + +\item[Outils en ligne de commande] -- des versions pour Windows de programmes + Unix sont installées, en particulier \cmdname{gzip}, \cmdname{chktex}, + \cmdname{jpeg2ps}, \cmdname{unzip}, \cmdname{wget} et quelques utilitaires + de la suite \cmdname{xpdf} (\cmdname{pdfinfo}, \cmdname{pdffonts}, \ldots). + Le lectuer \cmdname{xpdf} lui-même n'est pas disponible + sous Windows mais vous pouvez télécharger Sumatra \acro{PDF}, qui est basé + dessus, voir \url{http://blog.kowalczyk.info/software/sumatrapdf}). +\item[\prog{fc-list}, \prog{fc-cache}, etc.] -- outils de la bibliothèque + fontconfig, qui permettent à \XeTeX{} d'accéder aux polices système sous + Windows. Vous pouvez utiliser \prog{fc-list} pour connaître la liste des + noms de police utilisables avec la commande \cs{font} de \XeTeX. +\end{description} + +\subsection{Répertoire personnel} +\label{sec:winhome} + +L'équivalent du répertoire personnel noté \envname{\$HOME} sous +Unix s'appelle \verb|%USERPROFILE%| sous Windows. % +Cette variable vaut en général +\verb|C:\Documents and Settings\<username>| sous Windows \acro{XP} +et \verb|C:\Utilisateurs\<username>| sous Vista et Windows 7. +La notation \verb|~|, utilisée dans \filename{texmf.cnf} et dans \KPS{} en +général pour désigner un répertoire personnel, est correctement interprétée +sous Windows comme sous Unix. + + +\subsection{Base de registre Windows} +\label{sec:registry} +%NdT% choix : "registre", pas "registres" + +Windows stocke pratiquement tous les paramètres de configuration 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 +\path{HKEY_CURRENT_USER} et \path{HKEY_LOCAL_MACHINE}, \path{HKCU} et +\path{HKLM} en abrégé. La partie \path{HKCU} de la base de registre +se trouve dans le répertoire personnel de l'utilisateur (voir +section~\ref{sec:winhome}). La partie \path{HKLM} est normalement dans un +sous-répertoire du répertoire Windows. + +Certaines informations système peuvent s'obtenir à partir des variables +d'environnement mais pour d'autres, la localisation des raccourcis par +exemple, la consultation de la base de registre est indispensable. +La modification des variables d'environnement nécessite l'accès à la base de +registre. + + +\subsection{Droits d'accès sous Windows} +\label{sec:winpermissions} + +Dans les versions récentes de Windows, la distinction est faite entre +« utilisateurs » et « administrateurs », ces derniers ayant accès en écriture +à la totalité du système. En pratique on devrait plutôt parler d'utilisateurs +« non privilégiés » et d'utilisateurs « normaux » car être « administrateur » +est la règle et non l'exception. + +Nous nous sommes efforcés de rendre l'installation de \TL{} possible aux +utilisateurs non privilégiés. + +Si celui qui fait l'installation est « administrateur », il dispose d'une +option d'installation pour tous les utilisateurs : si cette option est +choisie, les raccourcis +et les entrées de menu sont créés pour tous les utilisateurs, et +l'environnement est modifié au niveau du système. +Sinon, les raccourcis et entrées de menu sont créés pour l'utilisateur +courant, et seul son environnement utilisateur est modifié. + +Dans tous les cas, le répertoire proposé comme racine de l'installation est +\verb|%SystemDrive%|. % +Le programme \prog{install-tl} vérifie si le répertoire choisi comme racine +est accessible en écriture pour celui qui procède à l'installation. + +Lorsqu'une installation \TeX{} est présente sur la machine, l'installation +de \TL{} par un utilisateur non privilégié est problématique : +cet utilisateur n'aura jamais accès aux exécutables \TL{} car la recherche +s'effectue d'abord dans les répertoires système, puis dans les répertoires de +l'utilisateur. Une parade sommaire a été prévue : l'installateur crée un +raccourci vers une fenêtre de ligne de commande où les exécutables \TL sont +prioritaires : \TL{} est ainsi utilisable en ligne de commande à partir de ce +raccourci. De même, le raccourci pour \TeX{}works, s'il est installé, fait ce +qu'il faut pour que les outils \TL soient utilisés. + +Pour Vista et Windows~7, il y a une subtilité supplémentaire : 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 d'utiliser l'entrée « exécuter en tant +qu'administrateur ». + + +\subsubsection{Augmentation de la limite de mémoire sous Windows et Cygwin} +\label{sec:cygwin-maxmem} + +Les utilisateurs de Windows et Cygwin (voir la section~\ref{sec:cygwin} pour +les spécificités de l'installation sous Cygwin) peuvent parfois arriver à court +de mémoire en utilisant certains des programmes fournis avec \TL. Par exemple, +\prog{asy} peut manquer de mémoire si vous essayez d'allouer un tableau de +25\,000\,000 réels, et Lua\TeX\ 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 +(\url{http://www.cygwin.com/cygwin-ug-net/setup-maxmem.html}). + +Pour Windows, il vous faudra créer un fichier, nommé par exemple +\code{ajoutmemoire.ref}, contenant les quatre lignes suivantes. + +\begin{sverbatim} +Windows Registry Editor Version 5.00 + +[HKEY_LOCAL_MACHINE\Software\Cygwin] +"heap_chunk_in_mb"=dword:ffffff00 +\end{sverbatim} + +\noindent puis exécuter la commande \code{regedit /s ajoutmemoire.reg} en tant +qu'administrateur. (Si vous souhaitez modifier la limite mémoire uniquement +pour l'utilisateur courant plutôt qu'au niveau du système, utilisez +\code{HKEY\_CURRENT\_USER}.) + + +\section{Guide d'utilisation du système Web2C} + +\Webc{} est une collection intégrée de programmes relatifs à \TeX, +c.-à-d. \TeX{} lui-même, \MF{}, \MP, \BibTeX{}, etc. +C'est le cœur de \TL{}. Le site de référence est \url{http://tug.org/web2c}. + +Un peu d'histoire : la première implémentation a été réalisée par Tomas +Rokicki qui, en 1987, a développé un premier système \TeX{}-to-C en adaptant +les \textit{change files} pour Unix (travail de Howard Trickey et Pavel Curtis +principalement). Tim Morgan assura la maintenance du système, dont le nom fut +remplacé durant cette période par Web-to-C. En 1990, Karl Berry reprit le +travail, assisté par des dizaines de contributeurs et en 1997 il passa le +relais à Olaf Weber qui le rendit à Karl en 2006. + +%NdT% ci-dessous, "sources originales", on ne pense pas au /fichiers/ source. +% (enfin, je crois... (mpg)) +Le système \Webc{} fonctionne sur Unix, sur les systèmes Windows 32 bits, +sur \MacOSX{} 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 : + +\begin{cmddescription} +\item[bibtex] -- gère les bibliographies. +\item[dvicopy] -- copie le fichier \dvi{} en supprimant les fontes virtuelles. +\item[dvitomp] -- convertit le fichier \dvi{} en MPX (dessins \MP{}). +\item[dvitype] -- convertit le fichier \dvi{} en un texte lisible. +\item[gftodvi] -- visualisation de fontes génériques GF. +\item[gftopk] -- convertit les fontes génériques GF en fontes bitmap PK. +\item[gftype] -- convertit le fichier GF en un texte lisible. +\item[mf] -- création de fontes. +\item[mft] -- mise en page de code source \MF{}. +\item[mpost] -- création de diagrammes techniques. +\item[patgen] -- création de motifs de césure. +\item[pktogf] -- convertit les fontes bitmap PK en fontes génériques GF. +\item[pktype] -- convertit les fontes PK en un texte lisible. +\item[pltotf] -- convertit les fichiers PL (lisibles) en TFM. +\item[pooltype] -- affiche les fichiers \web{} pool. +\item[tangle] -- \web{} vers Pascal. +\item[tex] -- composition de textes. +\item[tftopl] -- convertit les fichiers TFM en PL (lisibles). +\item[vftovp] -- convertit les fontes virtuelles VF en VPL (lisibles). +\item[vptovf] -- convertit les fontes VPL en fontes virtuelles VF. +\item[weave] -- \web{} vers \TeX. +\end{cmddescription} + +La syntaxe et les fonctions précises de ces programmes sont décrites dans +la documentation des composants individuels et dans le manuel \Webc{} +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 \Webc{}. + + Presque tous ces programmes suivent les options standard de \GNU : +\begin{description} + \item[\texttt{-{}-help}] imprime le sommaire de l'utilisation, + \item[\texttt{-{}-verbose}] imprime le rapport détaillé du processus, + \item[\texttt{-{}-version}] imprime seulement le numéro de version. +\end{description} + +Pour localiser les fichiers, les programmes \Webc{} utilisent la bibliothèque +de recherche \KPS{} (\url{http://tug.org/kpathsea}). Cette bibliothèque +utilise une combinaison de variables d'environnement et un certain nombre de +fichiers de paramètres pour optimiser la recherche dans l'énorme arborescence +\TeX{}. \Webc{} peut exécuter une recherche dans plusieurs arborescences +simultanément, ce qui est utile si l'on souhaite maintenir la distribution +standard de \TeX{} et les extensions locales dans deux arborescences +distinctes. Afin d'accélérer la recherche de fichiers, la racine de chaque +arborescence possède un fichier \file{ls-R} contenant une entrée donnant le +nom et le chemin de chaque fichier situé sous la racine. + +\subsection{Kpathsea et la recherche de fichiers} +\label{sec:kpathsea} + +Décrivons en premier lieu le mécanisme de recherche de la bibliothèque \KPS{}. + +Nous appelons \emph{chemin de recherche} une liste d'éléments, séparés par +« deux-points» ou « point-virgule», et appelés +\emph{éléments de chemin}, qui sont des noms de répertoires. +Un chemin de recherche peut provenir de plusieurs sources. +Pour rechercher un fichier \samp{my-file} le long +d'un chemin \samp{.:/dir}, \KPS{} vérifie chaque élément du chemin : +d'abord \filename{./my-file}, puis \filename{/dir/my-file} et renvoie la +première occurrence (voire toutes). + +Afin d'optimiser l'adaptation à tous les systèmes d'exploitation, \KPS{} peut +utiliser dans les noms de fichiers des séparateurs différents de deux-points +(\samp{:}) et barre oblique (\samp{/}) pour les systèmes non-Unix. + +Pour vérifier un élément de chemin particulier \var{p}, \KPS{} +vérifie d'abord si une base de données existante (voir +page~\pageref{sec:filename-database}) contient \var{p}, +c.-à-d. si la base de données se trouve dans un +répertoire qui est un préfixe de \var{p}. Si oui, la spécification +du chemin est comparée avec le contenu de la base de données. + +Si la base de données n'existe pas, si elle ne s'applique pas à cet élément de +chemin ou si elle ne contient aucune correspondance, la recherche est lancée +sur tout le système de fichiers (si cela n'a pas été interdit par une commande +commençant par \samp{!!} et si le fichier cherché est censé exister). \KPS{} +construit la liste des répertoires qui correspondent à cet élément de chemin, +puis cherche le fichier dans chaque élément de cette liste. + +La condition « le fichier est censé exister » est liée aux fichiers~\samp{.vf} +et aux fichiers d'entrée lus par la commande \TeX\ \cs{openin}. De tels +fichiers peuvent ne pas exister (par exemple \file{cmr10.vf}), il est donc +inutile de les rechercher sur le disque. De plus, si vous n'actualisez pas le +fichier \file{ls-R} lors de l'installation d'un nouveau fichier \samp{.vf}, il +ne sera jamais trouvé. Chaque élément de chemin est alors vérifié : d'abord +dans la base de données puis sur le disque. Si une occurrence est trouvée, la +recherche s'arrête et le résultat est obtenu. + +Bien que l'élément de chemin le plus simple et le plus fréquent soit un nom de +répertoire, \KPS{} supporte d'autres types d'éléments dans les chemins de +recherche : des valeurs par défaut différentes pour chaque programme, des noms +de variables d'environnement, des valeurs de fichiers de configuration, les +répertoires de l'utilisateur et la recherche récursive de +sous-répertoires. Nous disons alors que \KPS{} \emph{étend} un élément, +c'est-à-dire que \KPS{} transforme toutes ces spécifications en noms de +répertoires de base. Cette opération est décrite dans les sections suivantes. + +Notons que si le nom de fichier cherché est absolu ou explicitement +relatif, c'est-à-dire commençant par \samp{/}, \samp{./} ou +\samp{../}, \KPS{} ne vérifie que l'existence de ce fichier. +\ifSingleColumn +\else +\begin{figure*} +\centering +\verbatiminput{examples/ex5.tex} +\setlength{\abovecaptionskip}{0pt} + \caption{Un exemple de fichier de configuration} + \label{fig:config-sample} +\end{figure*} +\fi + +\subsubsection{Les différentes sources} +\label{sec:path-sources} + +Un chemin de recherche peut provenir de plusieurs sources. Voici l'ordre +dans lequel \KPS\ les utilise. + +\begin{enumerate} +\item Une variable d'environnement définie par l'utilisateur, par exemple + \envname{TEXINPUTS}. Les variables d'environnement avec une extension + attachée (nom de programme) sont d'abord prises en compte : par exemple, si + \samp{latex} est le nom du programme exécuté, \envname{TEXINPUTS.latex} + passera avant \envname{TEXINPUTS}. +\item Un fichier de configuration de programme spécifique, par exemple une + ligne « \texttt{S /a:/b} » dans le fichier \file{config.ps} de + \cmdname{dvips}. +\item Un fichier de configuration \file{texmf.cnf} de \KPS{} contenant une + ligne telle que \\ \samp{TEXINPUTS=/c:/d} (voir ci-dessous). +\item La valeur par défaut obtenue à la compilation. +\end{enumerate} +\noindent On peut voir chacune de ces valeurs pour un chemin de recherche +donné en utilisant l'option de débogage (voir page~\pageref{sec:debugging}). + +\subsubsection{Fichiers de configuration} + +\KPS{} lit les chemins de recherche et +d'autres définitions dans des \emph{fichiers de configuration à + l'exécution} nommés \file{texmf.cnf} . Le chemin pour accéder à ces fichiers dans +l'arborescence est stocké dans la variable \envname{TEXMFCNF}, mais il n'est +pas conseillé de modifier cette variable (ou une autre) au moyen d'une +variable d'environnement du même nom. + +À la place, un fichier \file{\dots/2012/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 fichier de configuration principal est dans +\file{\dots/2012/texmf/web2c/texmf.cnf}. Vous ne devriez jamais éditer ce +fichier, car vos changements seraient alors perdus lors de futures mises à jour +de la distribution. + +Il est important de noter que \emph{tous} les fichier \file{texmf.cnf} trouvés +seront lus, et qu'en cas de conflit, la première définition lue l'emporte. Par +exemple, si les fichiers \file{texmf.cnf} sont cherchés dans le chemin +\verb|.:$TEXMF|, les valeurs de \file{./texmf.cnf} l'emportent sur celles de +\verb|$TEXMF/texmf.cnf|. + +\begin{itemize} +\item Les commentaires sont signalés par un \texttt{\%} et se terminent à la + fin de la ligne. +\item Les lignes vides sont ignorées. +\item Un \bs{} à la fin 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. +\item Toutes les autres lignes sont de la forme : +\begin{alltt} + \emph{variable}[.\emph{progname}] [=] \emph{value} +\end{alltt} + où le \samp{=} et les espaces autour sont optionnels. +\item Le nom de la \ttvar{variable} peut contenir n'importe quel caractère + autre que les espaces, \samp{=}, ou \samp{.} mais on recommande d'utiliser + \samp{A-Za-z\_} pour éviter les problèmes. +\item Si \samp{.\var{progname}} est présent, sa définition s'applique + seulement si le programme exécuté se nomme \texttt{\var{progname}} ou + \texttt{\var{progname}.exe}. Ceci permet par exemple à différentes variantes + de \TeX{} d'avoir des chemins de recherche différents. +\item \var{value} peut contenir n'importe quel caractère excepté « \code{\%} » et + \samp{@}. L'option \code{\$\var{var}.\var{prog}} n'est pas disponible à + droite du signe \samp{=} ; à la place, on doit utiliser une variable + supplémentaire. Un \samp{;}\ dans \var{value} est compris comme un \samp{:}\ + si on travaille sous Unix ; ceci est très utile et permet d'avoir un seul + \file{texmf.cnf} pour les systèmes Unix, \acro{MS-DOS} et Windows. +\item Toutes les définitions sont lues avant tout désarchivage ou + décompactage, de telle façon que les variables peuvent être référencées + avant d'être définies. +\end{itemize} +Voici un fichier de configuration illustrant les points précédents +\ifSingleColumn + +\begin{verbatim} +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;}// +\end{verbatim} + +\else +dans la figure~\ref{fig:config-sample}. +\fi + +\subsubsection{Expansion d'un chemin de recherche} +\label{sec:path-expansion} + +\KPS{} reconnaît certains caractères et constructions spéciales dans +les chemins de recherche, semblables à ceux disponibles dans les +\textit{shells} Unix. Ainsi, le chemin complexe, +\verb+~$USER/{foo,bar}//baz+ %$ +étend la recherche vers tous les sous-répertoires situés sous les +répertoires \file{foo} et \file{bar} dans le répertoire utilisateur +\texttt{\$USER} contenant un répertoire ou un fichier appelé %$ +\file{baz}. Ces expansions sont explicitées dans les sections +suivantes. + +\subsubsection{Expansion par défaut} +\label{sec:default-expansion} + +Si le chemin de recherche le plus prioritaire (voir +section~\ref{sec:path-sources}) contient un \samp{:} +\emph{supplémentaire} (\mbox{c.-à-d.} en début ou fin de ligne ou +double), \KPS{} insère à cet endroit le chemin suivant dont la +priorité définie est immédiatement inférieure. Si ce chemin inséré +possède un \samp{:} supplémentaire, le même processus se +répète pour le chemin prioritaire suivant. +Par exemple, étant donné une variable d'environnement définie ainsi + +\begin{alltt} +> \Ucom{setenv TEXINPUTS /home/karl:} +\end{alltt} +la valeur de \code{TEXINPUTS} d'après le fichier \file{texmf.cnf} étant + +\begin{alltt} + .:\$TEXMF//tex +\end{alltt} +alors la valeur finale utilisée pour la recherche sera + +\begin{alltt} + /home/karl:.:\$TEXMF//tex +\end{alltt} + +Comme il est inutile d'insérer la valeur par défaut en plusieurs +endroits, \KPS{} applique la substitution à seulement un \samp{:} +supplémentaire et laisse les autres inchangés : il cherche d'abord un +\samp{:} en début de ligne, puis en fin de ligne et enfin un double +\samp{:}. + +\subsubsection{Expansion spécifiée par les accolades} +\label{sec:brace-expansion} + +Option utile, l'expansion par le biais des accolades signifie, par exemple, +que \verb+v{a,b}w+ va permettre la recherche dans \verb+vaw:vbw+. Les +définitions emboîtées sont autorisées. Ceci peut être utilisé pour établir des +hiérarchies \TeX{} multiples en attribuant une liste entre accolades à +\code{\$TEXMF}. Par exemple, dans \file{texmf.cnf}, on trouve une définition +qui ressemble (il y a en fait plus de répertoires) à la suivante. +\begin{verbatim} + TEXMF = {$TEXMFHOME,$TEXMFLOCAL,!!$TEXMFSYSVAR,!!$TEXMFMAIN} +\end{verbatim} +Avec ceci, on peut écrire quelque chose comme +\begin{verbatim} + TEXINPUTS = .;$TEXMF/tex// +\end{verbatim} +%$ +ce qui signifie que, après avoir cherché dans le répertoire courant, les +arborescences complètes \code{\$TEXMFHOME/tex} suivie de +\code{\$TEXMFLOCAL/tex} (sur le disque) et ensuite les arborescences +\code{!!\$TEXMFVAR/tex} et \code{!!\$TEXMFMAIN/tex} +(définies dans le fichier de référence \file{ls-R} \emph{seulement}) seront +inspectées. C'est un moyen pratique permettant d'utiliser en parallèle deux +distributions \TeX{}, une « figée » (sur un \CD, par exemple) et une +autre régulièrement mise à jour avec de nouvelles versions quand elles +deviennent disponibles. En utilisant la variable \code{\$TEXMF} dans toutes +les définitions, on est toujours sûr d'inspecter d'abord l'arborescence la +plus récente. + +\subsubsection{Expansion des sous-répertoires} +\label{sec:subdirectory-expansion} + +Deux barres \samp{//} ou plus consécutives dans une partie d'un chemin suivant +un répertoire \var{d} sont remplacées par tous les sous-répertoires de +\var{d} : d'abord les sous-répertoires directement présents dans +\var{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 +\emph{non-déterminé}. + +Dans le cas où l'on spécifie une partie de nom de fichier après le +\samp{//}, seuls sont inclus les sous-répertoires auxquels le nom +correspond. Par exemple, \samp{/a//b} va correspondre aux répertoires +\file{/a/1/b}, \file{/a/2/b}, \file{/a/1/1/b} et ainsi de suite, +mais pas à \file{/a/b/c} ni \file{/a/1}. + +Des \samp{//} multiples et successifs dans un chemin sont possibles, +mais \samp{//} au début d'un chemin est ignoré. + +\subsubsection{Liste des caractères spéciaux et de leur signification : + récapitulatif} + +La liste suivante récapitule la signification des caractères spéciaux +dans les fichiers de configuration de \KPS{}. + +\newcommand{\CODE}[1]{\makebox[3em][l]{\code{#1}}} + +\begin{ttdescription} + +\item[\CODE{:}] Séparateur dans un chemin de recherche ; au début + ou à la fin d'un chemin, il remplace le chemin par défaut. + +\item[\CODE{;}] Séparateur dans les systèmes non-Unix + (joue le rôle de \code{:}). + +\item[\CODE{\$}] Substitue le contenu d'une variable. + +\item[\CODE{\string~}] Représente le répertoire racine de + l'utilisateur. + +\item[\CODE{\char`\{...\char`\}}] Expansion par les accolades, + par exemple \verb+a{1,2}b+ devient \verb+a1b:a2b+. + +\item[\CODE{//}] La recherche concernera aussi les sous-répertoires + (peut être inséré n'importe où dans un chemin sauf au début). + +\item[\CODE{\%}] Début d'un commentaire. + +\item[\CODE{\bs}] Caractère de continuation de ligne (permet les + entrées sur plusieurs lignes). + +\item[\CODE{!!}] Cherche \emph{seulement} dans la base de + données pour localiser le fichier et \emph{ne cherche pas} sur le disque. + +\end{ttdescription} + +\subsection{Les bases de données} +\label{sec:filename-database} + +\KPS{} a une certaine profondeur d'investigation pour minimiser les +accès disque durant les recherches. Néanmoins, dans le cas de +distributions comprenant beaucoup de répertoires, inspecter chaque +répertoire possible pour un fichier donné peut durer excessivement +longtemps (ceci est typiquement le cas quand plusieurs centaines de +répertoires de polices de caractères doivent être parcourus). En +conséquence, \KPS{} peut utiliser un fichier texte appelé \file{ls-R} --- en +fait une base de données construite au préalable --- qui fait correspondre +les fichiers à leur répertoire, ce qui permet d'éviter une recherche +exhaustive sur le disque. + +Un deuxième fichier appelé \file{aliases} (qui est également une base de +données) permet de donner des noms différents aux fichiers listés dans +\mbox{\file{ls-R}}. Ceci peut aider à adapter ses fichiers source aux +conventions de \acro{DOS}~8.3 pour les noms de fichiers. + +\subsubsection{Le fichier base de données} +\label{sec:ls-R} + +Comme nous l'avons expliqué ci-dessus, le nom du principal fichier-base de +données doit être \mbox{\file{ls-R}}. +Dans votre installation, vous pouvez en mettre un à la racine de chaque +arborescence \TeX{} que vous désirez voir +inspectée (\code{\$TEXMF} par défaut) ; la plupart des sites ont +une seule arborescence \TeX{}. \KPS{} cherche les fichiers \file{ls-R} +dans le chemin spécifié dans la variable \code{TEXMFDBS}. + +La meilleure façon de créer et mettre à jour le fichier \file{ls-R} +est d'exécuter le script \cmdname{mktexlsr} inclus dans la +distribution. Il est appelé par les divers scripts \cmdname{mktex}\dots\ +En principe, ce script exécute uniquement la commande +%NdT% le \ls est correct (ça sert à ignorer les alias) +\begin{alltt} +cd \var{/your/texmf/root} && \boi{}ls -1LAR ./ >ls-R +\end{alltt} +en supposant que la commande \code{ls} de votre système produise le bon +format de sortie (le \code{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 \code{cron}, de telle façon que le fichier \file{ls-R} prenne +automatiquement en compte les changements dans les fichiers +installés, par exemple après une installation ou une +mise à jour d'un composant \LaTeX{}. + +Si un fichier n'est pas trouvé dans la base de données, par défaut +\KPS{} décide de le chercher sur le disque. Par contre, si un élément du +chemin commence par \samp{!!}, \emph{seule} la base de données +sera inspectée pour cet élément, jamais le disque. + +\subsubsection{kpsewhich : programme de recherche dans une arborescence} +\label{sec:invoking-kpsewhich} + +Le programme \texttt{kpsewhich} effectue une recherche dans une +arborescence indépendamment de toute application. On peut le +considérer comme une sorte de \code{find} pour localiser des fichiers +dans les arborescences \TeX{} (ceci est largement utilisé dans les +scripts \cmdname{mktex}\dots\ de la distribution). + +\begin{alltt} +> \Ucom{kpsewhich \var{option}\dots{} \var{filename}\dots{}} +\end{alltt} +Les options spécifiées dans \ttvar{option} peuvent +commencer soit par \samp{-} soit par \samp{-{}-} ; n'importe quelle +abréviation claire est acceptée. + +\KPS{} considère tout argument non optionnel dans la ligne de commande +comme un nom de fichier et renvoie la première occurrence trouvée. Il +n'y a pas d'option pour renvoyer tous les fichiers ayant un nom +particulier (vous pouvez utiliser le \cmdname{find} d'Unix pour cela). + +Les options les plus importantes sont décrites ci-après. + +\begin{ttdescription} +\item[\texttt{-{}-dpi=\var{num}}]\mbox{} \\ + Définit la résolution à \ttvar{num} ; ceci affecte + seulement la recherche des fichiers \samp{gf} et \samp{pk}. \samp{-D} est un + synonyme pour assurer la compatibilité avec \cmdname{dvips}. Le défaut + est 600. +\item[\texttt{-{}-format=\var{name}}]\mbox{}\\ + Définit le format pour la recherche à \ttvar{name}. + Par défaut, le format est estimé en fonction du nom de fichier. + Pour les formats qui n'ont pas de suffixe clair associé, comme les + fichiers de support \MP{} et les fichiers de configuration + \cmdname{dvips}, vous devez spécifier le nom connu de \KPS, comme + \texttt{tex} ou \texttt{enc files}. Exécutez la commande + \texttt{kpsewhich -{}-help} pour obtenir la liste précise. + +\item[\texttt{-{}-mode=\var{string}}]\mbox{}\\ + Définit le nom du mode comme étant \ttvar{string} ; +ceci affecte seulement la recherche des \samp{gf} et des \samp{pk}. +Pas d'option par défaut, n'importe quel mode sera trouvé. +\item[\texttt{-{}-must-exist}]\mbox{}\\ + Fait tout ce qui est possible pour trouver les fichiers, ce qui +inclut une recherche sur le disque. Par défaut, seule la base de +données \file{ls-R} est inspectée, dans un souci d'efficacité. +\item[\texttt{-{}-path=\var{string}}]\mbox{}\\ + Recherche dans le chemin \ttvar{string} (séparé par +deux-points comme d'habitude), au lieu de prendre le chemin à partir +du nom de fichier. \samp{//} et toutes les expansions habituelles sont +supportées. + Les options \samp{-{}-path} et \samp{-{}-format} s'excluent mutuellement. +\item[\texttt{-{}-progname=\var{name}}]\mbox{}\\ + Définit le nom de programme comme étant \ttvar{name}. + Ceci peut affecter les chemins de recherche via l'option + \texttt{.\var{progname}} dans les fichiers de configuration. + Le défaut est \cmdname{kpsewhich}. +\item[\texttt{-{}-show-path=\var{name}}]\mbox{}\\ + Montre le chemin utilisé pour la recherche des fichiers de type +\ttvar{name}. + On peut utiliser soit une extension de fichier (\code{.pk}, \code{.vf}, + etc.), soit un nom de fichier, comme avec l'option \samp{-{}-format}. +\item[\texttt{-{}-debug=\var{num}}]\mbox{}\\ + Définit les options de débogage comme étant + \ttvar{num}. +\end{ttdescription} + +\subsubsection{Exemples d'utilisation} +\label{sec:examples-of-use} + +Jetons un coup d'œil à \KPS{} en action ; voici une recherche +toute simple : + +\begin{alltt} +> \Ucom{kpsewhich article.cls} +/usr/local/texmf-dist/tex/latex/base/article.cls +\end{alltt} +Nous recherchons le fichier \file{article.cls}. Puisque le suffixe +\file{.cls} est non-ambigu, nous n'avons pas besoin de spécifier que +nous voulons rechercher un fichier de type \optname{tex} (répertoires des +fichiers sources de \TeX{}). Nous le trouvons dans le sous-répertoire +\filename{tex/latex/base} du répertoire racine \samp{TEXMF}. De même, + le suffixe non-ambigu permet de trouver facilement les autres fichiers. +\begin{alltt} +> \Ucom{kpsewhich array.sty} + /usr/local/texmf-dist/tex/latex/tools/array.sty +> \Ucom{kpsewhich latin1.def} + /usr/local/texmf-dist/tex/latex/base/latin1.def +> \Ucom{kpsewhich size10.clo} + /usr/local/texmf-dist/tex/latex/base/size10.clo +> \Ucom{kpsewhich small2e.tex} + /usr/local/texmf-dist/tex/latex/base/small2e.tex +> \Ucom{kpsewhich tugboat.bib} + /usr/local/texmf-dist/bibtex/bib/beebe/tugboat.bib +\end{alltt} + +Le dernier exemple est une base de données bibliographiques pour \BibTeX{} +servant aux articles de \textsl{TUGBoat}. + +\begin{alltt} +> \Ucom{kpsewhich cmr10.pk} +\end{alltt} +Les fichiers de glyphes de fontes bitmaps, de type +\file{.pk}, sont +utilisés pour l'affichage par des programmes comme \cmdname{dvips} et +\cmdname{xdvi}. Rien n'est renvoyé dans ce cas puisque il n'y a pas +de fichier Computer Modern \file{.pk} pré-créé sur nos systèmes +(nous utilisons les versions type~1). +\begin{alltt} +> \Ucom{kpsewhich wsuipa10.pk} +\ifSingleColumn + /usr/local/texmf-var/fonts/pk/ljfour/public/wsuipa/wsuipa10.600pk +\else /usr/local/texmf-var/fonts/pk/ljfour/public/ +... wsuipa/wsuipa10.600pk +\fi\end{alltt} +Pour ces fontes (alphabet phonétique de l'université de Washington), +nous avons dû créer les fichiers \file{.pk} et, puisque le mode \MF{} par +défaut sur notre installation est \texttt{ljfour} avec une résolution de +base de 600\dpi{} \textit{(dots per inch)}, cette instance est trouvée. +\begin{alltt} +> \Ucom{kpsewhich -dpi=300 wsuipa10.pk} +\end{alltt} +Dans ce cas, lorsque l'on spécifie que nous recherchons une +résolution de 300\dpi{} (\texttt{-dpi=300}) nous voyons qu'aucune fonte +pour cette résolution n'est disponible dans le système. En fait, un +programme comme \cmdname{dvips} ou \cmdname{xdvi} ne s'en +préoccuperait pas et créerait les fichiers \file{.pk} à la +résolution demandée en utilisant le script \cmdname{mktexpk}. + +Intéressons-nous à présent aux fichiers d'en-tête et de configuration +pour \cmdname{dvips}. +Regardons en premier le fichier \file{tex.pro} communément utilisé +pour le support de \TeX{} avant de regarder le fichier +de configuration générique (\file{config.ps}) et la liste des fontes +\PS{} \file{psfonts.map}. Depuis l'édition 2004, les fichiers +\file{.map} et les fichiers de codage ont changé de place dans +l'arborescence \dirname{texmf}. Comme le suffixe \file{.ps} est +ambigu, nous devons spécifier quel type particulier du fichier +\texttt{config.ps} nous considérons (\optname{dvips config}). +\begin{alltt} +> \Ucom{kpsewhich tex.pro} + /usr/local/texmf/dvips/base/tex.pro +> \Ucom{kpsewhich -{}-format="dvips config" config.ps} + /usr/local/texmf-var/dvips/config/config.ps +> \Ucom{kpsewhich psfonts.map} + /usr/local/texmf-var/fonts/map/dvips/updmap/psfonts.map +\end{alltt} + +Regardons plus en détail les fichiers de support Times +\PS{} d'\acro{URW}. Leur nom standard dans le schéma de nommage des fontes +est \samp{utm}. Le premier fichier que nous voyons est le +fichier de configuration, qui contient le nom du fichier +de la liste : +\begin{alltt} +> \Ucom{kpsewhich -{}-format="dvips config" config.utm} + /usr/local/texmf-dist/dvips/psnfss/config.utm +\end{alltt} +Le contenu de ce fichier est +\begin{alltt} + p +utm.map +\end{alltt} +qui pointe vers le fichier \file{utm.map}, que nous cherchons à +localiser ensuite. +\begin{alltt} +> \Ucom{kpsewhich utm.map} + /usr/local/texmf-dist/fonts/map/dvips/times/utm.map +\end{alltt} +Ce fichier liste les noms des fichiers des +fontes \PS{} de type~1 dans la collection URW. Son contenu +ressemble à (nous ne montrons qu'une partie des lignes) : +\begin{alltt} +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 +\end{alltt} +Prenons par exemple le cas de Times Roman \file{utmr8a.pfb} et +trouvons sa position dans l'arborescence \file{texmf} en utilisant une +recherche applicable aux fichiers de fontes de type~1 : +\begin{alltt} +> \Ucom{kpsewhich utmr8a.pfb} +\ifSingleColumn /usr/local/texmf-dist/fonts/type1/urw/times/utmr8a.pfb +\else /usr/local/texmf-dist/fonts/type1/ +... urw/utm/utmr8a.pfb +\fi\end{alltt} + +Il devrait être clair, d'après ces quelques exemples, qu'il est facile +de trouver l'endroit où se cache un fichier donné. C'est +particulièrement important si vous suspectez que c'est, pour une +raison quelconque, une mauvaise version du fichier qui est utilisée, +puisque \cmdname{kpsewhich} va vous montrer le premier fichier +trouvé. + +\subsubsection{Opérations de débogage} +\label{sec:debugging} + +Il est quelquefois nécessaire de savoir comment un programme référence +les fichiers. Pour permettre cela, \KPS{} offre +plusieurs niveaux de débogage : +\begin{ttdescription} +\item[\texttt{\ 1}] Appels à \texttt{stat} (test d'existence de fichier). Lors d'une + exécution utilisant une base de données \file{ls-R} à jour, ce niveau + ne devrait donner presque aucune information en sortie. +\item[\texttt{\ 2}] Références aux différentes tables (comme la base + de données \file{ls-R}, les fichiers de correspondance de fontes, les fichiers de + configuration). +\item[\texttt{\ 4}] Opérations d'ouverture et de fermeture des + fichiers. +\item[\texttt{\ 8}] Information globale sur la localisation des types + de fichiers recherchés par \KPS. Ceci est utile pour trouver où a été + défini le chemin particulier pour un fichier. +\item[\texttt{16}] Liste des répertoires pour chaque élément du + chemin (utilisé uniquement en cas de recherche sur le disque). +\item[\texttt{32}] Recherche de fichiers. +\item[\texttt{64}] Valeur des variables. +\end{ttdescription} +Une valeur de \texttt{-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 \cmdname{dvips}, en utilisant une +combinaison d'options de débogage, on peut suivre en détail la +localisation des +différents fichiers. De plus, lorsqu'un fichier n'est +pas trouvé, la trace du débogage montre les différents répertoires dans +lesquels le programme va chercher tel ou tel fichier, donnant ainsi +des indices sur le problème. + +Généralement, comme la plupart des programmes appellent la +bibliothèque \KPS{} en interne, on peut sélectionner une option de +débogage en utilisant la variable d'environnement +\envname{KPATHSEA\_DEBUG} et en la définissant é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 fichier sur ces +systèmes. À des fins de diagnostic, vous pouvez temporairement +affecter \texttt{KPATHSEA\_DEBUG\_OUTPUT=err.log} pour capturer le flux +standard d'erreur dans le fichier \texttt{err.log}. + +Considérons comme exemple un petit fichier source \LaTeX{}, +\file{hello-world.tex}, dont le contenu est le suivant. +\begin{verbatim} + \documentclass{article} + \begin{document} + Hello World! + \end{document} +\end{verbatim} +Ce petit fichier utilise simplement la fonte \file{cmr10}, aussi +allons voir comment \cmdname{dvips} prépare le fichier \PS{} +(nous voulons utiliser la version type~1 +des fontes Computer Modern, d'où l'option \texttt{-Pcms}). +\begin{alltt} +> \Ucom{dvips -d4100 hello-world -Pcms -o} +\end{alltt} +Dans ce cas, nous avons combiné le niveau 4 de débogage de +\cmdname{dvips} (chemins des fontes) avec l'option d'expansion des +éléments du chemin de \KPS\ (voir \cmdname{dvips} Reference Manual, +\OnCD{texmf/doc/html/dvips/dvips_toc.html} sur le \DVD{}). +La sortie (légèrement formatée) apparaît dans la +figure~\ref{fig:dvipsdbga}. +\begin{figure*}[tp] +\centering +\input{examples/ex6a.tex} +\caption{Recherche des fichiers de configuration}\label{fig:dvipsdbga} + +\bigskip + +\input{examples/ex6b.tex} +\caption{Recherche du fichier prolog}\label{fig:dvipsdbgb} + +\bigskip + +\input{examples/ex6c.tex} +\caption{Recherche du fichier de fontes}\label{fig:dvipsdbgc} +\end{figure*} + +\cmdname{dvips} commence par localiser ses fichiers de +fonctionnement. D'abord, \file{texmf.cnf} est trouvé, ce qui donne les +définitions pour les chemins de recherche servant à localiser les +autres fichiers, ensuite le fichier base de données \file{ls-R} (pour +optimiser la recherche des fichiers) et le fichier \file{aliases}, qui +permet de déclarer plusieurs noms (par exemple un nom \acro{DOS} de type +8.3 court et une version longue plus naturelle) pour le même +fichier. Ensuite \cmdname{dvips} continue en cherchant le fichier de +configuration générique \file{config.ps} avant de rechercher le fichier +de paramétrisation \file{.dvipsrc} (qui, dans notre cas, \emph{n'est +pas trouvé}). Enfin, \cmdname{dvips} localise le fichier de +configuration pour les fontes \PS{} Computer Modern +\file{config.cms} (ceci est lancé par l'option \mbox{\texttt{-Pcms}} de la +commande \cmdname{dvips}). Ce fichier contient la liste des fichiers + qui définissent la relation entre les noms des fontes +selon \TeX{}, selon \PS{} et dans le système de fichiers. +\begin{alltt} +> \Ucom{more /usr/local/texmf/dvips/cms/config.cms} + p +ams.map + p +cms.map + p +cmbkm.map + p +amsbkm.map +\end{alltt} +\cmdname{dvips} veut chercher tous ces fichiers, y compris le +fichier générique d'association \file{psfonts.map}, qui est toujours +chargé (il contient des déclarations pour les fontes \PS{} les +plus communément utilisées ; voir la dernière partie de la Section +\ref{sec:examples-of-use} pour plus de détails sur la gestion du fichier +d'association \PS{}). + +Arrivé là, \cmdname{dvips} s'identifie à l'utilisateur : + \begin{alltt} + This is dvips(k) 5.92b Copyright 2002 Radical Eye Software (www.radicaleye.com) + \end{alltt} + +\ifSingleColumn +pour continuer ensuite en cherchant le fichier prologue \file{texc.pro}, +\begin{alltt}\small +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 +\end{alltt} +\else +pour continuer ensuite en cherchant le fichier prologue \file{texc.pro} +(voir la figure~\ref{fig:dvipsdbgb}). +\fi + +Après avoir trouvé ce fichier, \cmdname{dvips} affiche la date et +l'heure, nous informe qu'il va générer le fichier +\file{hello-world.ps} puis qu'il a besoin du fichier de fonte +\file{cmr10} et que ce dernier est déclaré comme « résident» +(pas besoin de bitmaps) : +\begin{alltt}\small +TeX output 1998.02.26:1204' -> hello-world.ps +Defining font () cmr10 at 10.0pt +Font cmr10 <CMR10> is resident. +\end{alltt} +Maintenant la recherche concerne le fichier \file{cmr10.tfm}, qui est +trouvé, puis quelques fichiers de prologue de plus (non montrés) sont +référencés ; finalement le fichier de la fonte type~1 \file{cmr10.pfb} +est localisé et inclus dans le fichier de sortie (voir la dernière ligne). +\begin{alltt}\small +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] +\end{alltt} + +\subsection{Options à l'exécution} + +\Webc{} offre la possibilité de contrôler à l'exécution bon nombre de +paramètres concernant la mémoire (en particulier la taille des +tableaux utilisés) à partir du fichier +\file{texmf.cnf} qui est lu par \KPS. +Les paramètres en question se trouvent +dans la troisième partie du fichier inclus dans la distribution \TL{}. + Les variables les plus importantes sont : +\begin{ttdescription} +\item[\texttt{main\_memory}] + Nombre total de mots mémoire disponibles pour + \TeX{}, \MF{} et \MP. Vous devez générer un nouveau fichier de + format pour chaque nouveau paramétrage. Par exemple, vous pouvez + générer une version large de \TeX{} et appeler le fichier de format + \texttt{hugetex.fmt}. En utilisant la méthode supportée par \KPS{} + qui consiste à suffixer la variable par le nom du programme, la valeur + particulière de la variable \texttt{main\_memory} destinée à ce + fichier de format sera lue dans le fichier \file{texmf.cnf}. +\item[\texttt{extra\_mem\_bot}] + Espace supplémentaire pour certaines structures de données de \TeX{} : + boîtes, \textit{glue}, points d'arrêt\dots{} Surtout utile si vous utilisez + \PiCTeX{} par exemple. +\item[\texttt{font\_mem\_size}] + Nombre de mots mémoire disponibles pour décrire les polices. C'est + plus ou moins l'espace occupé par les fichiers \acro{TFM} lus. +\item[\texttt{hash\_extra}] + Espace supplémentaire pour la table de hachage des noms de séquences + de contrôle. Environ 10~000 de ces noms peuvent être stockés dans la + table principale ; si vous avez un document très volumineux avec + beaucoup de références croisées, il se peut que ce ne soit pas + suffisant. La valeur par défaut \texttt{hash\_extra} est \texttt{50000}. +\end{ttdescription} + +\noindent Évidemment, cette possibilité ne remplace pas une véritable +allocation dynamique des tableaux et de la mémoire mais puisque c'est +complexe à implémenter dans le présent source \TeX{}, ces paramètres lus +à l'exécution fournissent un compromis pratique qui procure une certaine +souplesse. + +\begin{comment} +\section{Compilation sur un nouveau système Unix} + +Si vous avez un système Unix ne correspondant à aucun des exécutables +fournis, il faut compiler vous-même \TeX{} et tous ses programmes +satellites à partir des sources. Cela n'est pas aussi difficile qu'il +y paraît. Tout ce dont vous aurez besoin est contenu dans le +répertoire \texttt{source} qui se trouve sur le \DVD. + +\subsection{Prérequis} + +Il faut au moins 400\,Mo d'espace sur disque pour compiler la +totalité de \TeX{} et des programmes associés. +Vous aurez aussi besoin d'un +compilateur C \acro{ANSI}, de l'utilitaire \cmdname{make}, +d'un générateur d'analyseur lexical et d'un générateur d'analyseur +syntaxique. Nous recommandons les versions \GNU des programmes suivants +(\cmdname{gcc}, \GNU{}\cmdname{make}, \cmdname{m4}, +\cmdname{flex}, \cmdname{bison}). Vous pouvez utiliser d'autres compilateurs C +et d'autres programmes \cmdname{make} si vous maîtrisez +correctement la programmation sous Unix pour résoudre les +problèmes éventuels. La commande \texttt{uname} doit renvoyer une valeur +raisonnable. + +\subsection{Configuration} + +Tout d'abord, effectuez l'installation normale de \TL{} sur le disque +dur (voir section~\ref{sec:install}, +page~\pageref{sec:install}). Vous pouvez sauter l'installation de +tous les binaires précompilés. +Décompactez ensuite sur le disque le fichier +\file{source.tar.bz2} (archive compressée) trouvé dans +le répertoire \dirname{source} et placez-vous dans +le répertoire où vous avez transféré l'ensemble. +\begin{alltt} +> \Ucom{cd /tmp/tl-source} +> \Ucom{bunzip2 source.tar.bz2} +> \Ucom{tar xf source.tar} +\end{alltt} + +Lancez maintenant \textsf{configure} de la façon suivante : +\begin{alltt} +> \Ucom{sh configure -prefix=/usr/local/texlive/2007} +\end{alltt} + +Le répertoire \optname{-prefix} est le répertoire de base de +l'arborescence \TL{}, il est désigné par \var{TEXDIR} dans la suite. +Les répertoires utilisés sont les suivants : + +\noindent +\begin{tabular}{>{\ttfamily}ll@{}} + \dirname{$TEXDIR/texmf-dist} & répertoire de base pour les fontes, + macros, etc\\ + \dirname{$TEXDIR/man} & pages du manuel Unix\\ + \dirname{$TEXDIR/info} & manuels \GNU en format Info\\ + \dirname{$TEXDIR/bin/$archname} & exécutables.\\ +\end{tabular}\\ + +Si vous ne voulez pas créer de répertoire \dirname{$archname} spécifique %$ +au système choisi pour stocker les exécutables (c.-à-d. les +copier directement dans \dirname{$TEXDIR/bin}), %$ +il faut exécuter \textsf{configure} avec l'option \\ +\verb|--disable-multiplatform|. + +Tapez \verb|./configure --help|, le programme affichera +les options supplémentaires disponibles (telles que supprimer l'installation +des extensions optionnelles comme \OMEGA\ ou \eTeX). + +\subsection{Exécuter \textsf{make}} +S'assurer que la variable ou l'option \texttt{noclobber} n'est pas définie. + et lancer le \cmdname{make} à la racine de l'arborescence de la façon +suivante : +\begin{alltt} +>> \Ucom{make world} +\end{alltt} +et aller prendre un café\dots + +Il peut être utile de garder une trace complète dans un fichier log en tapant : +\begin{alltt} +>> \Ucom{sh -c "make world >world.log 2>\&1" \&} +\end{alltt} +Avant de conclure que tout va bien, vérifier que le fichier log ne contient +pas de message d'erreur : le \cmdname{make} de \GNU renvoie toujours +le message \samp{***} à chaque erreur d'exécution. Vérifier aussi que +tous les exécutables ont été créés. +\begin{alltt} +>> \Ucom{cd \var{TEXDIR}/bin/\var{archname}} +>> \Ucom{ls | wc} +\end{alltt} +Le résultat doit être supérieur à 200 (on peut tester le nombre exact +dans le répertoire \dirname{bin} de la distribution). + +Si vous avez besoin de droits spéciaux pour exécuter \texttt{make install}, +vous pouvez séparer \samp{make world} en deux processus différents : +\begin{alltt} +>> \Ucom{make all} +>> \Ucom{su} +>> \Ucom{make install strip} +\end{alltt} + +Après avoir installé vos nouveaux binaires, il faut suivre les procédures +normales de la post-installation, indiquées dans la +section~\ref{sec:postinstall}, page~\pageref{sec:postinstall}. + +Par ailleurs, si vous souhaitez rendre vos binaires disponibles pour les +autres, n'hésitez pas à nous contacter ; nous les ajouterons volontiers sur +les pages web de \TL. +\end{comment} + +\htmlanchor{ack} +\section{Remerciements} + +\TL{} est le résultat des efforts +collectifs de pratiquement tous les groupes d'utilisateurs de \TeX. +La présente édition de \TL{} a été coordonnée par Karl Berry. +Voici la liste des principaux contributeurs : + +\begin{itemize*} + +%NdT% on considère que ce sont les nationalités des associations : +% elles regroupent en pratique des adhérents d'originies diverses +\item Les associations d'utilisateurs anglaise, allemande, néerlandaise et + polonaise (\acro{TUG}, \acro{DANTE} e.V., \acro{NTG}, et \acro{GUST}, + respectivement) qui contribuent ensemble à l'infrastructure technique et + administrative. Soutenez votre association locale (voir la liste + \url{http://tug.org/usergroups.html}) ! + +\item L'équipe du \acro{CTAN}, en particulier Robin Fairbairns, Jim Hef{}feron + et Rainer Schöpf, qui distribue les images des distributions \TL{} et + fournit les sites d'hébergement pour le stockage et la mise à jour des + extensions qui sont la base de \TL. + +\item Nelson Beebe, pour avoir permis l'accès à de nombreuses plate-formes aux + développeurs \TL, et avoir lui-même participé aux tests de façon étendue. + +\item John Bowman, pour avoir effectué de nombreux changements dans son + programme Asymptote pour le faire fonctionner dans \TL. + +\item Peter Breitenlohner et toute l'équipe \eTeX{} qui construisent + les bases des successeurs de \TeX, et Peter tout particulièrement pour son + aide concernant l'usage des autotools de GNU partout dans \TL. + +\item Jin-Hwan Cho et toute l'équipe de DVIPDFM$x$ pour leur excellent + programme et leur réactivité face aux problèmes de configuration. + +\item Thomas Esser et sa merveilleuse distribution \teTeX{} sans laquelle + \TL{} n'aurait jamais vu le jour. + +\item Michel Goossens, en tant que co-auteur de la documentation initiale. + +\item 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é + prématurément en juin 2009, et nous dédions la présente documentation à sa + mémoire. + +\item Hans Hagen qui, outre sa participation active aux tests, a adapté le + format \ConTeXt\ (\url{http://pragma-ade.com}) aux besoins de \TL{}. + +\item \Thanh, Martin Schr\"oder et toute l'équipe pdf\TeX\ qui continuent + inlassablement à étendre les performances de \TeX. + +\item Hartmut Henkel, pour ses contributions au développement + de pdf\TeX{} et Lua\TeX{} entre autres. + +\item Taco Hoekwater, pour son travail important et incessant sur le + développement de \MP{} et de (Lua)\TeX\ (\url{http://luatex.org}) + lui-même, pour l'intégration de \ConTeXt\ dans \TL, pour les nouvelles + fonctionnalités mutli-thread de Kpathsea, et bien plus encore. + +\item Pawe{\l} Jackowski pour l'installeur Windows \cmdname{tlpm} et Tomasz + {\L}uczak pour la version graphique \cmdname{tlpmgui} utilisée dans + l'édition précédente. + +\item Akira Kakuto, pour son aide précieuse qui nous a permis + d'intégrer dans \TL{} les binaires Windows de sa distribution \acro{W32TEX} + (\url{http://w32tex.org}). + +\item Jonathan Kew, pour avoir produit Xe\TeX{}, pour l'avoir intégré dans + \TL{}, pour avoir créé la première version de l'installeur Mac\TeX et enfin + pour l'éditeur \TeX{}works que nous recommandons. + +\item Dick Koch, pour la maintenance de Mac\TeX\ (\url{http://tug.org/mactex}) + faite en symbiose avec \TL. + +\item Reinhard Kotucha, pour ses contributions majeures à l'infrastructure de + \TL{} 2008 et à son programme d'installation, pour ses contributions sous + Windows et pour son script \texttt{getnonfreefonts} en particulier. + +\item Siep Kroonenberg, également pour ses contributions majeures à + l'infrastructure de \TL{} 2008 et à son programme d'installation ainsi que + pour la réécriture de cette documentation concernant ces fonctionnalités. + +\item Heiko Oberdieck, pour le paquet \pkgname{epstopdf} et bien d'autres, + pour avoir compressé l'énorme \pkgname{pst-geo} de façon à ce que nous + puissions l'inclure, et, par-dessus tout, son travail remarquable sur + \pkgname{hyperref}. + +\item Petr Ol\v{s}ak, qui coordonna et vérifia minutieusement toute la + partie tchèque et slovaque. + +\item Toshio Oshima, pour le visualisateur \cmdname{dviout} pour Windows. + +\item Manuel Pégourié-Gonnard, pour son aide concernant le programme de mise à + jour de la distribution, la documentation et pour le développement de + \cmdname{texdoc}. + +\item Fabrice Popineau, pionnier du développement de \TL{} sous Windows et + pour son travail sur la documentation française. + +\item Norbert Preining, principal architecte de la distribution \TL{} 2008 et + de son installeur et coordinateur (avec Frank K\"uster) de la + version Debian de \TL. + +\item Sebastian Rahtz, qui a créé la distribution \TL{} et en a assuré la + maintenance pendant de nombreuses années. + +\item Phil Taylor, pour la mise en place du téléchargement par BitTorrent. + +\item Tomasz Trzeciak, pour son aide générale concernant Windows. + +\item Vladimir Volovich, pour son aide substantielle, en particulier pour + avoir rendu possible l'intégration de \cmdname{xindy} dans \TL. + +\item Staszek Wawrykiewicz, principal testeur de \TL{} et coordinateur des + contributions polonaises (fontes, installation Windows, etc.). + +\item Olaf Weber, pour son patient assemblage de \Webc. + +\item Gerben Wierda, qui a créé et maintenu initialement la partie \MacOSX{} + et participé activement aux tests. + +\item Graham Williams, pour son travail sur le catalogue \TeX. + +\end{itemize*} + +Les binaires ont été compilés par : +Ettore Aldrovandi (\pkgname{i386-solaris}, \pkgname{x86\_64-solaris}), +Alan Braslau (\pkgname{amd64-kfreebsd}, \pkgname{i386-kfreebsd}), +Peter Breitenlohner (\pkgname{x86\_64-linux}), +Karl Berry (\pkgname{i386-linux}), +Ken Brown (\pkgname{i386-cygwin}), +Akira Kakuto (\pkgname{win32}), +Dick Koch (\pkgname{universal-darwin}, \pkgname{x86\_64-darwin}), +Nikola Le\v{c}i\'c (\pkgname{amd64-freebsd}, \pkgname{i386-freebsd}), +Mojca Miklavec (\pkgname{mipsel-linux}), +Norbert Preining (\pkgname{alpha-linux}), +Thomas Schmitz (\pkgname{powerpc-linux}), +Boris Veytsman (\pkgname{armel-linux}), +Vladimir Volovich (\pkgname{powerpc-aix}, \pkgname{sparc-solaris}), +Olaf Weber (\pkgname{mips-irix}). + +Traducteurs de ce manuel : +Boris Veytsman (russe), +Jjgod Jiang, Jinsong Zhao, Yue Wang, \& Helin Gai (chinois), +Uwe Ziegenhagen (German), +Manuel P\'egouri\'e-Gonnard (français), +Marco Pallante (italien), +Nikola Le\v{c}i\'c (serbe), +Petr Sojka \& Jan Busa (thèque et slovaque), +Staszek Wawrykiewicz (polonais). +La page d'accueil de la documentation \TL{} est +\url{http://tug.org/texlive/doc.html}. + +Bien sûr, notre gratitude va en premier lieu à Donald Knuth pour avoir +inventé \TeX{} et l'avoir offert au monde entier. + +\section{Historique des versions successives} +\label{sec:history} + +\subsection{Les éditions précédentes} + +La discussion commença à la fin de 1993 quand le Groupe des Utilisateurs +Néerlandais de \TeX{} commençait à travailler à son \CD{} 4All\TeX{} pour les +utilisateurs de \acro{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{} 4All\TeX{}, projet couronné de succès et +aussi d'un groupe de travail « \acro{TUG} Technical Council » pour +mettre en place TDS (\emph{\TeX{} Directory Structure} : +\url{http://tug.org/tds}), qui spécifiait la gestion des fichiers \TeX{} sous +une forme logique. La mouture finale de \TDS{} fut publiée dans le numéro de +décembre 1995 de \textsl{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{} +4All\TeX{} démontrait que les utilisateurs d'Unix trouveraient leur bonheur +avec une distribution aussi simple et ceci a été l'autre objectif de +\TL. + +Nous avons d'abord entrepris de créer un nouveau \CD{} \TDS{} Unix à l'automne +1995 et nous avons rapidement choisi \teTeX{} de Thomas Esser comme étant la +configuration idéale, car il supportait déjà plusieurs plates-formes et avait +été construit en gardant à l'esprit la portabilité entre systèmes. Thomas +accepta de nous aider et commença à travailler sérieusement au début de 1996. +La première édition sortit en mai 1996. Au début de 1997, Karl Berry acheva +une nouvelle distribution de \Webc{}, 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 \Webc, en y ajoutant le +script \texttt{texconfig} de \teTeX. La troisième édition du \CD{} était +basée sur une version majeure de \Webc, 7.2, par Olaf Weber ; en même temps, +une nouvelle version révisée de \teTeX{} était achevée dont \TL{} 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 \Webc{} (7.3). Le système incluait dorénavant un programme complet +d'installation pour Windows. + +Pour la cinquième édition (mars 2000), de nombreuses parties du \CD{} +ont été vérifiées et révisées, des centaines de composants +mis à jour. +Le contenu détaillé des composants était décrit par des +fichiers XML. Mais le changement majeur de cette cinquième édition a +été la suppression de tout logiciel non libre de droits. +Tout ce qui se trouve dans \TL{} devait être compatible avec la licence +Debian (\emph{Debian Free Software Guidelines} : +\url{http://www.debian.org/intro/free}) ; nous avons +fait de notre mieux pour vérifier les termes des licences de chaque +composant et nous souhaiterions que toute erreur nous soit signalée. + +La sixième édition (juillet 2001) contient un grand nombre de mises à jour. +Le changement majeur de cette version réside dans la refonte du +processus d'installation : l'utilisateur peut désormais choisir +les collections de manière plus précise. Les collections concernant +les langues ont été entièrement réorganisées, aussi le choix d'une +langue installe non seulement les macros, les fontes, etc. mais +prépare également un fichier \file{language.dat} adéquat. + +La septième édition (mai 2002) a comme ajout majeur une installation +pour \MacOSX{} 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. + +\subsubsection{2003} + +En 2003, le flot de mises à jour et d'additions a continué mais nous +avons constaté que \TL{} é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~\ref{sec:tl-coll-dists}, +page~\pageref{sec:tl-coll-dists}). Par ailleurs : +\begin{itemize} +\item À la demande de l'équipe \LaTeX{}, nous avons modifié les + commandes standard \cmdname{latex} et \cmdname{pdflatex} pour + qu'elles utilisent \eTeX{} (voir page~\pageref{text:etex}). +\item Les nouvelles fontes Latin Modern sont disponibles (et + recommandées). +\item Le support pour Alpha \acro{OSF} a été supprimé + (celui pour \acro{HPUX} l'avait été auparavant), car personne + disposant des machines nécessaires ne s'est + proposé pour compiler les nouveaux binaires. +\item L'installation pour Windows a été largement modifiée ; un environnement + de travail intégré basé sur \cmdname{XEmacs} a été introduit. +\item Des programmes supplémentaires importants pour Windows (Perl, + Ghost\-script, Image\-Magick, Ispell) sont maintenant installés dans le + répertoire d'installation de \TL{}. +\item Les fichiers \emph{font map} utilisés par \cmdname{dvips}, + \cmdname{dvipdfm} et \cmdname{pdftex} sont maintenant générés par le + nouveau programme \cmdname{updmap} et installés dans + \dirname{texmf/fonts/map}. +\item Dorénavant, \TeX{}, \MF{} et \MP{} écrivent les caractères 8 bits + présentés en entrée sans modification et non pas avec la notation + \verb|^^|, que ce soit dans des fichiers (par la commande + \verb|write|), dans les fichiers de trace (\verb|.log|) ou sur le + terminal. Dans le \TL{}~7, l'écriture de ces caractères + 8 bits était influencée par les paramètres de localisation du + système; maintenant ces paramètres n'influent plus du tout sur le + comportement des programmes \TeX{}. Si pour quelque raison que ce + soit, vous avez besoin de la notation \verb|^^| en sortie, + renommez le fichier \verb|texmf/web2c/cp8bit.tcx|. Les prochaines + versions disposeront d'un moyen plus propre pour contrôler cette + sortie. +\item La documentation de \TL{} a été largement révisée. +\item Enfin, comme la numérotation séquentielle des versions + devenait peu maniable, il a été décidé d'identifier désormais la version + de \TL{} par l'année : \TL{}~2003 au lieu de \TL{}~8. +\end{itemize} + + +\subsubsection{2004} + +2004 a apporté beaucoup de changements (et quelques incompatibilités avec les +versions précédentes) : + +\begin{itemize} + +\item Si vous avez installé des fontes supplémentaires qui ont leur propre +fichier \file{.map} ou des fichiers \file{.enc} spécifiques, vous +devrez vraisemblablement déplacer ces fichiers. + +Les fichiers \file{.map} sont désormais recherchés uniquement dans les +sous-répertoires \dirname{fonts/map} (dans chaque arborescence +\filename{texmf}), leur chemin de recherche est donné par la variable +\envname{TEXFONTMAPS} de \filename{texmf.cnf}. +De même, les fichiers \file{.enc} sont désormais recherchés uniquement +dans les sous-répertoires \dirname{fonts/enc}, leur chemin de recherche est +donné par la variable \envname{ENCFONTS} de \filename{texmf.cnf}. +Le script \cmdname{updmap} devrait émettre des messages d'avertissement +pour les fichiers \file{.map} et \file{.enc} mal placés. + +Sur les différentes façons de traiter le problème, consulter +\url{http://tug.org/texlive/mapenc.html}. + +\item La distribution pour Windows a changé cette année : +l'installation de la distribution \fpTeX{} (basée sur \Webc{}) 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 \Webc{}), +voir section~\ref{sec:overview-tl}, page~\pageref{sec:overview-tl}. + +\item L'ancien répertoire \dirname{texmf} a été éclaté en trois parties : +\dirname{texmf}, \dirname{texmf-dist} et \dirname{texmf-doc}. Voir +section~\ref{sec:tld}, page~\pageref{sec:tld}. + +\item Tous les fichiers relatifs aux différents avatars de \TeX{} sont +désormais regroupés dans le même sous-répertoire \dirname{tex} des +arborescences \dirname{texmf*} (ils étaient jusqu'ici placés dans des +sous-répertoires spécifiques \dirname{tex}, \dirname{etex}, +\dirname{pdftex}, \dirname{pdfetex}, etc.). Voir +\CDref{texmf-dist/doc/generic/tds/tds.html\#Extensions} +{\texttt{texmf-dist/doc/generic/tds/tds.html\#Extensions}}. + +\item Les scripts auxiliaires, normalement pas exécutés directement +par les utilisateurs, sont regroupés dans des sous-répertoires \dirname{scripts} +des arborescences \dirname{texmf*}. On les localise grâce à la +commande \verb|kpsewhich -format=texmfscripts|. Au cas où vous en +auriez, les programmes utilisant ces scripts nécessiteront une adaptation. +Voir \CDref{texmf-dist/doc/generic/tds/tds.html\#Scripts} +{\texttt{texmf-dist/doc/generic/tds/tds.html\#Scripts}}. + +\item La plupart des formats affichent en clair (dans les fichiers +\file{.log} en particulier) les caractères imprimables au lieu +de les transcrire en notation hexadécimale \verb|^^|. Ceci se fait +grâce au fichier \filename{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 différence avec le comportement de \TL\,2003 +mais la mise en œuvre est plus propre et plus facilement configurable. +Voir \OnCD{texmf/doc/web2c/web2c.html\#TCX-files}. +Noter que l'utilisation du codage Unicode en entrée peut provoquer +des affichages défectueux en sortie (TeX code sur un seul octet). + +\item Tous les formats, sauf plain \TeX, font appel au moteur +\textsf{pdfetex} (qui produit bien sûr par défaut des fichiers \acro{DVI} +lorsque le format choisi est \LaTeX). Ceci permet aux formats +\LaTeX, \ConTeXt, etc., d'avoir accès aux fonctionnalités +micro-typographiques de pdf\TeX{} (alignement optique des marges par exemple) +et aux fonctionnalités de \eTeX{} (\OnCD{texmf-dist/doc/etex/base/}). + +Ceci rend \emph{indispensable} le recours à l'extension \pkgname{ifpdf} +(qui fonctionne aussi bien avec plain que \LaTeX) pour déterminer si +le format de sortie est \acro{DVI} ou \acro{PDF}. Tester si la commande +\cs{pdfoutput} est définie ou non \emph{n'est pas} un moyen fiable +de le faire. + +\item pdf\TeX\ (\url{http://pdftex.org}) offre de nouvelles fonctionnalités : + + \begin{itemize} + + \item Les commandes \cs{pdfmapfile} et \cs{pdfmapline} permettent + de spécifier le choix des fichiers \file{.map} à utiliser + pour le document en cours. + + \item L'amélioration du gris typographique par variation (infime) de la + largeur des caractères (\textit{font expansion}) est plus facile à + mettre en œuvre, voir + \url{http://www.ntg.nl/pipermail/ntg-pdftex/2004-May/000504.html} + + \item Le fichier \filename{pdftex.cfg} n'est plus utilisé. + Toutes les affectations de paramètres doivent désormais être + faites dans le préambule en utilisant les primitives ad~hoc. + + \item Pour plus d'informations, consulter le manuel de pdf\TeX\ : + \OnCD{texmf/doc/pdftex/manual}. + + \end{itemize} + +\item La primitive \cs{input} de \cmdname{tex}, \cmdname{mf} et +\cmdname{mpost}, accepte désormais les espaces et autres caractères +spéciaux dans les noms de fichiers à condition d'utiliser des +\textit{double quotes}, en voici deux exemples typiques : +\begin{verbatim} +\input "filename with spaces" % plain +\input{"filename with spaces"} % latex +\end{verbatim} +Consulter le manuel \Webc{} pour plus d'informations : \OnCD{texmf/doc/web2c}. + +\item Les fonctionnalités de enc\TeX\ sont désormais incluses dans \Webc{}. +Ainsi, tous les formats \emph{construits avec l'option \optname{-enc}} y ont +accès. enc\TeX\ permet le transcodage en entrée et en sortie et +l'utilisation transparente du codage Unicode \acro{UTF}-8. Voir +\OnCD{texmf-dist/doc/generic/enctex/} et +\url{http://www.olsak.net/enctex.html}. + +\item Un nouveau moteur combinant les fonctionnalités de \eTeX\ +et d'\OMEGA, appelé Aleph, est disponible. \OnCD{texmf-dist/doc/aleph/base} +et \url{http://www.tex.ac.uk/cgi-bin/texfaq2html?label=aleph} +fournissent une information succincte. Le format \LaTeX{} utilisant +Aleph s'appelle \textsf{lamed}. + +\item La licence \acro{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 fichier \filename{ltnews}, voir +\OnCD{texmf-dist/doc/latex/base}. + +\item Un nouveau programme, \cmdname{dvipng}, qui convertit les fichiers +\acro{DVI} en images \acro{PNG} a été ajouté. Voir +\OnCD{texmf/doc/man/man1/dvipng.1}. + +\item Nous avons dû réduire le nombre de fontes incluses dans l'extension +\pkgname{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 \pkgname{cbgreek} est disponible sur \acro{CTAN} +(\url{http://mirror.ctan.org/tex-archive/fonts/greek/cb}). + +\item La commande \cmdname{oxdvi} a été supprimée, il suffit utiliser +\cmdname{xdvi} à la place. + +\item Les commandes \cmdname{initex}, \cmdname{virtex} et leurs +homologues pour \cmdname{mf} et \cmdname{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 \optname{-ini} +(\cmdname{tex} \optname{-ini} pour \cmdname{initex} et \cmdname{virtex}). + +\item Les binaires pour l'architecture \textsf{i386-openbsd} ont été + supprimés par manque de volontaires pour les compiler. + +Sur \textsf{sparc-solaris} (au moins) il sera probablement +nécessaire de positionner la variable d'environnement +\envname{LD\_LIBRARY\_PATH} pour utiliser les programmes de la famille +\pkgname{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 \textsf{mips-irix}, les bibliothèques dynamiques +\acro{MIPS}pro 7.4 sont nécessaires. + +\end{itemize} + +\subsubsection{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 : + +\begin{itemize} + +\item Trois nouveaux scripts \cmdname{texconfig-sys}, \cmdname{updmap-sys} et + \cmdname{fmtutil-sys} ont été introduits ; ils agissent sur la + configuration générale de la machine, comme le faisaient les + scripts \cmdname{texconfig}, \cmdname{updmap} et \cmdname{fmtutil} + jusqu'à l'an dernier. Les nouveaux scripts \cmdname{texconfig}, + \cmdname{updmap} et \cmdname{fmtutil} modifient maintenant + la configuration \emph{personnelle} de l'utilisateur qui les lance ; + le résultat est placé dans le répertoire personnel de l'utilisateur + (sous \dirname{$HOME/.texlive2005}). \iffalse$\fi + +\item De nouvelles variables, \envname{TEXMFCONFIG} (resp. + \envname{TEXMFSYSCONFIG}) ont été introduites ; elles définissent + les répertoires où doivent se trouver les fichiers de configuration de + l'utilisateur (resp. de la machine), comme \filename{fmtutil.cnf} et + \filename{updmap.cfg}. Les utilisateurs de fichiers de configuration + locaux \filename{fmtutil.cnf} ou \filename{updmap.cfg} devront + probablement les déplacer ; une autre possibilité est de modifier la + définition des variables \envname{TEXMFCONFIG} ou + \envname{TEXMFSYSCONFIG} dans \filename{texmf.cnf}. L'important est + de s'assurer de la cohérence entre les définitions de ces variables + dans \filename{texmf.cnf} et l'emplacement réel de ces fichiers. + Voir section~\ref{sec:texmftrees}, page~\pageref{sec:texmftrees} pour + la description des différentes arborescences texmf utilisées. + +\item L'an dernier nous avions rendu « \texttt{undefined} » certaines + primitives propres à \cmdname{pdftex} (comme \verb|\pdfoutput|) + dans les formats créés à partir de \cmdname{pdfetex} (\cmdname{latex} + \cmdname{amstex}, \cmdname{context} par exemple)). + C'était à titre transitoire, aussi cette année, ces primitives sont de + nouveau définies dans tous les formats à base \cmdname{pdf(e)tex}, + \emph{même lorsqu'ils sont utilisés pour produire des fichiers + \file{.dvi}}. Ceci implique qu'il vous faudra modifier vos + documents qui utilisent le test \verb|\ifx\pdfoutput\undefined| + pour déterminer si la sortie est en DVI ou en PDF. Le mieux est + d'utiliser l'extension \pkgname{ifpdf.sty} et son test + \verb|\ifpdf| qui fonctionne même en plain \TeX. + +\item L'an dernier nous avions fait en sorte que la plupart des formats + impriment dans les sorties \file{.log} des caractères 8 bits + lisibles à la place des notations hexadécimales \verb|^^| + (voir section précédente). + Le nouveau fichier TCX \filename{empty.tcx} permet + de revenir facilement à la notation traditionnelle \verb|^^|, il suffit + de coder : +\begin{verbatim} +latex --translate-file=empty.tcx fichier.tex +\end{verbatim} + +\item Le nouveau programme \cmdname{dvipdfmx} est disponible pour convertir + des fichier DVI en PDF ; ce programme remplace \cmdname{dvipdfm}, + toujours disponible mais dont l'usage est maintenant déconseillé. + +\item Les variables \envname{HOMETEXMF} et \envname{VARTEXMF} ont été renommées + en \envname{TEXMFHOME} et \envname{TEXMFSYSVAR} respectivement pour + raisons de cohérence avec les autres noms de variables. Il y a aussi + \envname{TEXMFVAR} qui désigne maintenant un répertoire personnel + de l'utilisateur (cf. le premier point de la présente liste). + +\end{itemize} + +\subsubsection{2006--2007} + +En 2006--2007, la nouveauté majeure a été l'arrivée dans \TL{} de Xe\TeX{} +disponible sous forme de deux programmes \texttt{xetex} et \texttt{xelatex}, +voir \url{http://scripts.sil.org/xetex}. + +\MP{} a subi une mise à jour importante et d'autres améliorations +sont prévues, voir \url{http://tug.org/metapost/articles}. Il en va de même +pour pdf\TeX{}, voir \url{http://tug.org/applications/pdftex}. + +Le format \filename{tex.fmt} et les formats pour \MP{} and \MF\ ne +se trouvent plus dans \dirname{texmf/web2c} mais dans des +sous-répertoires de \dirname{texmf/web2c} (la recherche de fichiers +\filename{.fmt} est néanmoins faite aussi dans \dirname{texmf/web2c}). +Ces sous-répertoires portent le nom du moteur utilisé pour construire +le format, par exemple \filename{tex}, \filename{pdftex} ou +\filename{xetex}. Ce changement ne devrait pas avoir d'effet visible +pour les utilisateurs. + +Le programme (plain) \texttt{tex} ignore désormais les lignes commençant +par \texttt{\%\&} 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 \texttt{\%\&}. + +Comme chaque année des centaines d'extensions et de programmes ont été mis à +jour, voir les sites \acro{CTAN} (\url{http://mirror.ctan.org}). + +L'arborescence utilisée en interne a été réorganisée avec de nouveaux outils +qui devraient fournir une meilleure base de travail pour les développements +futurs. + +Enfin, en mai 2006 Thomas Esser a annoncé qu'il renonçait à poursuivre le +développement de te\TeX{} (\url{http://tug.org/tetex}). Sa décision a relancé +l'intérêt pour \TL, en particulier chez les distributeurs de solutions +\GNU/Linux (un nouveau schéma d'installation \texttt{tetex} a été ajouté dans +le script d'installation de \TL{} pour produire une distribution proche de +l'ancienne te\TeX). La distribution \TL{} 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. + +\subsubsection{2008} + +En 2008, l'infrastructure de la distribution \TL{} a été entièrement remaniée. +Un nouveau fichier texte, \filename{tlpkg/texlive.tlpdb}, regroupe toutes les +informations concernant la configuration \TL{} de la machine. + +Ce fichier permet entre autres choses de procéder à des mises à jour par le +réseau après l'installation initiale. Cette possibilité était offerte depuis +des années par MiK\TeX. Nous espérons pouvoir fournir des mises à jour +régulières du contenu des archives \CTAN. + +Le nouveau moteur Lua\TeX\ (\url{http://luatex.org}) a été intégré ; +il offre de nouvelles fonctionnalités typographiques et repose +sur l'excellent langage de commande Lua qui peut aussi être utilisé +en dehors de \TeX. + +Les versions Windows et Unix sont beaucoup plus proches que par le passé. +En particulier les scripts en Perl et en Lua sont communs aux deux +architectures. + +\TL{} dispose d'une nouvelle interface pour la maintenance (\cmdname{tlmgr} +voir section~\ref{sec:tlmgr}), elle permet les ajouts, mises à jour et +suppressions de composants et prend en charge la régénération des bases +\texttt{ls-R}, des formats et des fichiers \filename{.map} lorsque c'est +nécessaire. + +Les fonctionnalités de \cmdname{tlmgr} englobent toutes les tâches dévolues +auparavant à \cmdname{texconfig} qui ne devrait plus être utilisé (il est +conservé mais avec un champ d'action réduit). + +Le programme d'indexation \cmdname{xindy} (\url{http://xindy.sourceforge.net/}) +est maintenant disponible pour la plupart des plates-formes. + +L'utilitaire \cmdname{kpsewhich} dispose de deux options nouvelles : +\optname{--all} qui retourne toutes les occurrences du fichier recherché +et \optname{--subdir} qui limite la recherche à un sous-répertoire donné. + +Le programme \cmdname{dvipdfmx} permet maintenant d'extraire les informations +concernant la \textit{bounding box} par le biais de la commande +\cmdname{extractbb}; c'était une des dernières fonctionnalités de +\cmdname{dvipdfm} qui manquaient à \cmdname{dvipdfmx}. + +Les alias de polices \filename{Times-Roman}, \filename{Helvetica}, etc. +ont été supprimés, les conflits de codage qu'ils induisaient n'ayant pas pu +être résolus. + +Le format \pkgname{platex} a été supprimé afin de résoudre un conflit de nom +avec son homonyme japonais ; le support pour le polonais est assuré +maintenant par l'extension \pkgname{polski}. + +Les fichiers \web{} d'extension \filename{.pool} sont maintenant inclus dans +les binaires afin de faciliter les mises à jour. + +Enfin, les changements décrits par Donald Knuth dans « \TeX\ tuneup of 2008 » +(voir \url{http://tug.org/TUGboat/Articles/tb29-2/tb92knut.pdf}) sont inclus +dans la présente édition. + +\subsubsection{2009} +\label{sec:2009news} % keep with 2009 + +En 2009, le format de sortie par défaut de Lua\AllTeX\ est maintenant le +\acro{PDF} afin de profiter de la prise en charge des polices OpenType et +autres fonctionnalités de Lua\TeX. De nouveaux exécutables nommés +\code{dviluatex} et \code{dvilualatex} fournissent une sortie \acro{DVI}. La +page d'accueil de Lua\TeX{} est \url{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. + +\TL fournit la nouvelle version des polices \TypeI{} de l'\acro{AMS}, y compris +Computer Modern : les quelques changements de formes faits au cours des ans par +Knuth dans les sources \MF{} ont été intégrés, et le \eng{hinting} a été +amélioré. Les polices Euler ont été en grande partie redessinées par Hermann +Zapf (voir \url{http://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'\acro{AMS} est \url{http://www.ams.org/tex/amsfonts.html}. + +Le nouvel éditeur intégré \TeX{}works est fourni pour Windows, ainsi que dans +Mac\TeX. Pour les autres plate-formes, ainsi que d'autres informations, voir la +page de \TeX{}works : \url{http://tug.org/texworks}. Cet éditeur fonctionnant +sur de nombreuses plate-formes, inspiré par l'éditeur \TeX{}shop de \MacOSX, +vise à faciliter l'utilisation de \TeX. + +Le programme de création de graphiques Asymptote est fourni pour plusieurs +plate-formes. Il fournit un langage de description de graphiques en mode texte +plus ou moins du même genre que \MP{}, mais avec, entre autres, des +fonctionnalités 3D avancées. Sa page d'accueil est +\url{http://asymptote.sourceforge.net}. + +Le programme \code{dvipdfm} séparé a été remplacé par \code{dvipdfmx} qui, +lorsqu'il est appelé par ce nom, travaille dans un mode de compatibilité +spécifique. Le programme \code{dvipdfmx} fournit des fonctionnalités pour les +écritures \acro{CJK} et inclut de nombreux correctifs accumulés au fil des ans +depuis la dernière sortie de \code{dvipdfm}. Sa page d'accueil est +\url{http://project.ktug.or.kr/dvipdfmx}. + +Des exécutables pour les plate-formes \pkgname{cygwin} et \pkgname{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 +difficile sur ces plate-formes de fabriquer des binaires qui aient une chance +de fonctionner sur plus d'une version. + +Quelques autres changements en vrac : nous utilisons maintenant \pkgname{xz}, +qui remplace \pkgname{lzma} (\url{http://tukaani.org/xz/}), +pour comprimer nos archives ; un |$|\iffalse|$|\fi littéral est autorisé dans +les noms de +fichiers 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 \MP{}) ; le +processus complet de compilation de \TL est maintenant basé sur Automake. + +Remarque finale concernant le passé : toutes les anciennes distributions \TL{} +ainsi que les jaquettes des \CD{} correspondants sont disponibles ici : +\url{ftp://tug.org/historic/systems/texlive}. + +% +\subsubsection{2010} +\label{sec:2010news} % keep with 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'à \code{dvipdfmx}. Pour revenir au +format PDF 1.4, vous pouvez charger le paquet \pkgname{pdf14} sous \LaTeX{}, +ou régler manuellement |\pdfminorversion=4| (sous pdf\TeX). + +pdf\AllTeX\ convertit maintenant \emph{automatiquement} les fichiers EPS +utilisés au format PDF, en utilisant le paquet \pkgname{epstopdf}, dans tous +les cas où le fichier de configuration \LaTeX{} \code{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 fichier +PDF créé manuellement, mais vous pouvez aussi empêcher le chargement +d'\pkgname{epstopdf} en plaçant |\newcommand{\DoNotLoadEpstopdf}{}| (ou +|\def...| avant la déclaration \cs{documentclass}. Le paquet n'est pas chargé +non plus si \pkgname{pst-pdf} est utilisé. Pour plus de détails, reportez-vous +à la documentation du paquet \pkgname{epstopdf} +(\url{http://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 \code{repstopdf}, +\code{makeindex}, \code{kpsewhich}, \code{bibtex}, et \code{bibtex8} ; cette +liste est définie dans \file{texmf.cnf}. Si vous souhaitez désactiver cette +fonctionnalité, vous pouvez désélectionner cette option à l'installation +(section~\ref{sec:options}), ou modifier 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 Makindex +refusent désormais par défaut d'écrire leur fichier 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 modifier ce comportement, vous +pouvez utiliser la variable d'environnement \envname{TEXMFOUTPUT}, ou modifier +la valeur de |openout_any|. + +\XeTeX{} offre désormais un ajustement optique des marges similaire à celui de +pdf\TeX. (La dilatation des fontes n'est pas contre pas disponible +actuellement.) + +Par défaut, \prog{tlmgr} garde maintenant une copie de sauvegarde de tous les +paquets mis à jour (\code{tlmgr option autobackup 1}) pour permettre de +revenir facilement à l'ancienne version au cas où la nouvelle soit +cassée, en utilisant \code{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 \code{tlmgr option autobackup 0}. + +De nouveaux programmes sont inclus : le moteur p\TeX{} et les utilitaires reliés +pour la composition du japonais ; le programme \BibTeX{}U qui est une version +de \BibTeX\ gérant Unicode ; l'utilitaire \prog{chktex} +(\url{http://baruch.ev-en.org/proj/chktex}) pour vérifier les documents +\AllTeX ; le programme de conversion DVI vers SVG \prog{dvisvgm} +(\url{http://dvisvgm.sourceforge.net}). + +Nous fournissons des exécutables pour les nouvelles plate-formes suivantes : +\code{amd64-freebsd}, \code{amd64-kfreebsd}, \code{i386-freebsd}, +\code{i386-kfreebsd}, \code{x86\_64-darwin} et \code{x86\_64-solaris}. + +Un changement dans \TL 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 \code{mk4ht} permet de lancer les nombreuses variantes de +\code{tex4ht}. + +Enfin, \TL telle qu'elle est présentée dans le \DVD\ \TK{} ne peut plus être +exécutée de façon portable (en \emph{live}) --- contrairement à ce qu'indique +le nom. Il n'y a désormais plus assez de place sur un seul \DVD. Un effet +secondaire agréable de cette nouvelle disposition est que l'installation +depuis un \DVD\ physique est maintenant être beaucoup plus rapide. + +\subsubsection{2011} + +Les binaires pour \MacOSX\ (\code{universal-darwin} et \code{x86\_64-darwin}) +ne fonctionnent désormais que sous Leopard ou une version ultérieure ; Panther +et Tiger ne sont plus supportés. + +Le programme \code{biber} pour le traitement des bibliographies est inclus +pour les plateformes les plus courantes. Son développement suit de près celui +du paquet \code{biblatex} qui réimplémente totalement la gestion des +bibliographies sous \LaTeX. + +Le programme MetaPost (\code{mpost}) ne crée plus et n'utilise plus de +fichiers \code{.mem}. Les fichiers utiles, comme \code{plain.mp}, sont +simplement traités à chaque exécution. Ceci est relié au support 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 \code{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 à +par une exécution bien plus rapide. + +% +\htmlanchor{news} +\subsection{Version présente} +\label{sec:tlcurrent} + +\code{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 \code{tlmgr} (utiliser \code{tlmgr help} par +exemple). + +Le paramètre \cs{XeTeXdashbreakstate} est réglé à~1 par défaut, pour +\code{xetex} et \code{xelatex}. Ceci autorise les coupures de lignes après les +tirets quadratins et demi-quadratins, ce qui a toujours été le comportement de +\TeX, \LaTeX, Lua\TeX, etc. Si des documents \XeTeX\ existants doivent +conserver une parfaite compatibilité au niveau des coupures de lignes, il +devront mettre \cs{XeTeXdashbreakstate} à~0 explicitement. + +Les fichiers de sortie générés par \code{pdftex} et \code{dvips}, entre +autres, peuvent maintenant dépasser les 2~Go. + +Les 35 polices Postscript standard sont incluses par défaut dans la sortie de +\code{dvips}, car il y en a trop de versions différentes dans la nature. + +Dans le mode d'éxécution par \cs{write18} limité (le mode par défaut), la +commande \code{mpost} est maintenant autorisée. + +Un fichier \code{texmf.cnf} placé dans \filename{../texmf-local} (par exemple +: \filename{/usr/local/texlive/texmf-local/web2c/texmf.cnf}) sera trouvé et +utilisé s'il existe. + +Le script \code{updmap} lit maintenant un fichier \code{updmap.cfg} par +arborescence au lieu d'un seul fichier global. Ce changement devrait être +invisible à moins que vous n'ayez édité vos fichiers \code{updmap.cfg} +directement. Voir la sortie de \code{updmap --help} pour plus de détails. + +Plate-formes : \pkgname{armel-linux} et \pkgname{mipsel-linux} ont été ajoutés +; \pkgname{sparc-linux} et \pkgname{i386-netbsd} ne font plus partie de la +distribution principale, mais sont disponibles en tant que plate-formes +complémentaires, ainsi que d'autres plate-formes : +\url{http://tug.org/texlive/custom-bin.html}. + +\subsection{Versions futures} + +\emph{\TL{} n'est pas un produit parfait !} (et ne le sera jamais). Nous +prévoyons de continuer à produire de nouvelles versions et aimerions fournir +plus d'aide, de fonctionnalités, de programmes d'installation et (bien sûr) +une arborescence améliorée et vérifiée de macros et de fontes. Ce travail est +effectué par des volontaires sur leur temps libre, et il y a toujours plus à +faire. Si vous pouvez nous aider, n'hésitez pas à nous contacter (cf. +\url{http://tug.org/texlive/contribute.html}). + +Corrections, suggestions et propositions d'aide doivent être envoyées à : +\begin{quote} +\email{tex-live@tug.org} \\ +\url{http://tug.org/texlive} +\end{quote} + +\medskip +\noindent \textsl{Bon travail avec \TeX{} !} + +\end{document} + +%%% Local Variables: +%%% mode: latex +%%% mode: flyspell +%%% ispell-local-dictionary: "francais" +%%% TeX-master: t +%%% coding: utf-8 +%%% End: +% vim: spell spelllang=fr |