diff options
Diffstat (limited to 'Master/texmf')
| -rw-r--r-- | Master/texmf/doc/texlive/texlive-fr/live.tex | 3945 |
1 files changed, 0 insertions, 3945 deletions
diff --git a/Master/texmf/doc/texlive/texlive-fr/live.tex b/Master/texmf/doc/texlive/texlive-fr/live.tex deleted file mode 100644 index ccb25a86f0b..00000000000 --- a/Master/texmf/doc/texlive/texlive-fr/live.tex +++ /dev/null @@ -1,3945 +0,0 @@ -%Format: pdf - -% $Id: //depot/Master/texmf-doc/source/english/texlive-en/live.tex#31 $ -% $Author: staw $ $Date: 2005/10/31 $ -% -% Change history (started May 18th 2002) -% 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 and Jacques André -% 2002/05/25: proof-reading and corrections, by Daniel Flipo -% 2002/05/18: synced with English version, by Fabrice -% -\documentclass{article} -%\let\tldocenglish=1 % *NOT* for French - -\usepackage[latin1]{inputenc} - -\usepackage{caption} -\DeclareCaptionLabelSeparator{endash}{\space\textendash\space} -\captionsetup{labelsep=endash} - -\usepackage[frenchb]{babel} -\usepackage{xspace} -\addto\captionsfrench{\def\figurename{{\scshape Figure}}} -\addto\captionsfrench{\def\tablename{{\scshape Table}}} -\AddThinSpaceBeforeFootnotes -\FrenchFootnotes -\NoAutoSpaceBeforeFDP - -\newcommand{\THANH}{Hàn Th\'{ê} Thanh} - -\usepackage{comment} - -\usepackage{ifpdf} -% tex-live.sty suppose \hyper@linkurl défini... -\ifpdf - \def\Status{1} % (df) Pour faire charger hyperref dans tex-live.sty -\else - \makeatletter - \def\hyper@linkurl#1#2{#2} % undefined if hyperref.sty not loaded - \makeatother -\fi - -\usepackage{tex-live} -%%%% Ajout J.A. à garder -\newcommand{\CDdemo}{\acro{CD} \pkgname{demo}\xspace} -\newcommand{\CDinst}{\acro{CD} \pkgname{inst}\xspace} -\newcommand{\DVDlive}{\acro{DVD} \pkgname{live}\xspace} -\renewcommand{\samp}[1]{\og \texttt{#1}\fg{}} - -%%%% Ajout (df) -% Alias -\let\XemTeX\XEmTeX -% (df) La commande \TeXLive n'est pas utilisée en v.f. -\renewcommand{\TL}{\TeX{} Live\xspace}% Robuste (pas besoin de \protect)... -% tex-live.sty fait précéder les no de page d'une fine... si on veut -% une insécable normale, décommenter la ligne suivante : -\def\p.{p.~} -% Chez Karl, la commande \url{} ne protège pas les caractères actifs (:?), -% d'où ceci (essai provisoire... erreurs avec le car. #) : -%\let\urlORI\url -%\renewcommand*{\url}[1]{\foreignlanguage{english}{\urlORI{#1}}} -%\renewcommand*{\url}[1]{{\shorthandoff{:?!;}\urlORI{#1}}} -% La commande \path de url.sty ajoute des espaces parasites, pas \url, d'où -\let\path\url -% mais ceci impose de remplacer \path|...| par \path{...}, et les \$ inclus -% par des $. - -\setlength{\parindent}{0mm} -\addtolength{\parskip}{.25\baselineskip} - -\begin{document} - -\title{{\huge Guide pratique de \TL{}} \\ \strut - {\LARGE\textsf{\TK{} 2007}} - } - -\author{Karl Berry \\[3mm] - \url{http://tug.org/texlive/}\\[5mm] - \textit{Version française}\\[3mm] - Daniel Flipo (GUTenberg) - } - -\date{Janvier 2007} - -\maketitle -\thispagestyle{empty} % no need for page number - -\newpage -\begin{multicols}{2} -\tableofcontents -\listoftables -\end{multicols} - -\section{Introduction} -\label{sec:intro} - -Ce document décrit les principales caractéristiques de la -distribution \TL{}, une distribution de \TeX{} et \LaTeX{} -pour Linux et autres Unix, \MacOSX{} et systèmes Windows 32 bits -(attention, cette distribution n'est pas vraiment utilisable avec -les anciens systèmes Mac ou \acro{MS-DOS}). Elle comprend les binaires -pré-compilés de \TeX{}, \LaTeXe{}, \MF, \MP, \BibTeX{} et de nombreux -autres programmes ainsi qu'une bibliothèque étendue de macros, de -fontes et de documentations. Elle traite aussi la composition de textes -qui utilisent plusieurs systèmes d'écritures différentes venant de toute -la surface du globe. -La distribution \TL{} est en fait un sous-ensemble de \TK{} (décrit brièvement -à la section ~\ref{sec:struct-tl}, \p.\pageref{sec:struct-tl}) -produit grâce aux efforts combinés des différents groupes d'utilisateurs -de \TeX. - -L'édition 2007 a été figée en janvier 2007. -Les futures mises à jour des composants de la distribution 2007 -seront disponibles au fur et à mesure de leur parution sur le site -\acro{CTAN}, \url{http://www.ctan.org}. - -On trouvera à la fin du document, section~\ref{sec:history} -(\p.\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{tlcurrent} -\p.\pageref{tlcurrent} qui présente les principaux changements intervenus -cette année. - - -\subsection{Utilisation élémentaire de \TL{}} -\label{sec:basic} - -Vous pouvez utiliser \TL{} de trois façons différentes : -\begin{enumerate} -\item Vous pouvez exécuter \TL{} directement depuis le - \DVDlive{} (toutes plates-formes). - Cela prend très peu d'espace disque et - donne un accès immédiat à tout le contenu de - \TL. C'est une solution parfaitement acceptable même si les - performances obtenues sont moins bonnes que si \TL{} était - lancé depuis un disque local. -\item Vous pouvez installer tout ou partie de \TL{} sur un disque - local. C'est l'utilisation la plus fréquente de \TL{}. - Ceci peut se faire à partir du \DVDlive{} ou de l'un des \CD de la - distribution (voir section~\ref{sec:multiple-dist}, - \p.\pageref{sec:multiple-dist}). - Il faut disposer d'un minimum de 120\,Mo, mais on recommande au moins -%(df) un peu mensonger... schéma GUT = 800 Mo chez moi ! - 400\,Mo pour un système standard ou 800\,Mo pour un système complet. -\item Vous pouvez incorporer un jeu de composants particulier ou une - collection dans un système \TeX{} déjà présent, soit un - système \TL{} installé précédemment, soit un système \TeX{} différent. -\end{enumerate} - -Ces trois utilisations sont décrites en détail dans les sections -concernant l'installation spécifique à chaque système. -Quelques remarques générales : - -\begin{itemize} - -\item Le script d'installation globale pour Unix et pour \MacOSX{} s'appelle -\texttt{install-tl.sh}. -Les utilisateurs de Linux peuvent aussi essayer le nouvel installeur -\texttt{setuptl/tlpmgui} développé au départ pour Windows et adapté à Linux. -Consulter la section \ref{sec:win-install} p.~\pageref{sec:win-install} pour -plus d'informations. - -\item Pour installer une extension ou une collection, on utilise le script - d'installation \texttt{install-pkg.sh}. -Après une installation faite à l'aide de \texttt{tlpmgui}, il est possible -d'utiliser \texttt{tlpmgui} pour ajouter ou supprimer des extensions ou des -collections. - -\item Le programme d'installation pour Windows s'appelle - \cmdname{tlpmgui.exe}, il sert aussi à ajouter ou supprimer des composants - dans une installation existante (voir section~\ref{sec:win-install}). - -\end{itemize} - -\subsection{Obtenir de l'aide} -\label{sec:help} - -La communauté \TeX{} est à la fois active et conviviale ; pratiquement -toute question sérieuse finit par obtenir une réponse. Le support est -pourtant informel, assuré par des volontaires et des lecteurs -occasionnels, aussi est-il particulièrement important que vous fassiez -votre propre travail de recherche avant de poser la question (si vous -préférez un support commercial, vous pouvez renoncer à \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 \DVDlive{} dans - \OnCD{texmf-doc/doc/english/FAQ-en} - 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, ... particuliers, il faut examiner le catalogue - \TeX{}. C'est une importante liste de tous les éléments relatifs à - \TeX{}. Voir \OnCD{texmf-doc/doc/english/catalogue} sur le \DVDlive{}, - ou \url{http://www.ctan.org/tex-archive/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 news 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=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 n'obtenez pas de réponse, vous - pouvez poster la question à \dirname{comp.text.tex} via Google ou - votre lecteur de news, ou encore par messagerie à - \email{texhax@tug.org}. 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 : - \url{http://www.tex.ac.uk/cgi-bin/texfaq2html?label=askquestion}. - -\item [Support de \TL{}] Si vous voulez faire un rapport - d'anomalie, émettre des suggestions ou des commentaires sur la - distribution \TL{}, l'installation ou la 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 écriviez directement à la - personne ou à la liste de diffusion qui maintient le programme. - -\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. -Bienvenue dans le monde \TeX{} ! - -% No \protect needed as \TL is defined in French with \newcommand (robust). -\section{Structure de \TL} -\label{sec:struct-tl} - -Nous décrivons ici la structure et le contenu de \TL{} et -de \TK{} qui est un sur-ensemble de \TL. - -\subsection {Distributions multiples : \protect\pkgname{live}, - \protect\pkgname{inst}, \protect\pkgname{protext}} -\label{sec:multiple-dist} - -Des limitations d'espace liées au format des \acro{CD-ROM} nous ont contraint -à diviser \TK{} en plusieurs distributions : - -\begin{description} - -\item [live] Un système exécutable complet sur \acro{DVD} ; il est - trop volumineux pour tenir sur \acro{CD-ROM}. Le \DVD{} contient - aussi une image du système \CTAN{}, totalement indépendant de - \TL{}, la distribution Mac\TeX{} pour \MacOSX, la distribution \ProTeXt{} - pour Windows, ainsi que d'autres extensions - réunies dans un répertoire \texttt{texmf-extra}. - - Les droits d'utilisation des fichiers présents dans \CTAN, \ProTeXt, - Mac\TeX{} 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. - -\item [inst\textrm{(allable)}] Un système complet sur \CD{} pour les Unix - (dont Linux et \MacOSX{}) ; pour le faire - tenir sur le \CD, il a fallu compresser tout ce que nous avons - pu. Du coup, il n'est pas possible d'exécuter directement \TeX\ - depuis le \CD\ d'installation, il vous faut l'installer sur disque - (d'où le nom). L'installation est décrite dans les sections - concernées (\ref{sec:unix-install-disk} et \ref{sec:osx-unix-inst} - pour \MacOSX). - -\item [protext] Une extension du système \MIKTEX\ sur \CD{} pour - Windows. Cette distribution est totalement indépendante du \TL{}, - elle nécessite un mode d'installation spécifique. - Elle peut être installée sur disque ou exécutée directement - depuis le \CD. Le site de \ProTeXt\ se trouve ici : - \url{http://tug.org/protext}. - - \pkgname{protext} est fourni à la fois sur le \DVDlive{} et - sur un \CD{} spécifique pour ceux qui n'ont pas de lecteur de \DVD. - -\end{description} - -\noindent On peut déterminer la nature de la distribution -utilisée en recherchant le fichier \texttt{00\var{type}.TL} dans le -répertoire racine du médium utilisé (\CD{} ou \DVD{}). -Ce fichier contient aussi la date de dernière mise à jour du \TL. - -%(df) Que fait GUT ? -%Naturally, each user group chooses what to distribute, at its own -%discretion. - -\subsection{Répertoires situés à la racine} -\label{sec:tld} - -Les répertoires les plus importants situés à la racine -% (df) bin et source ne sont pas sur \CDinst -du \DVDlive{} -sont énumérés ci-dessous. Cette année, la distribution \TL{} -est dans un sous-répertoire \dirname{texlive2007} et non à la racine. -%%% (df) confus : on parle du CD ou du DVD -\smallskip -\begingroup - \renewcommand{\arraystretch}{1.3} % open up interrow spacing -\begin{tabular}{>{\ttfamily}lp{.78\hsize}} -% (df) bin pas présent sur \CDinst : les .zip des binaires sont dans 'archive' -bin & Programmes de la famille \TeX{}, rangés dans des - sous-répertoires selon les plates-formes. \\ -% pas sur \CDinst -source & Le code source de tous les programmes, incluant la - distribution \Webc{} de \TeX{} et \MF{}. Il s'agit d'une archive au - format \texttt{tar}, compressée par bzip2. - % Ajout (df) - Faute de place, le répertoire \texttt{source} - n'est pas sur le \CDinst{} (seulement sur le \DVDlive{}).\\ -setuptl & Programmes d'installation pour Windows et Linux. \\ -support & Ensemble d'extensions et programmes auxiliaires. Ils ne - sont \emph{pas} installés par défaut. -% Faux (df) -% On y trouve \cmdname{Ghostscript}, \cmdname{netpbm} et un ensemble -% d'éditeurs orientés \TeX{}. -\\ -texmf & Répertoire contenant les programmes et leur documentation. - Ne contient ni les formats ni les extensions - (appelé \envname{TEXMFMAIN} dans la section suivante.) \\ -texmf-dist & Répertoire principal où se trouvent les extensions, - les fontes, etc., avec leur documentation - (appelé \envname{TEXMFDIST} dans la section suivante.) \\ -texmf-doc & Répertoire contenant le reste de la documentation, - le sous-répertoire doc est organisé par langue. \\ -texmf-var & Répertoire contenant les fichiers générés automatiquement - (appelé \envname{TEXMFSYSVAR} dans la section suivante.) \\ -\end{tabular} -\endgroup - -\smallskip - -Le répertoire \dirname{texmf-doc} ne contient que de la documentation -mais pas toute la documentation. Celle concernant les programmes (manuels, -pages \textit{man} et fichiers de type \textit{info} est dans -\dirname{texmf/doc} car les programmes correspondants sont dans -\dirname{texmf}. De même, la documentation des extensions et formats -est dans \dirname{texmf-dist/doc}. Les commandes \cmdname{texdoc} ou -\cmdname{texdoctk} trouveront pour vous les documentations où quelles soient -sur le disque. % Bof... pas vrai chez moi (df) ? -Le fichier \OnCD{doc.html} du \DVDlive{} contient une liste de liens bien -utiles pour localiser les fichiers de documentation. - -On trouve également, au même niveau que les répertoires mentionnés ci-dessus, -les scripts d'installation et les fichiers \filename{README} (dans -différentes langues). - -\subsection{Description des arborescences texmf utilisées} -\label{sec:texmftrees} - -Nous donnons ici la liste complète des variables prédéfinies qui contiennent -les noms des différentes arborescences de type texmf et l'usage qui en est -fait. La commande \cmdname{texconfig conf} retourne les valeurs de ces -variables, ce qui permet de savoir où se trouvent ces différentes -arborescences dans une installation donnée. - -\begin{ttdescription} -\item [TEXMFMAIN] contient les éléments essentiels du système, comme les - scripts (\cmdname{web2c/mktexdir}, etc.), les fichiers \file{.pool}, - etc. -\item [TEXMFDIST] contient les fichiers de macro (Plain, \LaTeX, \ConTeXt, - etc.,), les fontes, etc., de la distribution \TL. Rien ne devrait être - ni ajouté ni supprimé dans cette arborescence. -\item [TEXMFLOCAL] c'est là que l'administrateur de la machine - place 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 sous \verb+$HOME+ % $ - par défaut. La variable \envname{TEXINPUTS} ne devrait plus être utilisée. -\item [TEXMFCONFIG] c'est là que les scripts \cmdname{updmap} et - \cmdname{fmtutil} recherchent leurs fichiers de configuration en priorité. - \cmdname{texconfig} y place les versions modifiées des fichiers de - configuration. Sous \verb+$HOME+ par défaut. %$ -\item [TEXMFSYSCONFIG] c'est là que les scripts \cmdname{updmap-sys} et - \cmdname{fmtutil-sys} recherchent leurs fichiers de configuration en - priorité. \cmdname{texconfig-sys} y place les versions modifiées des - fichiers de configuration. -\item [TEXMFVAR] c'est là que les scripts \cmdname{texconfig}, - \cmdname{updmap} et \cmdname{fmtutil} rangent les formats et les fichiers - \file{.map} qu'ils produisent. Sous \verb+$HOME+ par défaut. %$ -\item [TEXMFSYSVAR] c'est là que les scripts \cmdname{texconfig-sys}, - \cmdname{updmap-sys} et \cmdname{fmtutil-sys} rangent les formats et les - fichiers \file{.map} qu'ils produisent. -\end{ttdescription} - -Les possibilités offertes par \cmdname{texconfig} sont décrites à la - section~\ref{sec:texconfig}, \p.\pageref{sec:texconfig}. - - -\subsection{Les extensions de \TeX} -\label{sec:tex-extensions} - -\TL{} contient plusieurs extensions de \TeX{}. - -\begin{description} - -\item [\eTeX{}] \label{text:etex} ajoute un jeu, petit mais puissant, - 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 \DVDlive{}. - -\item [pdf\TeX{}] inclut les extensions \eTeX{} et produit, au choix, - des fichiers au format Acrobat \acro{PDF} ou au format \dvi{}. - Le manuel d'utilisation se trouve sur le \DVDlive{} - dans \OnCD{texmf/doc/pdftex/manual/}. Le fichier - \OnCD{texmf/doc/pdftex/pdftex/manual/samplepdf/samplepdf.tex}\relax{} - donne un exemple d'utilisation. pdf\TeX{} est le moteur de base - sur lequel sont construits tous les formats autres que plain\TeX. - -\item [Xe\TeX] ajoute la possibilité d'utiliser le codage Unicode en entrée - et les fontes OpenType en sortie, ceci grâce à des bibliothèques - externes : voir \url{http://scripts.sil.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 entier. - 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. Voir la documentation - (pas vraiment à jour) dans \OnCD{texmf-dist/doc/omega/base/doc-1.8.tex}. - -\item [Aleph] combine les fonctionnalités de \OMEGA\ et de \eTeX. - \OnCD{texmf-dist/doc/aleph/base} contient une documentation de 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] Traitement de la bibliographie. - -\item [makeindex] 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 [dv2dt, dt2dv] Conversion \dvi{} vers ou depuis du texte simple. - -\item [dviconcat, dviselect] Couper/Coller de pages à partir de fichiers - \dvi{}. - -\item [dvipdfmx] Conversion \dvi{} vers \acro{PDF}, une autre approche que - celle de pdf\TeX\ (mentionné ci-dessus). Voir les extensions - \pkgname{ps4pdf} et \pkgname{pdftricks} pour d'autres alternatives. - -\item [psselect, psnup, \ldots] Utilitaires \PS{}. - -\item [lacheck] Vérification de syntaxe \LaTeX{}. - -\item [texexec] Processeur Con\TeX{}t et \acro{PDF}. - -\item [tex4ht] Conversion \TeX{} vers \acro{HTML}. - -\end{cmddescription} - - -\section{Utilisation sous Unix} -\label{sec:unix-install} - -Comme on l'a vu en section~\ref{sec:basic} \p.\pageref{sec:basic}, -le \TL{} peut être utilisé de trois façons principales : - -\begin{enumerate} -\item Exécution directe depuis le \DVDlive. -\item Installation sur le disque dur. -\item Intégration d'un jeu de composants ou collections dans un système -\TeX{} déjà installé. -\end{enumerate} - -\noindent -Les procédures spécifiques à Unix sont décrites pour chacun de ces cas -dans les sections qui suivent. - -\ifSingleColumn \begin{figure}[ht]\noindent \fi -\begin{warningbox} - \textbf{ATTENTION : } Les \CD{} et le \DVD{} sont au format ISO~9660 - (High Sierra), avec les extensions \og Rock Ridge\fg{} (et \og Joliet\fg{} - pour Windows). Votre système doit pouvoir reconnaître les - extensions \og Rock Ridge\fg{} pour une utilisation optimale de - \TL{}. Consultez votre documentation concernant la commande - \cmdname{mount} pour voir si c'est le cas. Si votre réseau local est - constitué de machines différentes, regardez - si vous pouvez monter les \CD{} sur une machine qui supporte - Rock Ridge et utiliser ce point de montage pour les autres machines. - -\leavevmode\quad -L'utilisation des \CD{} sur les systèmes modernes -ne devrait pas poser de problèmes. S'il y en avait, n'hésitez pas à -nous le faire savoir. -La suite de ce document suppose que vous avez installé et monté les - \CD{} avec une compatibilité Rock Ridge parfaite. -\end{warningbox} - -\ifSingleColumn\end{figure}\fi - -N.B. : les droits de \og root \fg{} sont souvent requis pour monter le \CD{}. -D'autre part, selon le type d'Unix utilisé, il vous faudra probablement -connaître le mot de passe de \og root \fg{} ou tout au moins utiliser la -commande \cmdname{sudo} pour effectuer l'installation (le droit -d'écriture sur le(s) répertoire(s) d'installation est évidemment -indispensable). Cette remarque concerne particulièrement les utilisateurs de -\MacOSX{} à qui nous recommandons de prendre d'abord connaissance de la -section~\ref{sec:mac-install} avant toute installation. - - -\subsection{Utiliser \TL{} à partir du \DVDlive} - -La liste des architectures sur lesquelles fonctionne \TL{} est donnée -page~\pageref{tab:archlist} (table~\ref{tab:archlist}). - -\def\runlive{% text repeated in windows section -On peut utiliser le système \TeX{} directement depuis \DVDlive, -sans l'installer sur le disque dur (d'où en fait le nom \TL). -Il \emph{n'est pas possible} de faire tourner \TeX{} directement -depuis le \CDinst{} (voir section~\ref{sec:multiple-dist}, -page~\pageref{sec:multiple-dist}). -}% fin \runlive - -\def\startinst{% repeated in other subsections -Pour démarrer, il faut d'abord \og monter \fg{} le médium avec les -extensions Rock Ridge. -La commande exacte varie d'un système à l'autre ; la commande suivante -fonctionne sous Linux, mais les noms du périphérique (ici -\filename{/dev/cdrom}) et du point de montage (ici \dirname{/mnt/cdrom}) -peuvent changer. -\\ N.B. Tous nos exemples utilisent \texttt{>} pour les lignes de -commandes \textit{(shell prompt)} ; les commandes de l'utilisateur sont -\underline{soulignées}. -\begin{alltt} -> \Ucom{mount -t iso9660 /dev/cdrom /mnt/cdrom} -\end{alltt} - -\noindent Se placer au point de montage du lecteur : -\begin{alltt} -> \Ucom{cd /mnt/cdrom} -\end{alltt} -}% fin startinst - -\def\installtlsh{% repeated in other subsections -Lancer le script \filename{install-tl.sh} : -\begin{alltt} -> \Ucom{sh install-tl.sh}\\ -Welcome to TeX Live... -\end{alltt} - -\noindent Après l'affichage de divers messages de bienvenue et une liste des -options du menu principal, l'installation réclame l'entrée d'une commande. -Taper alors le caractère voulu suivi d'un retour-chariot. Ne pas taper les -chevrons (ni \texttt{<} ni \texttt{>}) ; on peut utiliser des majuscules ou -des minuscules ; ici, les exemples utilisent des minuscules. -}% fin \installtlsh - -\runlive -\startinst -\installtlsh - -Pour exécuter \pkgname{live}, la première commande est \Ucom{d} -suivie de la sous-commande \Ucom{1} pour choisir le répertoire du disque -local où seront placés les fichiers (tels que les fontes et les formats) que -le système \TeX{} génère lui-même ainsi que les fichiers de configuration si -besoin est. On utilisera \dirname{/opt/texlive2007} dans cet exemple, -mais un utilisateur non privilégié peut très bien choisir un -sous-répertoire non-existant de son répertoire personnel (il sera créé -et ne contiendra donc que du matériel \TL{}). -Étant donné que les fichiers créés ne sont pas toujours compatibles d'une -année sur l'autre, il est recommandé d'inclure l'année dans le nom du -répertoire. -Si la valeur par défaut \dirname{/usr/local/texlive/2007} vous convient -(c.-à-d. que \dirname{/usr/local/texlive/2007} n'est pas un répertoire -existant et que vous avez les droits pour écrire sous \dirname{/usr/local}), -vous pouvez sauter cette étape. -\begin{alltt} -Enter command: \Ucom{d} -Current directories setup: -<1> TEXDIR: /usr/local/texlive/2007 -... -Enter command: \Ucom{1} -New value for TEXDIR [/usr/local/texlive/2007]: \Ucom{/opt/texlive2007} -... -Enter command: \Ucom{r} -\end{alltt} - -Retour au menu principal. La seconde (et dernière) commande est -\Ucom{r} -pour faire tourner \pkgname{live} à partir du \DVD{} sans pour autant -l'installer sur le disque dur : - -\begin{alltt} -Enter command: \Ucom{r} -Preparing destination directories... -... -Welcome to the TeX Live! -> -\end{alltt} - -On se retrouve au niveau de la ligne de commande -comme on vient de le voir. - -Il faut maintenant modifier les deux variables -d'environnement \envname{PATH} et \envname{TEXMFSYSVAR} comme indiqué -à l'écran quelques lignes au dessus de \og Welcome to TeX Live!\fg. -La syntaxe dépend du \textit{shell} utilisé. Les syntaxes -précises sont affichées pour les \textit{shell} de type Bourne ou compatible -(\cmdname{bash}, \cmdname{sh} \cmdname{ksh}, etc.) et pour les -\textit{C~shells} (\cmdname{csh}, \cmdname{tcsh}). -Rappelons qu'il suffit de taper la commande \verb+echo $SHELL+ %$ -pour connaître le nom du \textit{shell} utilisé. -Le plus simple est de recopier par copier-coller, soit les deux lignes -commençant par \og\cmdname{setenv}\fg{} pour les \textit{C~shells}, -soit les trois lignes \og\envname{PATH=}\fg, \og\envname{TEXMFSYSVAR=}\fg, -\og\envname{export ...}\fg{} pour les \textit{shell} de type Bourne -(suivies d'un retour-chariot) dans le terminal de commandes. - -Ceci suffit pour pouvoir utiliser la distribution \TL{} -pendant toute la session. -Pour ne pas avoir à redéfinir \envname{PATH} et \envname{TEXMFSYSVAR} -à chaque nouvelle connexion, il suffit d'entrer les mêmes commandes -à l'aide d'un éditeur dans le fichier d'initialisation du \textit{shell} -(\file{.bash\_profile}, \file{.profile} ou \file{.cshrc} -selon le cas). -L'initialisation se fera ensuite automatiquement au début de chaque nouvelle -session. - -\def\textruntexconfig{% - Une fois l'installation terminée et les variables d'environnement - initialisées, la dernière étape consiste à exécuter \cmdname{texconfig} ou - \cmdname{texconfig-sys} pour éventuellement modifier certains paramètres. - Ceci est expliqué à la section~\ref{sec:texconfig}, - \p.\pageref{sec:texconfig}.% -} -\textruntexconfig - -\def\textifindoubt{% -Passez maintenant à la section~\ref{sec:test-install} pour effectuer -quelques tests de bon fonctionnement. - -En cas de doute, n'hésitez pas à contacter un gourou système pour -vous aider à résoudre vos problèmes, tels que la façon de monter le - médium \TL{}, le choix des répertoires à utiliser ou les modifications -à apporter dans vos fichiers d'initialisation. -}%fin textifindoubt -\textifindoubt - -\subsection{Installer \TL{} sur le disque} -\label{sec:unix-install-disk} - -Il est possible, et même habituel, d'installer le système \TeX{} à -partir du \TL{} sur le disque (\og dur\fg{}). -Ceci peut se faire en utilisant soit le \DVDlive, soit le \CDinst -(voir section~\ref{sec:multiple-dist}, \p.\pageref{sec:multiple-dist} -pour des explications sur les différentes distributions). - -\startinst -\installtlsh - -La table~\ref{tab:main-menu-options} donne la liste des options du menu -principal. On peut choisir les options dans n'importe quel ordre, mais -\Ucom{i} doit être la dernière choisie. Il est cependant raisonnable de -procéder dans l'ordre où elles apparaissent ici ! - -% apparently here.sty [H] doesn't support table*. -\begin{table}[H] -\caption{Options d'installation du menu principal} -\label{tab:main-menu-options} -\begin{tabular}{>{\ttfamily}ll} -p & plate-forme que vous utilisez\\ -b & choix des binaires à installer (architectures multiples)\\ -s & \emph{schéma d'installation} de base - (complet, recommandé, GUTenberg, etc.).\\ -c & modifier le choix des collections individuelles\\ -l & modifier le choix des langues à installer\\ -d & répertoire où faire l'installation\\ -o & autres options\\ -i & lancer l'installation\\ -\end{tabular} -\end{table} - -Voici quelques précisions sur chaque option. - -\begin{description} - -\item[\optname{p} -- Platform (current).] Plate-forme utilisée.\\ -Le script d'installation détecte automatiquement la plate-forme -sur laquelle il tourne, il est en général inutile de modifier cette option, -sauf en cas d'erreur. - -\item[\optname{b} -- Binary architectures.] Binaires pour d'autres -architectures.\\ -Par défaut, seuls les binaires pour votre plate-forme seront installés. À -l'aide de ce menu-ci, il est possible de choisir d'installer aussi les -binaires pour d'autres plates-formes (ou de ne pas installer pour la -plate-forme courante). C'est utile si on partage un arbre \TeX\ -au travers d'un réseau de machines hétérogènes. -La table~\ref{tab:archlist} ci-dessous donne la liste des architectures -pour lesquelles des binaires sont disponibles. - -\begin{table*}[!ht] -%\captionsetup{margin=5mm,justification=centerfirst} -\caption{Les binaires sont disponibles pour les architectures suivantes.} -\label{tab:archlist} -%(df) vérifier la liste finale -\begin{tabular}{>{\hspace*{15mm}\ttfamily}lll} -alpha-linux & HP Alpha GNU/Linux \\ -%alphaev5-osf4.0d & HP Alphaev5 OSF \\ -%hppa2.0-hpux10.20 & HP9000 HPUX 10.20 \\ -i386-darwin & Intel x86 \MacOSX \\ -i386-freebsd & Intel x86 FreeBSD \\ -i386-linux & Intel x86 GNU/Linux \\ -%i386-openbsd3.3 & Intel x86 OpenBSD \\ -%i386-solaris2.8 & Intel x86 Solaris \\ -mips-irix & SGI IRIX \\ -powerpc-aix & IBM RS/6000 AIX \\ -powerpc-darwin & PowerPC \MacOSX \\ -sparc-linux & Sun Sparc GNU/Linux \\ -sparc-solaris & Sun Sparc Solaris \\ -win32 & Windows (32-bit) \\ -x86\_64-linux & Intel x86 64-bit GNU/Linux \\ -% \\ \hline -\end{tabular} -\end{table*} - -\item[\optname{s} -- Base Installation scheme.] -Schéma d'installation de base.\\ -Ce menu permet de choisir un type d'installation plus ou moins complet. -L'option par défaut (\optname{full}) installe tout, c'est un bon choix si -l'espace disque n'est pas limité. Les francophones préféreront peut-être -le schéma \acro{GUT}enberg, mais on peut choisir un ensemble minimal -(\optname{basic}) pour économiser de la place sur le disque. On trouve -aussi des ensembles spécifiques pour Omega ou pour les utilisateurs -d'\acro{XML}. - -\item[\optname{c} -- Individual collections.] Collections individuelles.\\ -Ce menu permet d'ajouter ou de supprimer des collections -parmi celles retenues par le schéma choisi ci-dessus. -Chaque collection\Dash fichiers de macros TeX, familles de fontes Metafont, -etc.\Dash{} est formée de plusieurs composants. -Attention, le programme différencie les lettres minuscules -des lettres capitales pour les touches de sélection. - -\item[\optname{l} -- Language collections.] Collections de langues.\\ -Ce menu fonctionne comme celui de \Ucom{c} pour modifier -le choix des langues à installer. -Attention, le programme différencie les lettres minuscules -des lettres capitales pour les touches de sélection. - -Voici la liste des collections de langues du \TL{} -(on garde ici les noms anglais des options qui sont ceux du système !) : - -% xx really should generate list from texmf/tpm/collection/tex-lang* -% a la install-tl.sh. -\begin{tabbing} -\hspace{.25\linewidth} \= -\hspace{.20\linewidth} \= -\hspace{.20\linewidth} \= -\hspace{.35\linewidth} \kill -African \textit{(qq scripts)} \> -Arabic \> -Armenian \> -Chinese\,Japanese\,Korean \\ -Croatian \> -Cyrillic \> -Czech/Slovak \> -Danish \\ -Dutch \> -Finnish \> -French \> -German \\ -Greek \> -Hebrew \> -Hungarian \> -Indic \\ -Italian \> -Latin \> -Manju \> -Mongolian \\ -Norwegian \> -Polish \> -Portuguese \> -Spanish \\ -Swedish \> -Tibetan \> -\acro{UK} English \> -Vietnamese \\ -\end{tabbing} - -\noindent Les collections de langues comprennent normalement des fontes, -macros, motifs de césure et autres fichiers. Par exemple, -\pkgname{frenchle.sty} est installé lorsqu'on sélectionne la collection -\optname{French}. Par ailleurs, l'installation d'une langue de la collection -modifie le fichier de configuration \filename{language.dat} qui contrôle -quelles divisions (ou coupures de mots) sont chargées. - -\item[\optname{d} -- Installation directories] Choix des -répertoires d'installation.\\ \label{text:instdir} -Ceci concerne les trois répertoires suivants : - -\begin{ttdescription} -\item [TEXDIR] -Répertoire de plus haut niveau sous lequel tout le reste sera installé, -la valeur par défaut est \dirname{/usr/local/texlive/2007}. -Il est conseillé de faire figurer l'année dans le nom choisi, de façon à -pouvoir conserver séparément plusieurs versions de \TL. -L'ajout d'un lien symbolique -\dirname{/usr/local/texlive/current} qui pointe vers la version à utiliser -facilitera grandement le basculement d'une version -à l'autre et le retour à l'ancienne version en cas de problème. - -Sous \MacOSX, les interfaces utilisateurs recherchent \TeX{} -dans \dirname{/usr/local/teTeX} ; plutôt que d'installer la distribution \TL{} -dans ce répertoire, on pourra faire l'installation par défaut -(dans \dirname{/usr/local/texlive/2007} donc) et ajouter deux liens -symboliques : \dirname{current} qui pointe vers \dirname{2007} et -\dirname{teTeX} qui pointe vers \dirname{current}. Pour cela il suffit de -taper les deux commandes suivantes dans un terminal : -\begin{alltt} -> \Ucom{(cd /usr/local/texlive ; ln -s ./2007 ./current)} -> \Ucom{(cd /usr/local ; ln -s ./texlive/current teTeX)} -\end{alltt} - -\item [TEXMFLOCAL] -C'est dans cette arborescence que doivent être placés les fichiers -non fournis par \TL{}. -La valeur par défaut est \dirname{/usr/local/texlive/texmf-local}. -C'est l'endroit recommandé pour y mettre les classes et les fichiers de style -locaux, les fontes (par exemple commerciales) non disponibles -sur \TL{} ainsi que les paramètres de configuration locaux. - -\item [TEXMFSYSVAR] -C'est dans cette arborescence que les scripts \cmdname{texconfig-sys}, -\cmdname{fmtutil-sys}, \cmdname{updmap-sys} installent les fichiers qui -sont spécifiques à la version, notamment les fichiers de format. -La valeur par défaut est \dirname{TEXDIR/texmf-var}, il n'y a en -général aucune raison de la changer. -Les fichiers configuration modifiables par \cmdname{texconfig-sys} (voir -section~\ref{sec:texconfig}, \p.\pageref{sec:texconfig}), comme -\filename{fmtutil.cnf} et \filename{updmap.cfg}, sont eux dans -\envname{TEXMFSYSCONFIG}. -\end{ttdescription} - -\item[\optname{o} -- Other Options.] -Ce menu permet de choisir les options suivantes : - -\begin{ttdescription} -\item [a] Pour spécifier un autre répertoire pour les fontes générées. -La valeur par défaut utilise l'arborescence \envname{TEXMFVAR}, comme on -l'a dit plus haut. -Si vous voulez que l'arborescence principale soit accessible en lecture -uniquement, cette option permet de choisir une autre localisation -(qui doit bien sûr être accessible en lecture-écriture pour tous) -pour ranger les fontes créées dynamiquement. - -\item [l] Pour créer des liens symboliques pour les binaires, -la documentation \textit{(man pages)} ou les fichiers Info \acro{GNU}. -Par exemple, on peut désirer rendre la documentation de type \textit{man} -accessible depuis \dirname{/usr/local/man} et les fichiers Info -depuis \dirname{/usr/local/info} (il faut alors bien sûr avoir les droits -d'écriture dans les répertoires spécifiés). - -En revanche, il est déconseillé d'utiliser cette option pour les binaires. -Rendre les binaires \TL{} accessibles depuis \dirname{/usr/local/bin} -risque de masquer définitivement, y compris pour \textit{root}, les -binaires \TeX\ fournis en standard sur la plate-forme. -Sous Linux par exemple, \textit{root} doit utiliser par défaut les binaires -\teTeX{} fournis avec la distribution installée (Debian, Mandrake, RedHat, -etc.) et non ceux fournis par \TL. - -\item [d] Pour ne pas installer l'arborescence de la documentation -sur les fontes et les macros. Utile pour économiser de l'espace -disque ou bien si la documentation a été installée auparavant à un -autre emplacement. - -\item [s] Pour ne pas installer l'arborescence des fichiers source. -Ceci peut être utile si cette arborescence est commune à -différentes machines ou architectures, (partage par \acro{NFS} ou -\cmdname{automount} par exemple). - -\end{ttdescription} - -\item[\optname{i} -- Perform Installation.] Installer.\\ -Quand les options de configuration sont satisfaisantes, on peut taper -\Ucom{i} pour lancer effectivement l'installation. - -\end{description} - -Lorsque l'installation est terminée, l'étape suivante consiste à inclure dans -la variable \envname{PATH} des usagers (autres que \textit{root} -cf. ci-dessus) le sous-répertoire de \dirname{TEXDIR/bin} spécifique à -l'architecture de façon que les programmes nouvellement installés puissent -être trouvés. Le tableau~\ref{tab:archlist} (page~\pageref{tab:archlist}) -donne la liste des noms des architectures ; on peut aussi lister le contenu de -\dirname{TEXDIR/bin} pour déterminer le nom du sous-répertoire de -\dirname{TEXDIR/bin} à inclure en tête de \envname{PATH}. - -\label{text:path} -La syntaxe de cette commande et le fichier d'initialisation à utiliser -dépendent du système utilisé. Pour un \textit{shell} Bourne ou -compatible (\cmdname{sh}, \cmdname{bash}, \cmdname{ksh}, etc.), il -faut mettre dans le fichier \filename{$HOME/.profile}% %$ -\footnote{Pour les utilisateurs qui possèdent un fichier - \filename{$HOME/.bash_profile}, c'est dans ce dernier qu'il faut redéfinir - la variable \envname{PATH}, car pour eux, \filename{$HOME/.profile} est - sans effet.} -des futurs utilisateurs de \TL{} : -\begin{alltt} -PATH=/\Ucom{\emph{TEXDIR}}/bin/\Ucom{\emph{archname}}:$PATH; export PATH -\end{alltt} - -\noindent -et pour un \textit{C~shell} (\cmdname{csh}, \cmdname{tcsh}), -mettre dans le fichier \filename{$HOME/.cshrc} : -\begin{alltt} -setenv PATH /\Ucom{\emph{TEXDIR}}/bin/\Ucom{\emph{archname}}:$PATH -\end{alltt} %$ - -Sous \MacOSX{} ceci se peut se faire de la manière suivante, qui évite d'avoir -à ouvrir un éditeur sur un fichier caché : -on redevient utilisateur de base, on se place dans son répertoire personnel, -en tapant dans le Terminal -\begin{alltt} -> \Ucom{exit ; cd} -\end{alltt} -On vérifie quel est le \textit{shell} utilisé en tapant -\begin{alltt} -> \Ucom{echo $SHELL} -\end{alltt} %$ -Si la réponse est \filename{bash} (ou \filename{sh}) le fichier à modifier est -\file{.profile}, si c'est \filename{tcsh} (ou \filename{csh}) -le fichier à modifier est \file{.cshrc}.\\ -Cas de \filename{bash} : on tape dans le terminal\footnotemark{} -\addtocounter{footnote}{-1} -\begin{alltt} -> \Ucom{touch .profile} -> \Ucom{echo "export PATH=/usr/local/texlive/2007/bin/powerpc-darwin:$PATH" >> .profile} -> \Ucom{source .profile} -\end{alltt} %$ -Cas de \filename{tcsh} : on tape dans le terminal% -\footnote{Cet exemple suppose qu'on a fait l'installation dans -\dirname{/usr/local/texlive/2007} et que processeur est un Motorola, sinon il -faut adapter \envname{PATH} en conséquence (changer \dirname{powerpc-darwin} -en \dirname{i386-darwin} pour les Mac à base de processeur Intel).} -\begin{alltt} -> \Ucom{touch .cshrc} -> \Ucom{echo "setenv PATH /usr/local/texlive/2007/bin/powerpc-darwin:$PATH" >> .cshrc} -> \Ucom{source .cshrc} -\end{alltt} %$ -La mise à jour de la variable \envname{PATH} est terminée. - -\medskip -Voici un court exemple qui sélectionne une installation complète avec -les binaires du système actuel seulement (on accepte tous les choix par -défaut). Les \acro{RETURN} sont omis ici. - -% Respecter les espaces pour aligner les # !!! -\begin{alltt} -> \Ucom{sh install-tl.sh} -\Ucom{i} # lancer l'installation -# Redevenir utilisateur de base (non root) -> \Ucom{exit ; cd} -# Nouveau PATH (sous Linux, SHELL=bash, compte avec fichier \file{.bash_profile}) : -> \Ucom{echo "export PATH=/usr/local/texlive/2007/bin/i386-linux:$PATH" >> .bash_profile} -> \Ucom{source .bash_profile} # faire prendre en compte le nouveau PATH -\end{alltt} %$ - -Si votre système Unix connaît la commande \cmdname{manpath} (essayez en tapant -\code{man manpath} dans un terminal), vous pourrez accéder à la documentation -de \TL{} grâce à la commande \cmdname{man} en ajoutant la ligne suivante -(en adaptant les chemins éventuellement) dans -le fichier \filename{/etc/manpath.config} (ceci nécessite les droits de -\textit{root}) : -\begin{alltt} -MANPATH_MAP /usr/local/texlive/2007/bin/i386-linux /usr/local/texlive/2007/texmf/doc/man -\end{alltt} - - -\textruntexconfig - -\medskip %J.A. - -\textifindoubt - - -\subsubsection{Installation non interactive } -\label{sec:noninteractive-install} - -Lorsqu'on doit dupliquer la même installation sur plusieurs machines, il -peut être fastidieux de devoir répondre à chaque fois à la même liste de -questions. Une installation personnalisée automatique est possible. - -Exemple : pour réaliser une installation standard de \TL{} sous -\dirname{/opt/texlive} plutôt que sous \dirname{/usr/local/texlive}, -il suffit d'exécuter les trois commandes suivantes : -\begin{alltt} -> \Ucom{TEXLIVE_INSTALL_PREFIX=/opt/texlive} -> \Ucom{export TEXLIVE_INSTALL_PREFIX} -> \Ucom{echo i | sh install-tl.sh} -\end{alltt} - -L'argument \og\texttt{i}\fg{} passé au script d'installation sert à lancer -l'installation (en mode interactif, on taperait \texttt{i} au clavier). - -Cinq variables d'environnement permettent de choisir où aura lieu -l'installation : -\begin{ttdescription} -\item [TEXLIVE\_INSTALL\_PREFIX] - remplace \dirname{/usr/local/texlive}. -\item [TEXLIVE\_INSTALL\_TEXDIR] - remplace \dirname{/usr/local/texlive/2007}. -\item [TEXLIVE\_INSTALL\_TEXMFLOCAL] - remplace \dirname{/usr/local/texlive/texmf-local}. -\item [TEXLIVE\_INSTALL\_TEXMFSYSVAR] - remplace \dirname{/usr/local/texlive/2007/texmf-var}. -\item [TEXLIVE\_INSTALL\_TEXMFHOME] - remplace \dirname{$HOME/texmf}. %$ -\end{ttdescription} - -\enlargethispage*{\baselineskip} -Pour réaliser une installation personnalisée, il est facile d'écrire un petit -script qui passe les arguments adéquats à la commande \cmdname{install-tl.sh} ; -par exemple pour une installation selon le schéma Gutenberg, avec comme langues -supplémentaires l'espagnol et l'anglais britannique, à placer sous -\dirname{/opt/texlive}, on pourrait lancer (sous root, en supposant que -le SHELL est \cmdname{sh} ou \cmdname{bash} le script suivant : -\begin{verbatim} -TEXLIVE_INSTALL_PREFIX=/opt/texlive -export TEXLIVE_INSTALL_PREFIX -sh install-tl.sh <<EOI -s -e -l -A -D -r -i -EOI -\end{verbatim} -les lettres figurant entre \verb+<<EOI+ et \verb+EOI+ étant exactement -celles entrées (dans le même ordre) lors d'une installation interactive. - -Une autre solution (meilleure ?) consisterait à utiliser un fichier -\filename{configure} à la mode \acro{GNU}\dots{} Les volontaires -pour travailler dans cette direction sont les bienvenus ! - -% -\subsection{Ajouter des composants à une installation} - -On peut ajouter des composants individuels ou des collections de la -distribution actuelle à une distribution autre que \TL{} ou -à une installation plus ancienne de \TL{}. Ceci peut se faire soit à partir -du \DVDlive{} soit à partir du \CDinst{}. - -%\startinst -Pour démarrer, il faut d'abord \og monter \fg{} le médium avec les -extensions Rock Ridge. -La commande exacte varie d'un système à l'autre ; la commande suivante -fonctionne sous Linux, mais les noms du périphérique (ici -\filename{/dev/cdrom}) et du point de montage (ici \dirname{/mnt/cdrom}) -peuvent changer. -\\ N.B. Tous nos exemples utilisent \texttt{>} pour les lignes de -commandes \textit{(shell prompt)} ; les commandes de l'utilisateur sont -\underline{soulignées}. -\begin{alltt} -> \Ucom{mount -t iso9660 /dev/cdrom /mnt/cdrom} -\end{alltt} - -\noindent Se placer au point de montage du lecteur : -\begin{alltt} -> \Ucom{cd /mnt/cdrom} -\end{alltt} - -Lancer le script \filename{install-pkg.sh} (et non -\filename{install-tl.sh} qui n'est destiné qu'à l'installation complète) : - -\begin{alltt} -> \Ucom{sh install-pkg.sh \var{options}} -\end{alltt} - -Le premier jeu d'options permet de choisir ce qui sera installé : - -\begin{ttdescription} -\item [-{}-package=\var{pkgname}] Le composant individuel à installer. - -\item [-{}-collection=\var{colname}] La collection individuelle à installer. - -\item [-{}-nodoc] Ne pas installer les fichiers de documentation pour -cette opération. - -\item [-{}-nosrc] Ne pas installer les fichiers source pour cette opération. - -\item [-{}-cddir=\var{dir}] Répertoire source d'où on lit ; -par défaut le répertoire courant. Si on a suivi les instructions ci-dessus, -il n'a pas besoin d'être modifié. - -\item [-{}-listdir=\var{dir}] -Ce qu'on appelle \og répertoire des listes\fg{} dans \var{cddir} -d'où on lira l'information sur le composant. -Si on a suivi les instructions ci-dessus, il n'y a pas besoin de le modifier. - -\end{ttdescription} - -La suite des opérations est contrôlée par les options décrites ci-dessous. -Si aucune n'est spécifiée, par défaut on installe les fichiers spécifiés. -L'arborescence principale de destination est -le répertoire père du répertoire \dirname{bin} affiché par la commande -\cmdname{which tex}. -On peut la modifier en changeant les variables d'environnement -\envname{TEXMFMAIN} ou \envname{TEXMF}. - -\begin{ttdescription} - -\item [-{}-listonly] Liste les fichiers à installer mais n'installe - rien du tout ! - -\item [-{}-archive=\var{tarfile}] Au lieu d'installer les fichiers - dans le système \TeX{}, crée une archive \cmdname{tar}. - -\end{ttdescription} - -Options additionnelles : - -\begin{ttdescription} - -\item [-{}-config] Après l'installation, exécuter \code{texconfig init}. - -\item [-{}-nohash] Après installation, ne pas lancer \cmdname{mktexlsr} -pour reconstruire la base de données des noms de fichiers. -\item [-{}-verbose] Donner plus d'informations durant l'exécution des scripts. -\end{ttdescription} - -Voici quelques exemples d'utilisation : - -\begin{enumerate} - -\item Voir les fichiers du composant \pkgname{fancyhdr} sans l'installer : - -\begin{alltt} -\ifSingleColumn> \Ucom{sh install-pkg.sh --package=fancyhdr --listonly} -\else> \Ucom{sh install-pkg.sh --package=fancyhdr \bs} -> \Ucom{--listonly} -\fi{} -texmf-dist/doc/latex/fancyhdr/README -texmf-dist/doc/latex/fancyhdr/fancyhdr.pdf -... -\end{alltt} - -\item Installer le composant \LaTeX{} \pkgname{natbib}: -\begin{alltt} -> \Ucom{sh install-pkg.sh --package=natbib} -\end{alltt} - -\item Installer le composant - \LaTeX{} \pkgname{alg} sans les sources ni la documentation : - -\begin{alltt} -\ifSingleColumn> \Ucom{sh install-pkg.sh --package=alg --nosrc --nodoc} -\else> \Ucom{sh install-pkg.sh -{}-package=alg \bs} -> \Ucom{-{}-nosrc -{}-nodoc} -\fi\end{alltt} - -\item Installer tous les composants dans la collection de macros - additionnelles de plain \TeX\ : -\begin{alltt} -> \Ucom{sh install-pkg.sh --collection=tex-plainextra} -\end{alltt} - -\item -Faire une archive \cmdname{tar} dans \path{/tmp} contenant tous les -composants -de \pkgname{pstricks} : -\begin{alltt} -\ifSingleColumn> \Ucom{sh install-pkg.sh --package=pstricks --archive=/tmp/pstricks.tar} -\else -> \Ucom{sh install-pkg.sh -{}-package=pstricks \bs} -> \Ucom{-{}-archive=/tmp/pstricks.tar} -\fi\end{alltt} - -\end{enumerate} - -\textifindoubt - -% -\section{À faire après l'installation} -\label{sec:postinstall} - -Une fois l'installation terminée il faut, quel que soit le système, -configurer le système pour certains besoins locaux et -faire des tests de base. - -Cette phase de post-installation comprend éventuellement la prise en compte de -composants, fontes ou de programmes qui n'étaient pas inclus dans \TL{}. -L'idée de base est de faire les ajouts dans l'arborescence -\envname{TEXMFLOCAL} (si vous avez installé depuis le disque) -ou dans \envname{TEXMFSYSVAR} (si vous exécutez depuis le disque) ; -voir \og répertoires d'installation\fg{} en page~\pageref{text:instdir}. - -Bien sûr, les détails varient d'un cas à l'autre et nous n'essayerons -donc pas de les traiter ici. Voici quelques pointeurs à consulter : -\begin{itemize} -\item -\url{http://www.tex.ac.uk/cgi-bin/texfaq2html?label=instpackages} -\item -\url{http://www.ctan.org/installationadvice} -\item -\url{http://www.ctan.org/tex-archive/info/beginlatex/html/chapter5.html#pkginst} -\item -\url{http://www.ctan.org/tex-archive/info/Type1fonts} sur l'installation -de fontes. -\end{itemize} - -\subsection{Le programme \protect\cmdname{texconfig}} -\label{sec:texconfig} - -Vous pouvez utiliser le programme \cmdname{texconfig} n'importe quand après -votre installation pour reconfigurer votre système -de façon à satisfaire les besoins locaux. -Il peut être nécessaire de l'exécuter au moins une fois juste après -l'installation si les valeurs par défaut de certains paramètres ne vous -conviennent pas. -Ce programme est installé avec les autres sous le répertoire propre à -votre architecture \texttt{TEXDIR/bin/\var{archname}}, si vous n'avez pas -modifié le \envname{PATH} de \textit{root}, il faudra le lancer -(sous \textit{root}) avec son chemin complet. - -Si on le lance sans arguments, il entre en mode plein-écran et on peut -alors voir et modifier interactivement les paramètres. - -On peut aussi le lancer avec diverses options. Voici les plus courantes -(la distribution \TL{} est configurée pour utiliser du papier~A4 par défaut) : - -\begin{ttdescription} - -\item [texconfig paper letter] -Mettre la taille par défaut du papier à \textit{letter} pour les pilotes -\cmdname{pdftex}, \cmdname{dvips}, \cmdname{dvipdfm}, \cmdname{xdvi}, etc. - -\item [texconfig rehash] Mettre à jour toutes les bases de données des -fichiers du système \TeX{} (à faire après tout ajout ou suppression de -fichier). - -\item [texconfig faq] Afficher la \acro{FAQ} sur \teTeX{}. -(voir aussi la \acro{FAQ} principale de \TeX{} dans -\OnCD{texmf-doc/doc/english/FAQ-en} sur le \DVDlive{}). - -\item [texconfig help] Obtenir de l'aide sur la commande \cmdname{texconfig}. - -\end{ttdescription} - -Bien sûr, \cmdname{texconfig} ne permet de changer que certaines des -nombreuses options et paramètres de configuration d'un système \TeX{}. -Le fichier principal de configuration pour les programmes de la base -\Webc{} s'appelle \filename{texmf.cnf}. ; on peut trouver son emplacement -en exécutant \samp{kpsewhich texmf.cnf}. Ce fichier contient de nombreux -commentaires expliquant les options par défaut et la signification des -paramètres, sa lecture est recommandée. - -Depuis 2005, la commande \cmdname{texconfig} \emph{ne modifie plus les -fichiers de configuration de la machine}, mais ceux de l'utilisateur qui la -lance ; ces fichiers sont dans le répertoire \dirname{$HOME/.texlive2007} %$ -de l'utilisateur. - -De même, les commandes \cmdname{updmap} et \cmdname{fmtutil} -opèrent maintenant au niveau de l'utilisateur dans le répertoire -\dirname{$HOME/.texlive2007} %$ - -\textbf{Important : machines multi-utilisateurs}. Les administrateurs -installant \TL{} sur une machine multi-utilisateurs devront dorénavant -utiliser les commandes \cmdname{texconfig-sys}, \cmdname{updmap-sys} et -\cmdname{fmtutil-sys} pour respectivement modifier la configuration, mettre à -jour les fichiers \file{.map} et créer les formats \emph{au niveau de la - machine}. Noter qu'aucun format n'est créé à l'installation, ils sont -fabriqués à la demande ; depuis cette année, le format créé par un utilisateur -l'est uniquement pour lui (il est mis dans \dirname{$HOME/.texlive2007}). %$ -Afin d'éviter la multiplication de fichiers de formats, il y a donc lieu créer -au moins les formats les plus utilisés au niveau du système à la fin de -l'installation par la commande \cmdname{fmtutil-sys}. Le plus simple est de -les créer tous (c.-à-d. ceux qui figurent dans le fichier fmtutil.conf) par -\begin{alltt} -> \Ucom{fmtutil-sys --all} -\end{alltt} -De plus, ceux qui ont des fichiers de configuration spécifiques -\filename{fmtutil.cnf} ou \filename{updmap.cfg} devront les placer -dans l'arborescence pointée par la nouvelle variable -\envname{TEXMFSYSCONFIG}, -faute de quoi ces fichiers ne seront pas trouvés par les scripts -\cmdname{fmtutil-sys} et \cmdname{updmap-sys}. -Si les fichiers \filename{fmtutil.cnf} et \filename{updmap.cfg} propres à la -machine sont, par exemple, dans \envname{\$TEXMFLOCAL}, -rien n'empêche de définir \envname{TEXMFSYSCONFIG} comme -\envname{\$TEXMFLOCAL}, -mais il faut le faire explicitement dans le fichier \filename{texmf.cnf}. - -Rappelons que la commande \cmdname{texconfig conf} retourne les valeurs des -variables \envname{TEXMFSYSCONFIG}, \envname{TEXMFLOCAL}, etc., et que -l'utilisation des différentes arborescences texmf a été décrite à la -section~\ref{sec:texmftrees} \p.\pageref{sec:texmftrees}. - - -\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 \textit{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.141592 (Web2C 7.5.5) -kpathsea version 3.5.5 -... -\end{alltt} - -Si on récupère un \textit{command not found} au lieu d'informations -comme le numéro de version et le copyright, il est fort probable que -vous n'avez pas le bon répertoire \dirname{bin} dans votre -\envname{PATH}. -Voir les informations sur l'environnement page~\pageref{text:path}. - -\item Traiter un fichier \LaTeX{} simple : - -\begin{alltt} -> \Ucom{latex sample2e.tex} -This is pdfeTeXk, Version 3.141592... -... -Output written on sample2e.dvi (3 pages, 7496 bytes). -Transcript written on sample2e.log. -\end{alltt} -Si ça échoue en cherchant \filename{sample2e.tex} ou d'autres fichiers, -il y a peut-être des interférences entre 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 \og Actions de débogage \fg{} -page~\pageref{Debugging}. - -\item Prévisualiser les résultats en ligne : -\begin{alltt} -> \Ucom{xdvi sample2e.dvi} -\end{alltt} -Sous Windows, la commande équivalente est \cmdname{dviout}. -Une nouvelle fenêtre doit s'ouvrir et montrer un document expliquant les -bases de \LaTeX{} (document à lire d'ailleurs si vous êtes débutant !). -Vous devez tourner sous X pour que \cmdname{xdvi} fonctionne. Sinon, votre -variable d'environnement \envname{DISPLAY} n'est pas correcte et vous -aurez une 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 -du \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} - -Hélas, ni \cmdname{gv} ni \cmdname{xpdf} ne sont actuellement 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}. - -\item Autres fichiers de tests utiles : - -\begin{ttdescription} - -\item [small2e.tex] Un document plus simple à compiler que -\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 de 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} à la commande \code{*} après -\samp{tex story.tex}. - -\end{ttdescription} -Pour exécuter ces tests procéder comme on l'a fait pour -\filename{sample2e.tex}. - -\end{enumerate} - -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}. -On vous recommande également l'introduction à \LaTeX{} de Tobias Oetiker -dans sa version anglaise (la version française n'est plus à jour) -disponible après installation sous -\url{texmf-doc/doc/english/lshort-english/lshort.pdf}. - - -\section{Installation pour \MacOSX} -\label{sec:mac-install} - -\TL{} traite \MacOSX, mais pas les versions antérieures des Macintosh. - -On peut installer \TeX{} sous \MacOSX{} de deux façons : - -\begin{enumerate} - -\item Utiliser la nouvelle distribution, appellée Mac\TeX{}, disponible - depuis l'édition 2005 sur le \DVDlive ; elle se trouve dans le répertoire - \dirname{mactex/}, voir section~\ref{sec:mactex}. C'est la méthode - \emph{vivement recommandée}, car l'installation est très simple. - -\item Utiliser les commandes \filename{install*} comme pour Unix (lire d'abord - la section~\ref{sec:osx-unix-inst} ci-dessous pour les spécificités \MacOSX{} -puis la section~\ref{sec:unix-install}). Cette méthode offre plus de choix -quant à ce qui sera installé mais déroute bien des utilisateurs de Macintosh -(ceux qui répugnent à taper des commandes dans un Terminal). - -\end{enumerate} - -\noindent Par ailleurs, l'utilisation de \TeX{} sous \MacOSX{} se fait -normalement par le biais d'une interface graphique (\emph{frontend}), -comme expliqué ci-dessous à la section~\ref{sec:interf-graph-macosx}. - -\subsection{Installation de Mac\TeX} -\label{sec:mactex} - -La distribution Mac\TeX{} est une variante de \TL{} complétée par de -nombreuses applications et de la documentation spécifique. -Elle dispose de son propre installeur intégré. - -Le site de référence pour Mac\TeX{} est \url{http://tug.org/mactex}. - -\subsection{\protect\cmdname{install*.sh} : installation depuis \TL{}} -\label{sec:osx-unix-inst} - -Le système \MacOSX{} est un Unix (presque) comme les autres, mais Apple -cache soigneusement ce fait, ce qui ne facilite pas l'installation de -logiciels comme \TL{}. - -Nous allons essayer de décrire en détail la procédure d'installation. -La première chose à faire est d'ouvrir une fenêtre \og Terminal \fg{}. -L'application \og Terminal\fg{} se trouve dans le répertoire -/Applications/Utilitaires, elle est accessible à partir du menu -principal en haut de l'écran. - -Ensuite, nous allons vérifier si l'interpréteur de commandes -(ou \textit{shell} en anglais) \cmdname{bash} est présent ou non. -Pour cela, taper dans la fenêtre \og Terminal \fg{} la commande suivante : -\begin{alltt} -> \Ucom{which bash} -\end{alltt} -Si le \textit{shell} \cmdname{bash} est présent (cas des versions -de 10.2 et suivantes de \MacOSX) la réponse sera un chemin, par exemple -\filename{/bin/bash}. -Si la réponse est \texttt{command not found}, vous avez une version -antérieure à 10.2, sur laquelle \cmdname{bash} n'est pas installé par défaut. -Vous devrez alors récupérer le \textit{shell} \cmdname{bash} sur internet -(par exemple ici : \url{http://tug.org/texlive/bash.dmg}) -et l'installer\dots{} ou mieux, mettre à jour votre version de \MacOSX. - -Supposons désormais le \textit{shell} \cmdname{bash} présent. -Il faut maintenant \og passer \textit{root} \fg{}, c'est-à-dire -se donner le pouvoir d'effectuer des opérations normalement interdites -aux utilisateurs de base. Ceci se fait en tapant dans le \og Terminal\fg{} -la commande : -\begin{alltt} -> \Ucom{sudo su -} -\end{alltt} - -Mettre le \CDinst{} ou le \DVDlive{} dans le lecteur, son contenu -devient automatiquement accessible sous le répertoire \dirname{/Volumes}. -On tape ensuite dans le \og Terminal\fg{} les commandes : -\begin{alltt} -> \Ucom{cd /Volumes/texlive2007} -> \Ucom{sh install-tl.sh} -\end{alltt} -pour se placer à la racine de l'image disque montée et y lancer le script -d'installation. Il suffit ensuite de suivre la documentation -d'installation de la section~\ref{sec:unix-install-disk} -\p.\pageref{sec:unix-install-disk} où des notes spécifiques pour \MacOSX{} -ont été incluses si nécessaire. - -\subsection{Interfaces graphiques pour \MacOSX{}} -\label{sec:interf-graph-macosx} - -Normalement, l'utilisation de \TeX{} sur un Macintosh se fait à travers -une interface graphique, comprenant un \textit{shell} d'exécution, un -éditeur, un prévisualiseur et d'autres outils (on échappe toutefois -difficilement à l'utilisation de \og Terminal \fg{} dès que l'on veut -réaliser des tâches un tant soit peu évoluées\ldots). - -Voici les principales interfaces disponibles : - -\begin{cmddescription} -\item [TeXShop] Inclus dans \TL{} sous -\filename{./MacOSX/texshop.dmg}.\\ -Voir \url{http://www.uoregon.edu/~koch/texshop/texshop.html}. - -\item [ITeXMac] Inclus dans \TL{} sous \filename{./MacOSX/iTM-*.dmg}.\\ -Voir \url{http://itexmac.sourceforge.net}. - -\item [Mac-emacs] Une adaptation d'Emacs à \MacOSX{}, avec -\pkgname{AucTeX} inclus.\\ -Voir \url{http://www.cs.man.ac.uk/~franconi/mac-emacs}. - -\end{cmddescription} - -Si vous choisissez d'utiliser \cmdname{TeXShop} ou \cmdname{ITeXMac}, -il sera nécessaire de donner à ces logiciels les informations concernant -le PATH : - -\begin{cmddescription} - -\item [TeXshop] Lancer l'application et ouvrir le panneau préférences (menu - TeXShop). Sélectionner l'onglet \og Moteur\fg{} et modifier la première - ligne en saisissant votre PATH, par exemple : - \dirname{/usr/local/texlive/2007/bin/powerpc-darwin}. - -\item [ITeXMac] Lancer l'application et ouvrir le panneau préférences (menu - ITeXMac). Sélectionner le bouton \og Assistant teTeX\fg{}, puis l'onglet - \og TeX\fg{} et cliquer sur le bouton radio \og{} Autre\fg{}. Saisir alors - votre PATH, par exemple : - \dirname{/usr/local/texlive/2007/bin/powerpc-darwin}. - -\end{cmddescription} - - -\section{Installation sous Windows} -\label{sec:win-install} - -La distribution \TL{} inclut un -installeur pour Windows qui s'appelle \cmdname{tlpmgui}. - -%%%%%%%%%%%%%%%%%%%% Ajout (df) %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% -\begin{quote} -\textbf{Note du traducteur :} à titre personnel, je ne recommande pas -l'installation sous Windows à partir de \cmdname{tlpmgui}, sauf aux -utilisateurs qui connaissent bien \TL{} sous Unix et veulent avoir sous -Windows une distribution aussi proche que possible de celle-ci. - -Une autre piste, non basée sur la distribution \TL{}, me semble nettement plus -adaptée : il s'agit installer la distribution \ProTeXt{} à partir du -\DVDlive{} ou du \CD{} spécifique, elle est basée sur \MIKTEX{} distribution -très appréciée sous Windows ; - -Si vous décidez d'opter pour \ProTeXt{} la suite de toute cette -section ainsi que la suivante (Maintenance sous Windows) ne vous -concernent pas. -\end{quote} -%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% - -\cmdname{tlpmgui} propose essentiellement les mêmes options que le script -\cmdname{install-tl.sh} sous Unix mais dans une interface graphique : - sélection des schémas, choix des collections, etc., se reporter -à la section~\ref{sec:unix-install-disk} \p.\pageref{sec:unix-install-disk}. -Certaines manipulations telles que l'ajout ou la suppression -de composants, la mise à jour des bases de données -et la constructions de formats sont également possibles. -De plus, \cmdname{tlpmgui} offre la possibilité d'utiliser \TL{} depuis -le \DVDlive{} (sans l'installer sur le disque dur). - -Pour les connaisseurs, \cmdname{tlpmgui} repose sur le programme -\cmdname{tlpm} accessible en ligne de commande Windows. - -Les binaires pour Windows sont empruntés à la distribution \acro{W32TEX}, -fournie par Akira Kakuto. -Certains outils de l'ancienne distribution \fpTeX{} de Fabrice Popineau ont -été conservés, le nouveau visualiseur \cmdname{dviout} de Toshio Oshima -a remplacé celui de Fabrice (\cmdname{Windvi}). - -\TL{} peut être installé sur les systèmes Windows~9x, \acro{ME}, -\acro{NT}, \acro{2K} or \acro{XP}. Il ne fonctionne pas avec les versions -plus anciennes Windows (3.1x) et \acro{MS-DOS}. - -\textbf{Attention :} Les utilisateurs de Windows~9x - doit vérifier qu'il disposent d'assez d'espace pour les variables - d'environnement. Le programme \cmdname{tlpmgui.exe} crée un certain - nombre de variables d'environnement, si l'espace manque ajouter - \texttt{SHELL=<path>COMMAND.COM /E:4096 /P} dans le fichier - \filename{config.sys}. - -\subsection{Installation sous Windows depuis le \CDinst} - -Le programme \cmdname{tlpmgui} devrait démarrer automatiquement -dès l'insertion du \CDinst{} dans le lecteur de \acro{CD}. -Si ce n'est pas le cas, cliquer sur \guiseq{Start\arw Run} puis -taper \path{<lecteur cdrom>:\string\setuptl\string\tplmgui.exe} ---- resp. -\path{<lecteur cdrom>:\string\texlive\string\setuptl\string\tplmgui.exe} -si vous installez à partir du \DVDlive{} --- où \path{<lecteur cdrom>} -désigne la lettre correspondant au lecteur de \acro{CD} ; cliquer ensuite -sur OK. - -La fenêtre intitulée \guiseq{TeX Live installation and maintenance utility} -devrait s'ouvrir. Elle propose les options suivantes : -\guiseq{Main customization}, \guiseq{Install}, \guiseq{Select a scheme}, -\guiseq{Select systems}, \guiseq{Directories} et \guiseq{Options}. - -Dans la section \guiseq{Directories}, le nom du lecteur de \acro{CD/DVD} -(par exemple \texttt{F:/}) devrait apparaître à côté du bouton -\acro{CD/DVD}. S'il n'est pas affiché utiliser ce bouton pour -sélectionner le lecteur de \acro{CD/DVD} contenant \TL. - -Il est possible de choisir le répertoire devant contenir la distribution \TL{} -en cliquant sur le bouton \guiseq{TLroot}(la variable \path{TLroot} contiendra -le nom de ce répertoire). -% Le contenu des variables d'environnement -% \path{TEXMFTEMP} et \path{TEXMFCNF} est affiché à côté des boutons -% \guiseq{TEXMFTEMP} et \guiseq{TEXMFCNF}, il sera mis à jour automatiquement -% pendant l'installation (il est possible de le modifier en cas de besoin -% particulier). - -La section \guiseq{Select a scheme} permet, comme sous Unix, de choisir le -schéma de base souhaité pour l'installation (complète, GUTenberg, etc.) : -utiliser le bouton radio pour faire ce choix et le bouton \guiseq{Info} -pour une description du schéma sélectionné. - -Il est possible de personnaliser le schéma choisi en lui ajoutant ou en -supprimant certaines de ses composantes (appelées \guiseq{collections}). -Ceci se fait en utilisant les boutons \guiseq{Standard collections} -et \guiseq{Language collections} (choix des langues utilisables) -dans \guiseq{Main customization}. - -La collection \guiseq{Wintools} est sélectionnée par défaut car elle contient -beaucoup de petits utilitaires non fournis avec Windows, comme des -convertisseurs tels que \cmdname{sam2p}, \cmdname{jpeg2ps}, \cmdname{tiff2png}, -des prgramme de compression tels que \cmdname{bzip2}, \cmdname{gzip}, -\cmdname{unzip} et \cmdname{wget} qui est requis par le nouvel utilitaire -\cmdname{getnonfreefonts}. - -\textbf{Remarque :} Les collections \guiseq{Ghostscript}, \guiseq{Perl} -sont sélectionnées par défaut. Elles \emph{doivent être -installées}\dots{} sauf si elles l'ont été par ailleurs. -Les variables d'environnement \envname{PERL5LIB} et \verb|GS_LIB| doivent -aussi être initialisées et le chemin complet des binaires \guiseq{Ghostscript} -doit être ajouté à la variable \verb|PATH|. - -Finalement, cliquer sur le bouton \guiseq{Install} dans la section -\guiseq{Install} pour lancer le processus d'installation. - -Laisser le processus se poursuivre jusqu'à l'affichage du message annonçant -que l'installation a réussi (un certain nombre d'étapes sont nécessaires, -comme la création des formats, la mise à jour des bases de données, etc. ce -qui peut prendre un certain temps). - -Un raccourci pour \cmdname{tlpmgui} (et pour \cmdname{dviout} s'il est -installé), sera ajouté dans le menu \guiseq{Start\arw Programs\arw -TeXLive2007}. - -Si nécessaire (Windows~9x/WinME), il vous sera demandé de -redémarrer l'ordinateur. - - -\subsection{Programmes auxiliaires pour Windows} -\label{sec:win-xemtex} - -Pour être complète, une installation \TL{} a besoin de programmes -auxiliaires qu'on ne trouve pas fréquemment sur une machine Windows. -De nombreux scripts sont écrits en Perl. Certains outils importants utilisent -l'interpréteur \PS{} Ghostscript pour afficher ou convertir les fichiers. -Il faut aussi dans certains cas une boîte à outils graphique. -Enfin, un éditeur orienté \TeX{} facilite la saisie de fichiers \TeX{}. - -Tous ces outils sont assez faciles à trouver pour \TeX{}, mais pour essayer -de vous rendre la vie plus facile, nous avons incorporé des outils de ce type -dans \TL{} : -\begin{itemize} -\item GNU \cmdname{GhostScript} 8.54 ; -\item un \cmdname{Perl} 5.8 minimum, suffisant pour exécuter tous les scripts -Perl du \TL{} ; -\item quelques utilitaires comme bzip2, gzip, jpeg2ps et tiff2png. -\end{itemize} - -Perl et Ghostscript sont installés par défaut ; vous pouvez empêcher -leur installation en les déselectionant explicitement lors de -l'installation si vous les avez déjà. - -Si vous préférez ne pas installer les outils inclus dans \TL{}, vous êtes -libre d'installer les outils nécessaires pour compléter votre système \TL{} ; -voici une liste des adresses où les obtenir : -\begin{description} -\item[GhostScript] \url{http://www.cs.wisc.edu/~ghost/} -\item[Perl] \url{http://www.activestate.com/} (mais il vous faudra peut-être - chercher des bibliothèques supplémentaires sur CPAN, - \url{http://www.cpan.org/}) -\item[ImageMagick] \url{http://www.imagemagick.com} -\item[NetPBM] Vous pouvez aussi utiliser NetPBM à la place de ImageMagick - pour traiter ou convertir vos fichiers graphiques. La page d'accueil - de NetPBM est - \url{http://netpbm.sourceforge.net/} -\item[Éditeurs orientés \TeX] Il y a un large choix, et cela dépend des - préférences de l'utilisateur. En voici une sélection : - \begin{itemize} - \item \cmdname{GNU Emacs} avec l'extension AucTeX existe nativement - sous Windows, l'url de référence est - \url{ftp://alpha.gnu.org/gnu/auctex} ; - \item \cmdname{WinShell} se trouve sur \TL{} dans le répertoire - \path{support}, l'url de référence est \url{http://www.winshell.de} ; - \item \cmdname{WinEdt} est un partagiciel disponible à l'adresse - \url{http://www.winedt.com} ; - \item TeXnicCenter est libre et se trouve à l'adresse - \url{http://www.toolscenter.org/products/texniccenter/} et aussi dans - la distribution \ProTeXt{} ; - \item \cmdname{Vim} peut être téléchargé sur le site - \url{http://www.vim.org} ; - \item \cmdname{LEd} se trouve à l'adresse - \url{http://www.ctan.org/support/LEd} ; - \item \cmdname{SciTE} se trouve à l'adresse - \url{http://www.scintilla.org/SciTE.html}. - \end{itemize} -\end{description} - -Il est aussi possible d'installer d'autres outils qui ne sont pas -libres\footnote{Pas libres en fait dans le sens de la liberté de les - modifier et les redistribuer, selon les -\emph{Debian's guidelines}. Cela ne signifie pas qu'on ne peut pas les -acquérir gratuitement.} -comme \cmdname{GSView}, le programme compagnon de \cmdname{GhostScript} -pour afficher plus facilement les fichiers PS/PDF. -\cmdname{GSView} est disponible à l'url -\url{http://www.cs.wisc.edu/~ghost/gsview/} -ou sur tout site \acro{CTAN}. - -\section{Maintenance sous Windows} - -Une fois la distribution \TL{} installée, vous pouvez vous servir du programme -\cmdname{tlpmgui} pour modifier ou compléter votre installation. - -\subsection{Ajouter ou supprimer des composants} - -Le raccourci \cmdname{tlpmgui} du menu -\guiseq{Start\arw Programs\arw TeXLive2007} permet de lancer le programme -et affiche la fenêtre \guiseq{TeX Live installation and maintenance utility}. -Les sections à utiliser sont \guiseq{Add Packages} (ajout de composants), -\guiseq{Remove packages} (suppression de composants), -\guiseq{Manage installation} (maintenace), \guiseq{Remove installation} -(suppression totale de \TL). - -Cliquer sur \guiseq{Add packages} ou \guiseq{Remove packages}, puis - -\begin{itemize} -\item Choisir le lecteur de \acro{CD} (ou le répertoire \texttt{texlive} - du lecteur de \acro{DVD}) grâce au bouton \guiseq{CD/DVD}. - -\item Cliquer sur le bouton \guiseq{Search} dans la section \guiseq{Buttons} -pour afficher la liste de composants à installer ou à supprimer -dans \guiseq{Select packages to\dots}. - -Lors de l'ajout de composants, la liste des composants installés est comparée -à la liste des composants disponibles sur le \acro{CD/DVD}. -Seuls les composants non installés sont affichés, à vous de choisir ceux que -vous souhaitez ajouter. - -Inversement, lors de la suppression de composants, seuls les composants -installés sont affichés. - -Noter que les collections sont en tête de liste. - -\item Sélectionner un composant en cliquant sur son nom dans la liste. -Un clic sur le bouton \guiseq{Info} donne une courte description du contenu. -Il est possible de sélectionner plusieurs composants à la fois à l'aide des -touches \og Ctrl \fg{} et \og Shift \fg{} (majuscules). - -\item Cliquer sur \guiseq{Install} ou \guiseq{Remove} pour terminer -l'opération. -\end{itemize} - -\subsection{Configuration et maintenance} - -La section \guiseq{Manage the installation} permet d'effectuer les opérations -courantes de configuration et de maintenance. - -Voici la liste des actions possibles : -\begin{itemize} - \item mettre à jour la base \filename{ls-R}, - \item créer les formats, - \item modifier le fichier \filename{language.dat}, - \item modifier le fichier \filename{fmtutil.cnf}, - \item modifier le fichier \filename{updmap.cfg}. - \end{itemize} - -Il faut sortir de la fenêtre d'édition en cliquant sur le bouton \guiseq{Done} -pour que les mises à jour des formats, fichiers \file{.map}, base -\filename{ls-R} soient effectuées. - -Les autres possibilités de configuration sont décrites à la -section~\ref{sec:persconf}, \p.\pageref{sec:persconf}. - -\subsection{Désinstallation complète de \TL{}} - -L'option \guiseq{Remove the TeX Live installation} permet de supprimer toute -la distribution \TL{}. - -Attention, ce que vous avez éventuellement installé dans le répertoire -\path{texmf-local} ne sera pas supprimé ; le répertoire \path{setuptl} -contenant \cmdname{tlpmgui} doit être également nettoyé à la main si -nécessaire. - -\subsection{Ajouter des composants à votre système} - -Tout d'abord, quelles que soient les modifications faites, -\emph{n'oubliez pas de reconstruire les fichiers ls-R de bases de - données}, sinon les nouveaux fichiers ne seront jamais retrouvés. -Pour cela, vous pouvez soit utiliser le programme \cmdname{tlpmgui}, option -\guiseq{Manage the installation}, soit lancer manuellement la commande -\file{mktexlsr}. - -Si vous choisissez d'ajouter des fichiers qui ne proviennent pas de la -distribution \TL{} (ou fp\TeX{}), il est fortement -recommandé de les mettre dans le répertoire \path{$TEXMFLOCAL}. %$ -De cette manière, vous serez certain qu'il n'y aura pas de problème -lors d'une mise à jour de \TL. - -L'arborescence pointée par \path{$TEXMFLOCAL} est initialement %$ -vide. Si vous souhaitez y ajouter par exemple les fichiers de style -pour le logiciel de calcul formel Maple, vous devrez mettre ces -fichiers dans le répertoire -\path{C:\string\TeXLive2007\string\texmf-local\string\tex\string\latex\string\maple} -et les fichiers de documentation dans -\path{C:\string\TeXLive2007\string\texmf-local\string\doc\string\latex\string\maple} - - -\subsection{Exécution de \texttt{tlmp.exe} en ligne de commande} - -Le programme \cmdname{tlpm.exe} utilisé par \cmdname{tlpmgui} -possède de nombreuses options utiles dont la liste est donnée par -\begin{verbatim} -tlpm --help -\end{verbatim} - -Consulter le fichier \filename{tlpm.readme} pour plus de renseignements et des -exemples. - -\subsection{Installation en réseau} - -\KPS{} est compatible avec les noms UNC, ceux-ci peuvent donc être utilisés -pour récupérer l'arborescence TEXMF depuis le réseau. Mais -encore mieux, tous les fichiers, y compris ceux de -configuration et excepté les binaires dans \path{bin/win32}, sont -compatibles et partageables avec \teTeX{} ou le \TL{} Unix. Cela -signifie que vous pouvez utiliser Samba, soit pour monter la -distribution Unix sur un client Windows, ou un client Unix -depuis un serveur NT. Plusieurs stratégies sont possibles : -\begin{itemize} - -\item tout mettre sur le serveur. Il faut simplement être certain de mettre dans \path{bin/} les binaires pour tous les couples systèmes d'exploitation / architectures nécessaires. Par exemple, ajouter \path{bin/win32} et - \path{bin/i386-linux}. Ensuite configurer les variables principales ; vous - pouvez utiliser des noms UNC pour pointer sur les répertoires appropriés - sous Win32. - -\item Installer une copie locale pour les binaires et les fichiers de - format. Dans ce cas, assigner \path{$TEXMFMAIN} au répertoire - principal \path{texmf} qui sera pris sur le réseau. Faire pointer - \path{$VARTEXMF} vers un répertoire local qui contiendra les fichiers - de configuration locaux et les fichiers générés au vol. %$ - -\end{itemize} - -\subsection{Différences entre la version Windows et la version - Unix de \TL} - -La version Windows de \Webc{} possède quelques spécificités qui méritent -d'être notées. - -\begin{description} -\item [\cmdname{kpsecheck}] Cette commande fournit des fonctionnalités - qui ne rentraient pas bien dans \cmdname{kpsewhich}. En particulier, - elle permet de lister tous les fichiers qui apparaissent plusieurs - fois à travers les multiples arborescences \path{texmf/}. Ceci à - l'air pratique, sauf qu'en réalité, la sortie est polluée par des - occurrences multiples de fichiers qui ne sont pas utiles à \TeX{} à - proprement parler (commes des dizaines de fichiers - \filename{README})\footnote{Tous ces fichiers - sont susceptibles de produire des collisions lors de l'accès à la - table de hachage ; heureusement \TeX{} ne les utilise pas, ils ne - sont donc pas pris en compte !}. Pour cette raison, vous pouvez combiner - l'option \path{-multiple-occurences} avec deux autres options pour - inclure ou exclure de la recherche tout fichier conforme à un - certain motif (plusieurs motifs d'inclusion ou d'exclusion peuvent - être spécifiés). - - La commande \cmdname{kpsecheck} peut aussi indiquer le statut - d'utilisation de la mémoire partagée : en utilisation ou - non-utilisée. Cette information peut être très utile, car si le - statut rapporté est \og en utilisation\fg{}, cela signifie qu'un - ou plusieurs processus tournent et utilisent le bloc de mémoire - partagée. Dans ce cas, une réinitialisation des tables de hachage - basée sur les fichiers \filename{ls-R}, comme la commande - \cmdname{mktexlsr} l'effectue, sera automatiquement repoussée - jusqu'à ce que tous les processus utilisant la version courante en - mémoire partagée soient terminés. Il est prévu d'enlever cette - limitation dans une version future, mais la version actuelle de - \KPS{} ne permet pas de faire facilement cette réinitialisation. - - Enfin, la même commande \cmdname{kpsecheck} peut indiquer l'endroit - où \KPS{} pense pouvoir trouver la Dll de Ghostscript. En effet, - sous Win32, il est souvent plus simple de travailler directement - avec la Dll de Ghostscript, et de la trouver en utilisant la clé - appropriée dans la base de registre, que d'utiliser \path{gswin32c.exe} et - de modifier le \path{PATH} qui a une longueur limitée. - -\item [\Webc] Les moteurs \TeX{} ont une option supplémentaire - par rapport à la version standard : - \path{-proctimes} affiche des statistiques à propos du - temps d'exécution. Il est à noter que Windows~9x n'étant pas un - système multi-tâche préemptif, il ne possède pas d'horloge - interne suffisamment précise pour mesurer ces temps d'exécution - et donc la valeur affichée n'est qu'une approximation. Sous - NT/2K/XP, le résultat est assez précis et comprend le temps - utilisateur et le temps système alloués à la compilation. Pour - les utilisateurs d'Unix : la commande \path{time} n'existe pas - sous Windows. -\end{description} - -\subsection{Personnalisation de l'installation} -\label{sec:persconf} - -\subsubsection{Dvips} - -Le fichier de configuration de \texttt{dvips} se trouve par défaut en -\path{C:\string\TeXLive2007\string\texmf-var\string\dvips\string\config\string\config.ps}. Il peut être ouvert avec n'importe quel éditeur de texte -% (comme \cmdname{WinShell}) -pour modifier certains paramètres : -\begin{description} -\item[fontes] vous pouvez changer la résolution et le mode de - l'imprimante à laquelle sont destinés vos fichiers dans le cas où - \texttt{dvips} aurait besoin de générer des fontes bitmap. Par défaut, - les fontes Type1 CM interpolées sont utilisées, et donc - \path{mktexpk} ne devrait pas être appelé trop souvent. -\item[imprimante] vous pouvez spécifier où se fera l'impression par - défaut. Si l'option `o' n'est pas suivie d'un nom d'imprimante, un - fichier est créé avec l'extension \file{.ps}. Sinon, vous pouvez - spécifier un nom d'imprimante tel que : -\begin{verbatim} -o lpt1: -% o | lpr -S server -P myprinter -% o \\server\myprinter -\end{verbatim} -\item[papier] vous pouvez changer le format de papier retenu par - défaut (A4), par exemple en format US letter, le premier format - mentionné. Allez vers les lignes débutant par \path{@}. Déplacez les - lignes adéquates, ainsi le fichier commencera par les lignes qui suivent. -\begin{verbatim} -@ letterSize 8.5in 11in - -@ letter 8.5in 11in -@+ %%BeginPaperSize: Letter -@+ letter -@+ %%EndPaperSize -\end{verbatim} -\end{description} - -La distribution \TL{} actuelle intègre un programme \og \cmdname{updmap} \fg{} -facilitant la mise à jour des fichiers \file{psfonts.map} pour Dvips et -\file{pdftex.map} pour PdfTeX. -\cmdname{updmap} est lancé automatiquement durant l'installation. -Si vous ajoutez de nouvelles fontes à la main, -éditez le fichier \verb+updmap.cfg+ dans \path{$TEXMFVAR/web2c}. %$ -et relancez \cmdname{updmap}. - -\subsubsection{PdfTeX} - -Si le programme \cmdname{pdflatex} est utilisé pour écrire directement en -format -\acro{PDF} et qu'on utilise du papier au format \acro{US} letter-size, -éditer le fichier -\path{C:\string\TeXLive2007\string\texmf-var\string\tex\string\generic\string\config\string\pdftexconfig.tex} -et modifier \samp{\bs page\_width} et \samp{\bs page\_height}. -Ces entrées doivent être : -\begin{alltt} -\bs{}pdfpagewidth=8.5 true in -\bs{}pdfpageheight=11 true in -\end{alltt} - -Sauvegarder le fichier et sortir de l'éditeur. - -\subsubsection{Xe\TeX} - -Xe\TeX{} pour Windows est lié statiquement à la bibliothèque fontconfig 2.4.2. -Le fichier de configuration pour les fontes s'appelle \verb+fonts.conf+. -Ce fichier se trouve dans le répertoire indiqué par la commande -\texttt{kpsewhich --var-value=FONTCONFIG\_PATH}. - -\subsubsection{Gsview} - -\cmdname{GSView} est maintenant distribué sous licence Aladdin et n'est donc -plus inclus dans \TL{}. - -Si vous voulez changer le format du papier, ouvrez \cmdname{GSView} à -partir du menu \guiseq{Démarrer} et sélectionnez \guiseq{Media\arw Letter}. -Le sous menu Display Settings vous permet -également d'améliorer la netteté du rendu en positionnant les -deux valeurs \textbf{Text Alpha} et \textbf{Graphics Alpha} à 4 bits. - -Pour ce qui est de l'impression, consulter la -sous-section~\ref{sub:printing}. - -Les fichiers \file{.ps} et \file{.eps} seront automatiquement ouverts -par \cmdname{GSView}. - -\subsection{Tests} - -Pour des procédures génériques de vérification, voir -section~\ref{sec:test-install}, page~\pageref{sec:test-install}. -Cette section décrit les tests spécifiques à Windows. - -Vous pouvez tester l'installation -en ouvrant le fichier -\verb+sample2e.tex+ dans votre éditeur (\cmdname{XEmacs}, -\cmdname{WinShell}) qui se trouve dans -\path{C:\string\TeXLive2007\string\texmf-dist\string\tex\string\latex\string\base}. -Le source \LaTeX{} doit apparaître à l'écran. Compilez-le en cliquant -sur le menu (XEmacs) \guiseq{Command\arw LaTeX} ou sur l'icône \LaTeX{} -(WinShell) dans la barre d'outils, ensuite affichez-le en -cliquant sur le menu (XEmacs) \guiseq{Command\arw View DVI} -ou sur l'icône Preview (dviout). - -La première fois que vous afficherez un document avec \cmdname{dviout}, il va -créer les fichiers de fontes bitmaps qui ne sont pas installées. -Après avoir visualisé quelques fichiers, vous aurez créé la plupart de ces -fichiers et vous ne verrez plus souvent apparaître la fenêtre de création de -fontes. - -En cas de problèmes, reportez-vous à la -sous-section~\ref{sec:troubleshooting}. - -\subsection{Impression} -\label{sub:printing} - -Il est possible d'imprimer depuis \cmdname{dviout}. Dans ce cas, l'impression -utilise le pilote unifié d'impression de Windows, il est donc par -définition compatible avec toutes les imprimantes. Cependant, il y a -un inconvénient : cette impression génère des fichiers (spool) très -importants, quelques versions anciennes de Windows le supportent mal. -L'avantage est que vous pouvez tirer -parti de l'impression d'images BMP ou WMF par exemple. Il faut -également faire bien attention à ce que les paramètres de l'imprimante -soient correctement définis sous peine -d'avoir un effet d'échelle -(imprimer à 600\,dpi sur une imprimante qui fait réellement 300\,dpi -aboutit à n'avoir qu'un seul quart de la page visible). - -L'impression est souvent plus rapide en utilisant \cmdname{dvips}, puis en -imprimant le fichier \file{.ps} depuis \cmdname{GSView}. Pour imprimer -depuis \cmdname{GSView}, sélectionner \textbf{Print\dots{}} dans le menu -\textbf{File}. Une fenêtre de dialogue pour l'impression apparaît. - -Si vous utilisez une imprimante PostScript, \emph{soyez sûr de - sélectionner \textbf{PostScript Printer}} en choisissant cette -option dans \textbf{Print Method} en bas à gauche de la boîte de -dialogue, faute de quoi l'impression échouera. Vous -pouvez ensuite sélectionner une imprimante quelconque parmi celles -installées. - -Si vous utilisez une imprimante qui ne supporte pas PostScript, -sélectionnez \textbf{Ghostscript Device} dans \textbf{Print - Method}. Ensuite cliquez sur le bouton \textbf{djet500} et -sélectionnez votre imprimante. - -\subsection{Trucs et astuces à propos de la plate-forme Win32} - -\subsubsection{Différentes déclinaisons de Win32} - -Ce que recouvre la dénomination Win32 n'est pas un système -d'exploitation. C'est un ensemble de fonctions très -vaste (environ 12000 fonctions dans les fichiers d'en-tête du - SDK Microsoft) que vous pouvez utiliser pour écrire des programmes -pour différentes versions des systèmes d'exploitation de la famille -Windows. - -Windows se décline en plusieurs versions : -\begin{itemize} -\item Win95, Win98 et WinME, qui \emph{ne sont pas de vrais systèmes - d'exploitation multitâches et multithreads}. Ils sont en fait les - dernières incarnations de DOS. On peut s'en apercevoir, car en - lançant le PC, l'interpréteur de commandes \path{command.com} est - chargé et si vous arrêtez le processus à ce moment, vous pouvez - demander la version courante (de DOS) et il vous est répondu quelque - chose du style "MS-DOS 7.0", au moins pour les versions anciennes de - Windows~9x ; -\item Windows \acro{NT} est un système d'exploitation écrit à partir - de zéro, avec un - vrai multitâche préemptif et des fonctionnalités de très haut niveau ; -\item Windows 2000 est écrit sur une base \acro{NT}, il est doté de toutes les - facilités offertes par Win98 ; -\item Windows \acro{XP} existe en versions Personnelle et - Professionnelle. C'est la dernière étape dans la fusion entre les - deux lignes de produits (basée sur Windows~9x et basée sur NT). \acro{XP} est - écrit sur une base NT. -\end{itemize} - -Windows~9x peut faire tourner des programmes 32~bits et des -programmes 16~bits en même temps. Mais le système d'exploitation -lui-même n'est pas entièrement écrit en mode 32~bits et ne fournit pas -une protection mémoire entre les applications : les applications -16~bits peuvent écraser des parties du système d'exploitation en -mémoire ! Des parties du système telles que le \acro{GDI} -(\emph{Graphical Device Interface}) ne se voient allouer que des -ressources de taille très -limitée pour gérer les bitmaps, les pinceaux et les polices, et ces -ressources sont allouées de manière globale pour tous les programmes -qui tournent de manière concurrente. Par exemple, toutes les entêtes de -bitmaps utilisés par tous les programmes qui tournent simultanément ne -doivent pas requérir plus de 64~ko de mémoire. Ceci explique le -comportement du moniteur de performance et le fait que vous pouvez -mettre votre système à genoux en utilisant de manière intensive les -objets graphiques. - -NT, 2K et XP ne souffrent pas de ces limitations, ni d'aucune autre -limitation de Windows~9x. Ce sont de vrais environnements multitâches, avec -une vraie mémoire protégée. Ils répondent de manière plus fluide que -Windows~9x de par leur meilleure gestion de la mémoire, leur système de -gestion de fichiers plus performant, etc. - -\subsubsection{La ligne de commande} - -Vous allez demander : mais pourquoi diable devrais-je me -préoccuper d'une ligne de commande alors que j'ai Windows ? - -Bonne question. Le problème est de nature très générale. Toutes les -opérations ne peuvent pas être accomplies très facilement à l'aide de -la seule interface graphique. La ligne de commande vous donne la -puissance de la programmation -- si vous avez un bon interpréteur de -commandes. - -Mais le problème est plus fondamental : \TeX{} est un outil qui -fonctionne \emph{en batch}, de manière non interactive. \TeX{} a -besoin de calculer la meilleure mise en page pour chaque page, de -résoudre les références croisées, etc. Ceci ne peut être réalisé -que par un traitement global du document. Ce n'est pas encore une tâche -qui peut être réalisée interactivement. - -Ceci implique que vous devriez utiliser \TeX{} depuis la ligne de -commande. En fait la situation n'est pas si catastrophique. Il y a un -avantage à écrire des outils en ligne de commande pour des tâches -complexes : ils sont bien plus fiables, parce qu'ils n'héritent pas de -la complexité inhérente aux interfaces graphiques. -Il est ensuite possible de -concevoir des outils graphiques qui servent d'interface aux outils en -ligne de commande. C'est le cas de \TeX{} : vous interagirez avec lui -la plupart du temps au travers d'un éditeur de textes qui possède une -interface graphique. - -Cependant, il se peut que vous ayez besoin d'utiliser la ligne de -commande dans certaines situations. Par exemple en cas de -problèmes, parce que vous avez besoin de trouver une erreur dans votre -installation -- voir la section~\ref{sec:troubleshooting}. - -\begin{description} -\item[Windows~9x, WinME] Vous ouvrirez une ligne de commande soit en cherchant - l'icône \acro{MS-DOS} dans le menu \og \guiseq{Démarrer\arw Programmes}\fg{}, - soit en choisissant \og \guiseq{Démarrer\arw Exécuter}\fg{}, puis en tapant - \path{command.com} . -\item[NT, 2K, XP] Vous ouvrirez une ligne de commande en cherchant - \og \guiseq{Invite de commandes}\fg{} dans le menu \og \guiseq{Démarrer\arw - Accessoires}\fg{} (ces emplacements peuvent changer d'une version de Windows à - l'autre). Vous pouvez aussi choisir le menu - \og Démarrer -> Exécuter\fg{} et taper \path{cmd.exe}, qui est le nom - du nouvel interpréteur de commandes pour NT. -\end{description} - -\subsubsection{Les séparateurs de chemins} - -L'API Win32 admet les deux caractères \verb+/+ et \verb+\+ comme -séparateurs pour les noms de fichiers. Mais pas les interpréteurs -de commande ! Donc, chaque fois qu'un nom de fichier est utilisé par -un programme, vous pouvez utiliser l'un ou l'autre séparateur, mais -sur la ligne de commande, vous devez utiliser \verb+\+ comme unique -séparateur. Ce qui explique que vous pouvez taper : -\begin{verbatim} - C:\>set TEXMFCNF=C:/Program Files/TeXLive/texmf-var/web2c -\end{verbatim} -mais pas : -\begin{verbatim} -C:\>dir "C:/Program Files/TeXLive" -\end{verbatim} -Dans le premier cas, seuls des programmes utiliseront le chemin que -vous avez fourni, dans le deuxième cas, c'est l'interpréteur de commandes -qui va vouloir s'en servir directement. - -Tout ceci pour dire, ne soyez pas surpris de voir des noms de -fichiers écrits avec des \path{/} en guise de séparateurs, à la mode Unix ; -Windows-\TL{} est un portage de \Webc, dont l'objectif est d'être -compatible avec toutes les plates-formes. Pour cette raison, les -fichiers de configuration utilisent la convention Unix des séparateurs -dans les noms de fichiers. - -\subsubsection{Les systèmes de gestion de fichiers} - -Une des plus mauvaises caractéristiques de Windows~9x vis-à-vis de \TeX{} -est probablement ce qu'on appelle le système de fichiers FAT. -\TeX{} utilise une myriade de petits fichiers dont la taille varie -entre 1~ko et 5~ko. Le système FAT est ancien et date d'une époque bien -antérieure à l'apparition des disques de plusieurs Go qui sont monnaie -courante aujourd'hui. Tout ceci pour dire qu'il n'est pas possible de -gérer efficacement les dizaines de fichiers de \TL{} sur un disque dur -formaté en FAT. Les fichiers se voient allouer chacun 32~ko au -minimum, donc l'installation de \TL{} utilise beaucoup plus de -place que nécessaire. - -Le seul moyen d'éviter ce problème consiste à -passer en FAT32 ou NTFS. Ces systèmes sont plus récents et n'ont pas -l'inconvénient de FAT. La taille des clusters par défaut y est de 4~ko, -leur accès est plus performant. NTFS est protégé, redondant et on peut -même ajuster la taille des clusters jusqu'à un minimum de 512 octets -à la création. - -\subsubsection{Comment ajouter un répertoire à votre PATH} - -Il existe dans votre système des variables qui -agissent un peu comme des variables globales à tous vos programmes. On -appelle cet ensemble de variables \emph{l'environnement}. Chaque -programme hérite à son démarrage d'une copie de l'environnement. Il peut -modifier les valeurs des variables, ajouter ou enlever des variables, -mais les modifications ne sont effectives que pour sa propre copie et -ne sont pas propagées aux autres programmes, sauf à ceux qu'il lance -lui-même. - -Votre variable PATH est une variable spéciale de l'environnement -utilisée pour chercher les programmes lorsque vous en demandez -l'exécution. Il y a une procédure différente pour modifier cette -variable selon que vous êtes sous Windows~9x, \acro{ME} ou -\acro{NT}/\acro{2K}/\acro{XP}. - -\begin{description} -\item[Windows 95/98] -Éditez votre fichier \path{autoexec.bat}. Dans ce fichier, vous -trouverez une ligne commençant par \path{PATH=} et suivie par une -liste de répertoires séparés par des points-virgules. Ajoutez le répertoire -contenant les programmes exécutables au bout de cette ligne. Cette -ligne ressemble alors à la suivante : -\begin{verbatim} -PATH=C:\windows;C:\windows\system;C:\TeXLive2007\bin\win32 -\end{verbatim} -Les modifications ne prendront effet qu'après redémarrage de la machine. -\item[Windows ME] - Vous devez utiliser le programme - \path{C:\string\windows\string\system\string\msconfig.exe} pour pouvoir - modifier une des - variables d'environnement. Dans ce programme, choisissez l'onglet - Environnement, ensuite ajoutez ou modifiez la variable de votre - choix. Il faut alors redémarrer la machine pour que les modifications - prennent effet. -\item[Windows NT/2K/XP] - Ouvrez le \guiseq{Panneau~de~Contrôle}, accessible depuis le menu - \guiseq{Démarrer\arw} \guiseq{Paramètres\arw Panneau~de~Contrôle}. - Ouvrez l'icône Système, la fenêtre des \guiseq{Propriétés système} - s'ouvre. Choisissez l'onglet \textsf{Environnement} ou cherchez un - bouton \guiseq{Variables d'environnement} -parmi les différentes boîtes de dialogue offertes. -Vous pouvez maintenant modifier vos propres variables d'environnement. -Il est à noter que les variables d'environnement système communes à -tous les utilisateurs sont également affichées. Vous ne pouvez les -modifier que si vous avez les droits d'administrateur. Si c'est le -cas, vous pouvez modifier la variable \path{PATH} pour tous les -utilisateurs du système -- mais vous devez savoir précisément ce que -vous faites. - -S'il y a déjà un \path{PATH} défini pour votre compte utilisateur, cliquez -dessus. Dans le champ \textsf{Variable} apparaît \path{PATH} et dans le champ -\textsf{Valeur}, la liste courante de répertoires séparés par des -points-virgules. Ajoutez les répertoires où se trouvent vos exécutables (i.e. -\path{C:\string\TeXLive2007\string\bin\string\win32}). Si la variable -\path{PATH} n'est pas encore définie, il suffit de taper son nom dans le champ -\textsf{Variable} et la valeur initiale que vous souhaitez lui donner dans le -champ \textsf{Valeur}. Important : cliquez sur le bouton \textsf{Appliquer} -avant de cliquer sur \textsf{Ok}, de cette façon, les modifications seront -propagées immédiatement à la session courante. Soyez prudent quand vous -modifiez les variables d'environnement. -\end{description} - -Le meilleur moyen de savoir si une variable a été correctement définie -consiste à ouvrir une console et à taper -\begin{verbatim} -set VARIABLE -\end{verbatim} -la valeur correspondante doit alors être affichée.. - -\subsubsection{Les moteurs \TeX{}} - -En lisant la documentation de \Webc{}, on voit -que les différents programmes dérivés de \TeX{} -utilisent le même moteur de base. Par exemple, \path{tex.exe} et -\path{latex.exe} sont des copies exactes du même programme, mais -chacun utilise un fichier de format différent, en se basant sur le nom -par lequel il a été invoqué. - -Sous Unix, ce mode de fonctionnement est réalisé en faisant appel aux -\emph{liens symboliques}. On peut ainsi économiser un peu d'espace disque, -car plusieurs moteurs de base sont utilisés avec différents fichiers -de format. - -L'API Win32 ne connaît pas les liens symboliques. Dans le but -d'économiser presqu'autant d'espace disque, tous les moteurs -\TeX{} de base ont été mis dans des DLL (\emph{Dynamic Linked - Library}). Ceci se traduit par l'aspect suivant pour les fichiers : -\begin{alltt} - 2006-11-23 07:06 2 560 latex.exe - 2007-01-06 23:54 1 073 664 pdftex.dll - 2006-01-28 08:05 2 560 pdftex.exe -\end{alltt} -\noindent et le fichier \path{latex.exe} n'est ni plus ni moins qu'une copie -presqu'identique du fichier \path{pdfetex.exe}, utilisant le même moteur -\path{pdftex.dll}. La même astuce a été utilisée pour la famille de -programmes \path{mktex*.exe} qui utilisent tous la bibliothèque -\path{mktex.dll}. - -Il existe même un outil générique appelé \path{irun.exe} qui permet -de simuler les liens durs de Unix sous Win32, mais uniquement pour les -fichiers \file{.exe}. - -\subsection{En cas de problème} -\label{sec:troubleshooting} - -\subsubsection{Que faire si \texttt{latex} ne trouve pas vos fichiers ?} - -\begin{itemize} -\item \cmdname{kpsewhich} est l'outil de choix pour trouver la source - de n'importe quel problème. Malheureusement, \cmdname{kpsewhich} - écrit le résultat de ses recherches sur le flux \path{stderr}, et - les anciennes versions de la console de Windows ne savaient pas - rediriger ce flux vers un fichier\footnote{En fait, les systèmes - Windows NT/2K/XP savent le faire, grâce à leur nouvel interpréteur - de commandes, mais l'astuce spécifique à \KPS{}-Win32 fonctionne - sur toutes les consoles.}. Pour des besoins de diagnostic, vous - pouvez positionner temporairement une variable d'environnement en tapant - dans une console : -\begin{verbatim} -SET KPATHSEA_DEBUG_OUTPUT=err.log -\end{verbatim} -Vous pouvez également définir un niveau de trace : -\begin{verbatim} -SET KPATHSEA_DEBUG=-1 -\end{verbatim} - -La trace de l'exécution des commandes suivantes sera conservée dans le -fichier \filename{err.log}. Si vous voulez rediriger le flux stderr sur le -flux stdout, ce qui n'est normalement possible sous aucune version de Windows, -il vous suffit de faire : -\begin{verbatim} -SET KPATHSEA_DEBUG_OUTPUT=con: -\end{verbatim} -De cette manière, vous pourrez rediriger à la fois stdout et stderr -dans le même fichier. - -\item En supposant que l'installation a été faite dans - \texttt{C:/TeX}, vérifiez les valeurs suivantes :\\ - \begin{tabular}{ll} - \texttt{kpsewhich -expand-path \$SELFAUTOPARENT} & \texttt{C:/TeX} \\ - \texttt{kpsewhich -expand-path \$TEXMF} & \texttt{C:/TeX/texmf....} \\ - \texttt{kpsewhich -expand-path \$TEXMFCNF} & - \texttt{.;C:/TeX/texmf-var/web2c;} \\ - \texttt{kpsewhich -expand-var \$TEXINPUTS} & \texttt{.;C:/TeX/texmf/tex//} - \end{tabular} - -\item Si des variables d'environnement liées à TeX sont - positionnées dans votre environnement, enlevez-les, car elles - masquent les valeurs existant dans le fichier \filename{texmf.cnf}. - -\item Vérifiez les valeurs de :\\ - \begin{tabular}{ll} - \texttt{kpsewhich cmr10.tfm} & \texttt{C:/TeX/texmf-dist/fonts/tfm/public/cm/cmr10.tfm}\\ - \texttt{kpsewhich latex.fmt}& \texttt{C:/TeX/texmf-var/web2c/latex.fmt} - \end{tabular} - -\item à ce point, si tout est correct, \TeX{} et tous les - programmes associés doivent fonctionner. Si ce n'est pas le cas, - vous devez poursuivre vos investigations avec l'option \path{-debug=n} de - \path{kpsewhich} et contrôler toutes les valeurs. Essayez - d'identifier et de signaler le problème. -\end{itemize} - -\subsubsection{Que faire si votre installation ne fonctionne toujours - pas selon vos attentes ?} - -Il faut se poser plusieurs questions : -\begin{enumerate} -\item Est-ce que \path{tex.exe} est bien dans mon \path{PATH} ? - -\item Est-ce que la variable d'environnement \path{TEXMFCNF} est bien - positionnée à \\ - \path{C:/TeXLive2007/texmf-var/web2c} (valeur par défaut) ? - -\item Est-ce qu'il y a des erreurs dans le fichier de log \file{tlmpgui.log} - généré lors de l'installation par \filename{tlmpgui} ? Ce fichier est dans - le répertoire \file{TEMP}, les erreurs sont repérées par la séquence - \samp{Error}. - -\item Y a-t-il des correctifs de bogues correspondant au problème à - \url{http://www.tug.org/tex-live.html} (improbable, mais il vaut - mieux le vérifier). - -\end{enumerate} - -Le logiciel \TL{} est composé de centaines de -programmes et de milliers de fichiers d'origines très diverses. Il -est pratiquement impossible de prédire toutes les causes possibles de -problèmes. Néanmoins, nous ferons notre possible pour vous aider dans -tous les cas (voir section~\ref{sec:help}, \p.\pageref{sec:help}). - -% don't use \Webc so the \uppercase in the headline works. -%\section{Guide d'utilisation du système \protect\Webc{}} -\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\oe ur de \TL{}. - -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. - -Le système \Webc{} fonctionne sur Unix, les systèmes Windows 32 bits, -\MacOSX{} et de nombreux autres systèmes d'exploitation. Il utilise les -sources originales de D.E.~Knuth pour \TeX{} et les autres programmes de base -écrits en \web{} qui sont tous traduits en langage C. Les composants du noyau -de \TeX{} sont : - -\begin{description} -%\renewcommand{\makelabel}[1]{\descriptionlabel{\makebox[0.6in][l]{#1}}} -\item[bibtex] Gère les bibliographies. -\item[dmp] \cmdname{troff} vers MPX (dessins \MP{}). -\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[makempx] Typographie des étiquettes \MP{}. -\item[mf] Création de fontes. -\item[mft] Mise en page de code source \MF{}. -\item[mpost] Création de diagrammes techniques. -\item[mpto] Extraction d'étiquettes \MP{}. -\item[newer] Comparaison de dates de modification (fichiers). -\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{description} - -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 \acro{GNU} : -\begin{description} -%\renewcommand{\descriptionlabel}[1]{\makebox[1.4in][l]{#1}} - \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{}. 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} - -Décrivons en premier lieu le mécanisme de recherche de la bibliothèque -\KPS{}. - -Nous appelons \emph{chemin de recherche} une liste, séparée par -\og deux-points\fg{} ou \og point-virgule\fg{}, d'éléments, 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{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 de répertoires qui correspondent -à cet élément de chemin, puis cherche le fichier dans chaque -élément -de cette liste. - -La condition \og le fichier est censé exister\fg{} 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*} -\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{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 - \og \texttt{S /a:/b}\fg{} 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{Debugging}). - -\subsubsection{Fichiers de configuration} - -\begingroup\tolerance=3500 -\KPS{} lit dans les \emph{fichiers de configuration à - l'exécution} appelés \file{texmf.cnf} les chemins de recherche et -d'autres définitions. Le chemin pour accéder à ces fichiers dans -l'arborescence est stocké dans la variable \envname{TEXMFCNF} -(par défaut ces -fichiers se trouvent dans le sous-répertoire \file{texmf/web2c}). -\emph{Tous} les fichiers \file{texmf.cnf} se trouvant dans le chemin -de recherche vont être lus et les définitions provenant -de fichiers précédents écraseront celles des fichiers suivants. Par -exemple, avec un chemin tel que \verb|.:$TEXMF|, les définitions du -fichier \filename{./texmf.cnf} écrasent celles de -\verb|$TEXMF/texmf.cnf|. -\endgroup - -\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 - -%\verbatiminput{examples/ex5.tex} % trop petit (df) -\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{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{Default-expansion} - -\tolerance=2500 -Si le chemin de recherche le plus prioritaire (voir -section~\ref{Path-sources}) contient un \samp{:} -\emph{supplémentaire} (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 - -\tolerance=1500 - -\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} - -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 du type suivant -(il y a en fait plus de répertoires) : -\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 \og gelée\fg{} (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{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{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{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 -inspecter (\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 -%cd \var{/your/texmf/root} && \path|\|ls -1LAR ./ >ls-R| -% Remplacé (df) car \path|...| plante à cause de \let\path\url. -\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 \acro{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{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} -%\renewcommand{\makelabel}[1]{\descriptionlabel{\makebox[1.2in]{#1}}} -\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{SExamplesofuse} - -Jetons un coup d'{\oe}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 fichiers Computer Modern \file{.pk} pré-créés sur nos systèmes -(nous utilisons les versions type~1 du \TL{}). -\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é 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{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. -\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 à la valeur (ou -à une combinaison de valeurs) décrite(s) dans la liste ci-dessus. - -Note à l'intention des utilisateurs de Windows : il n'est pas facile -de rediriger les messages d'erreur vers un fichier sur ces -systèmes. À des fins de diagnostic, vous pouvez temporairement -affecter \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 \DVDlive{}). -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 (\p.ex., 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{SExamplesofuse} 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, et 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 \og résident\fg{} -(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 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} (supprimé (df) 5/5/2006, mail à K.B. - -\section{Installation sur un nouveau système Unix} - -Si vous avez un système Unix ne correspondant à aucun des exécutables -fournis, il faut compiler vous-même \TeX{} et tous ses programmes -satellites à partir des sources. Cela n'est pas aussi difficile qu'il -y paraît. Tout ce dont vous aurez besoin est contenu dans le -répertoire \texttt{source} qui se trouve sur le \DVDlive. - -\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 \acro{GNU} des programmes suivants -(\cmdname{gcc}, \acro{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:unix-install-disk}, -\p.\pageref{sec:unix-install-disk}). 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. -\begin{comment} -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 \acro{GNU} en format Info\\ - \dirname{$TEXDIR/bin/$archname} & exécutables.\\ -\end{tabular}\\ -\end{comment} -%$ - -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 \acro{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}, \p.\pageref{sec:postinstall}. - -%\end{comment} supprimé (df) 5/5/2006 - -\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 -Sebastian Rahtz et Karl Berry. -Voici la liste des principaux contributeurs : - -\begin{itemize} - -\item Les associations d'utilisateurs anglais, allemands, néerlandais et - polonais (\acro{TUG}, \acro{DANTE} e.V., \acro{NTG}, and \acro{GUST}, - respectivement) qui contribuent ensemble à l'infrastructure technique et - administrative. Soutenez votre association locale (\acro{GUTenberg} pour - les francophones) ! - -\item L'équipe du \acro{CTAN} 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 Peter Breitenlohner et toute l'équipe \eTeX{} qui construisent - les bases des successeurs de \TeX. - -\item Thomas Esser, car, sans lui, sa merveilleuse distribution \teTeX{} et - son aide continuelle, \TL{} n'existerait probablement pas. - -\item Michel Goossens, en tant que co-auteur de la documentation initiale. - -\item Eitan Gurari, dont le programme \TeX4ht a été utilisé pour créer la - version \HTML{} de cette documentation et qui travailla inlassablement à - l'améliorer, avec des délais très brefs. - -\item Hans Hagen qui, outre sa participation active aux tests, - a adapté le format \ConTeXt\ aux besoins de \TL{}. - -\item \Thanh, Martin Schr\"oder et toute l'équipe pdf\TeX\ qui continuent - inlassablement à étendre les performances de \TeX. - -\item Taco Hoekwater, pour ses efforts sans cesse renouvelés à l'amélioration - de MetaPost et de \TeX\ lui-même. - -\item Pawe{\l} Jackowski, pour l'installeur Windows \cmdname{tlpm}, -et Tomasz {\L}uczak, pour la version graphique \cmdname{tlpmgui}. - -\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://www.fsci.fuk.kindai.ac.jp/kakuto/win32-ptex/}). - -\item Jonathan Kew et son employeur \acro{SIL}, pour avoir produit - Xe\TeX{} et pour avoir pris la peine de l'intégrer dans \TL{}. - -\item Reinhard Kotucha, pour son aide dans la lourde tâche consistant à -mettre à jour les innombrables extensions incluses dans \TL{} et pour ses -contributions sous Windows en particulier le script \texttt{getnonfreefonts}. - -\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 Fabrice Popineau, pionnier du développement de \TL{} sous Windows. - -\item Norbert Preining, pour son aide à la mise à jour de \TL, ses nombreuses - suggestions d'amélioration et pour avoir coordonné (avec Frank K\"uster) la - version Debian de \TL. - -\item Staszek Wawrykiewicz, principal testeur de \TL{} et - coordinateur des contributions polonaises - (fontes, installation Windows, etc.). - -\item Olaf Weber, pour son patient assemblage et la maintenance de \Webc{} - sur laquelle tout repose. - -\item Gerben Wierda, qui a créé et maintient la partie \MacOSX{} - et qui participe activement aux tests. - -\item Graham Williams, du travail duquel dépend le catalogue des -composants. -\end{itemize} - -Les binaires ont été compilés par : -Hartmut Henkel (\pkgname{x86\_64-linux}), -Akira Kakuto et Fabrice Popineau (\pkgname{win32}), -Manfred Lotz (\pkgname{i386-freebsd}), -Norbert Preining (\pkgname{alpha-linux}), -Vladimir Volovich (\pkgname{powerpc-aix}, \pkgname{sparc-linux} - et \pkgname{sparc-solaris}), -Karl Berry (\pkgname{i386-linux}), -Olaf Weber (\pkgname{mips-irix}), -Gerben Wierda (\pkgname{i386-darwin}, \pkgname{powerpc-darwin}). - -Documentation et mises à jour des traductions : -Karl Berry (anglais), -G\"unter Partosch, Hartmut Henkel \& Klaus H\"oppner (allemand), -Daniel Flipo (français), -Petr Sojka \& Janka Chleb\'\i kov\'a (tchèque et slovaque), -Boris Veytsman (russe), -Staszek Wawrykiewicz (polonais). - -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, -mais aussi d'un groupe de travail \og \acro{TUG} Technical Council\fg{} 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:multiple-dist}, -\p.\pageref{sec:multiple-dist}). 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 \p.\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-bit - 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-bit é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 provisoirement plus proposée dans l'attente -d'un nouvel installeur. À la place, vous pouvez tester et installer -la distribution \MIKTEX{} (indépendante de \Webc{}), -voir section~\ref{sec:struct-tl}, \p.\pageref{sec:struct-tl}. -Le \CDdemo{} diffusé en 2003 a été supprimé. - -\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}, \p.\pageref{sec:tld}. -% et les fichiers \filename{README} à la racine de ces répertoires. -% (df) Y'en a pas !!! - -\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-doc/doc/english/tds/tds.html\#Extensions} -{\texttt{texmf-doc/doc/english/tds/tds.html\#Extensions}}. - -\item Les scripts auxiliaires, normalement pas exécutés directement -par les utilisateurs, sont regroupés dans un répertoire \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 -\OnCD{texmf-doc/doc/english/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 {\oe}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 {\oe}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://www.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}), voir %$ - section~\ref{sec:texconfig}, \p.\pageref{sec:texconfig}. - -\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}, \p.\pageref{sec:texmftrees} pour - la description des différentes arborescences texmf utilisées. - -\item L'an dernier nous avions rendu \og \texttt{undefined} \fg 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-bit - 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} - -\subsection{L'édition 2006--2007} -\label{tlcurrent} - -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}. - -MetaPost 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 MetaPost 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{} \og à la Knuth \fg ! -\LaTeX\ et tous les autres prennent toujours en compte les lignes commençant -par \texttt{\%\&}. - -Les scripts d'installation peuvent maintenant être utilisés de manière -non interactive (voir section~\ref{sec:noninteractive-install}) en -positionnant des variables d'environnement. - -Comme chaque année des centaines d'extensions et de programmes ont été mis à -jour, voir les sites \acro{CTAN} (\url{http://www.ctan.org}). - -L'arborescence utilisée en interne a été réorganisée avec de nouveaux outils -qui devraient fournir une meilleure base de travail pour les développements -futurs. - -Enfin, en mai 2006 Thomas Esser a annoncé qu'il renonçait à poursuivre -le développement de 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 - \acro{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. - - - -\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 débordés, dans la limite de leur temps -libre, et beaucoup reste à faire. Si vous pouvez nous aider, n'hésitez pas -à vous proposer ! - -Corrections, suggestions et propositions d'aide doivent -être envoyées à :\hfill\null -\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: latin-1 -%%% End: |