From b04c2e1a42573e9735547702356c7b9a769a6855 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Sun, 7 Apr 2013 18:26:53 +0000 Subject: texmf -> texmf-dist: doc git-svn-id: svn://tug.org/texlive/trunk@29714 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/texlive/texlive-fr/Makefile | 4 + .../texmf-dist/doc/texlive/texlive-fr/live4ht.cfg | 47 + Master/texmf-dist/doc/texlive/texlive-fr/notes | 83 + .../texmf-dist/doc/texlive/texlive-fr/tex-live.css | 44 + .../doc/texlive/texlive-fr/texlive-fr.css | 478 ++ .../doc/texlive/texlive-fr/texlive-fr.html | 6668 ++++++++++++++++++++ .../doc/texlive/texlive-fr/texlive-fr.pdf | Bin 0 -> 997622 bytes .../doc/texlive/texlive-fr/texlive-fr.tex | 3653 +++++++++++ 8 files changed, 10977 insertions(+) create mode 100644 Master/texmf-dist/doc/texlive/texlive-fr/Makefile create mode 100644 Master/texmf-dist/doc/texlive/texlive-fr/live4ht.cfg create mode 100644 Master/texmf-dist/doc/texlive/texlive-fr/notes create mode 100644 Master/texmf-dist/doc/texlive/texlive-fr/tex-live.css create mode 100644 Master/texmf-dist/doc/texlive/texlive-fr/texlive-fr.css create mode 100644 Master/texmf-dist/doc/texlive/texlive-fr/texlive-fr.html create mode 100644 Master/texmf-dist/doc/texlive/texlive-fr/texlive-fr.pdf create mode 100644 Master/texmf-dist/doc/texlive/texlive-fr/texlive-fr.tex (limited to 'Master/texmf-dist/doc/texlive/texlive-fr') diff --git a/Master/texmf-dist/doc/texlive/texlive-fr/Makefile b/Master/texmf-dist/doc/texlive/texlive-fr/Makefile new file mode 100644 index 00000000000..ad5d26d2c34 --- /dev/null +++ b/Master/texmf-dist/doc/texlive/texlive-fr/Makefile @@ -0,0 +1,4 @@ +include ../texlive-en/Makefile +doc = texlive-fr + + diff --git a/Master/texmf-dist/doc/texlive/texlive-fr/live4ht.cfg b/Master/texmf-dist/doc/texlive/texlive-fr/live4ht.cfg new file mode 100644 index 00000000000..4da18b3c746 --- /dev/null +++ b/Master/texmf-dist/doc/texlive/texlive-fr/live4ht.cfg @@ -0,0 +1,47 @@ +% tex4ht configuration file for the TeX Live documentation. +% Accumulated over many years. Public domain. +% +% html specifies the main output format. +% info for extra debugging info in the log files. + +% better approach is to have html in one piece (including footnotes). +% charset=utf-8 fails for French, all accented letters get lost. +\Preamble{html,info,fn-in} + +% add extra stylesheet +\Configure{@HEAD}{\HCode{% +\Hnewline +\Hnewline +}} + +% or LaTeX complains it is missing. +\begin{document} + +\EndPreamble + +% simplify output for HTML. We leave TeX and LaTeX alone, since tex4ht +% actually does the lowered E (and raised A) in CSS. +\def\OMEGA{Omega} +\def\LaTeXe{LaTeX2e} +\def\eTeX{e-\TeX} +\def\acro#1{#1} +\def\MF{Metafont} +\def\BibTeX{BibTeX} +\def\warningbox{} +\def\endwarningbox{} + +\newif\ifhackliterals +\ifx\tldocenglish\undefined \else \hackliteralstrue \fi +\ifx\tldocrussian\undefined \else \hackliteralstrue \fi +\ifx\tldocgerman\undefined \else \hackliteralstrue \fi +% +\ifhackliterals + % these definitions cause "missing } inserted" at \end{tabularx} in + % French and Czech. don't know why. + % + % don't make these into links, as happens with \path. We only have a couple + % special characters that actually occur. + \def\dirname{\texttt\bgroup\catcode`\$=12 \catcode`\_=12 \finishliteral} + \def\finishliteral#1{#1\egroup} + \let\filename=\dirname +\fi diff --git a/Master/texmf-dist/doc/texlive/texlive-fr/notes b/Master/texmf-dist/doc/texlive/texlive-fr/notes new file mode 100644 index 00000000000..75d4504473a --- /dev/null +++ b/Master/texmf-dist/doc/texlive/texlive-fr/notes @@ -0,0 +1,83 @@ +Notes sur la VF +--------------- + +1976: trop d'espace avant le alltt, ou pas assez après. À régler dans le +préambule ? + +Suggestions pour texlive-en.tex +------------------------------- + +win32 supported: add Seven + +3.1: be clearer about admin install (in general) + +Ajout df, fin de 1.1 : +Les utilisateurs des éditions précédentes de \TL{} sont invités +à lire, \emph{avant toute mise à jour}, la section~\ref{sec:tlcurrent} +page~\pageref{sec:tlcurrent} qui présente les principaux changements intervenus +cette année. + +233: the translated README's are no more at the top-level, but +in readme-*.dir as described above. + +244: maybe mention that the TeX Live documentation is what the +reader is currently reading? + +271: addition by df: nothing should be manually added, modified +of removed from this tree. (mpg: actually, this is a common mistake) + +326: addition by df: eg, \dirname{texmf/tex/latex} for you +personnal LaTeX macros files. + +369: xetex/ (trailing slash) + +678: the numbering is weird (a, c, e, f, ...) and + +804: additional precisions here may be useful, like: +"The default paper size selection for tools such as \prog{dvips}, \prog{pdftex}, +\prog{xdvi}. It does not influence, and may be overridden by, the default paper +size used by macros such as the LaTeX classes and packages. Of course, +individual document..." + +816: is it clear for everyone that the context here is \write18? +"execution of external programs" does not seem explicit enough to me. + +1042: s/filename/pkgname/ + +1053: Isn't conf.d Debian-specific? + +1142: "this" looks like it means "using XeTeX", but probably +refers to "installing fonts". + +1236: the first sentence is about system fonts, while the end of +the paragraph says \TL fonts. Which one is correct? + +1267: quite messy, sometimes the description says "is free +software", sometimes not. We'd better say "all are free software unless stated +otherwise". We could say which items are Windows-only. Why is there 2 Emacs +items? Concerning Vim, add a reference to latex-suite. Why not put TW first, +then other free cross-platform software, then free platform-specific, then +non-free? Add Kile for Linux? + +1296: the term "installation" may be confusing (I thought it was +about the net installer first), maybe "using TL from a network" would be better? + +1340: addition by df: nothing is touched on the host system +outside ~/.tlportable2009 + +1389: s/location/repository/ + +1506: IMO, TeXworks should come first, and Perl/GS last (I doubt +the average user cares about it). + +1544: s/Xe\TeX/\XeTeX/ (in other places, too) + +1562: this section sounds rather theoretical: how does all this relate to TL? + +3076: Final note on the past is \section{Present}??? + +Suggestions pour texlive-en.sty +------------------------------- + +- TeXworks logo, XeTeX logo? +- More systematic use of \xspace? diff --git a/Master/texmf-dist/doc/texlive/texlive-fr/tex-live.css b/Master/texmf-dist/doc/texlive/texlive-fr/tex-live.css new file mode 100644 index 00000000000..5062bc0d229 --- /dev/null +++ b/Master/texmf-dist/doc/texlive/texlive-fr/tex-live.css @@ -0,0 +1,44 @@ +/* $Id$ + Simple CSS for TeX Live that adds margins and a little color. + original by Bzyl Wlodzimierz, edited by Karl Berry, 2005. + Public domain. */ + +html { + // top left bottom right + margin: 15pt 15pt 15pt 15pt; + background: rgb(255,255,224); +} + +body { + margin: 0 5pt 0 5pt; + padding: 0; + //matw: background: rgb(224,255,224); + // (It looks better to me to have a consistent background --karl) +// fonts in browser are low resolution; +// therefore generated serif are poor quality, +// so they disturb reading (that is my opinion) + font-family: sans-serif; + font-style: normal; +} + +/* (It looks better to me to not vary colors at every level --karl) */ + +h3.sectionHead { + padding: 12pt 10pt 12pt 20pt; + //matw: background: rgb(192,224,255); + background: rgb(224,224,255); + color: rgb(0,0,32); +} + +h4.subsectionHead { + padding: 7pt 10pt 7pt 40pt; + background: rgb(224,224,255); + color: rgb(0,0,32); +} + +h5.subsubsectionHead { + padding: 3pt 10pt 3pt 40pt; + //matw: background: rgb(224,255,255); + background: rgb(224,224,255); + color: rgb(0,0,32); +} diff --git a/Master/texmf-dist/doc/texlive/texlive-fr/texlive-fr.css b/Master/texmf-dist/doc/texlive/texlive-fr/texlive-fr.css new file mode 100644 index 00000000000..42ab2f78e4c --- /dev/null +++ b/Master/texmf-dist/doc/texlive/texlive-fr/texlive-fr.css @@ -0,0 +1,478 @@ + +/* start css.sty */ +.ec-lmri-12x-x-172{font-size:206%; font-style:italic;} +.ec-lmri-12x-x-172{ font-style:italic;} +.ec-lmri-12x-x-172{ font-style:italic;} +.ec-lmri-12x-x-172{ font-style:italic;} +.ec-lmri-12x-x-172{ font-style:italic;} +.ec-lmri-12x-x-172{ font-style:italic;} +.ec-lmri-12x-x-172{ font-style:italic;} +.ec-lmri-12x-x-172{ font-style:italic;} +.ec-lmri-12x-x-172{ font-style:italic;} +.ec-lmri-12x-x-172{ font-style:italic;} +.ec-lmri-12x-x-172{ font-style:italic;} +.ec-lmri-12x-x-172{ font-style:italic;} +.ec-lmri-12x-x-172{ font-style:italic;} +.ec-lmri-12x-x-172{ font-style:italic;} +.ec-lmri-12x-x-172{ font-style:italic;} +.ec-lmri-12x-x-172{ font-style:italic;} +.ec-lmri-12x-x-172{ font-style:italic;} +.ec-lmri-12x-x-172{ font-style:italic;} +.ec-lmri-12x-x-172{ font-style:italic;} +.ec-lmri-12x-x-172{ font-style:italic;} +.ec-lmri-12x-x-172{ font-style:italic;} +.ec-lmss-17{font-size:170%; font-family: sans-serif;} +.ec-lmss-17{ font-family: sans-serif;} +.ec-lmss-17{ font-family: sans-serif;} +.ec-lmss-17{ font-family: sans-serif;} +.ec-lmss-17{ font-family: sans-serif;} +.ec-lmss-17{ font-family: sans-serif;} +.ec-lmss-17{ font-family: sans-serif;} +.ec-lmss-17{ font-family: sans-serif;} +.ec-lmss-17{ font-family: sans-serif;} +.ec-lmss-17{ font-family: sans-serif;} +.ec-lmss-17{ font-family: sans-serif;} +.ec-lmss-17{ font-family: sans-serif;} +.ec-lmss-17{ font-family: sans-serif;} +.ec-lmss-17{ font-family: sans-serif;} +.ec-lmss-17{ font-family: sans-serif;} +.ec-lmss-17{ font-family: sans-serif;} +.ec-lmss-17{ font-family: sans-serif;} +.ec-lmss-17{ font-family: sans-serif;} +.ec-lmss-17{ font-family: sans-serif;} +.ec-lmss-17{ font-family: sans-serif;} +.ec-lmss-17{ font-family: sans-serif;} +.ec-lmr-12{font-size:120%;} +.lmsy-10x-x-120{font-size:120%;} +.ec-lmtt-12{font-size:120%; font-family: monospace;} +.ec-lmtt-12{ font-family: monospace;} +.ec-lmtt-12{ font-family: monospace;} +.ec-lmtt-12{ font-family: monospace;} +.ec-lmtt-12{ font-family: monospace;} +.ec-lmtt-12{ font-family: monospace;} +.ec-lmtt-12{ font-family: monospace;} +.ec-lmtt-12{ font-family: monospace;} +.ec-lmtt-12{ font-family: monospace;} +.ec-lmtt-12{ font-family: monospace;} +.ec-lmtt-12{ font-family: monospace;} +.ec-lmtt-12{ font-family: monospace;} +.ec-lmtt-12{ font-family: monospace;} +.ec-lmtt-12{ font-family: monospace;} +.ec-lmtt-12{ font-family: monospace;} +.ec-lmtt-12{ font-family: monospace;} +.ec-lmtt-12{ font-family: monospace;} +.ec-lmtt-12{ font-family: monospace;} +.ec-lmtt-12{ font-family: monospace;} +.ec-lmtt-12{ font-family: monospace;} +.ec-lmtt-12{ font-family: monospace;} +.ec-lmri-12{font-size:120%; font-style:italic;} +.ec-lmri-12{ font-style:italic;} +.ec-lmri-12{ font-style:italic;} +.ec-lmri-12{ font-style:italic;} +.ec-lmri-12{ font-style:italic;} +.ec-lmri-12{ font-style:italic;} +.ec-lmri-12{ font-style:italic;} +.ec-lmri-12{ font-style:italic;} +.ec-lmri-12{ font-style:italic;} +.ec-lmri-12{ font-style:italic;} +.ec-lmri-12{ font-style:italic;} +.ec-lmri-12{ font-style:italic;} +.ec-lmri-12{ font-style:italic;} +.ec-lmri-12{ font-style:italic;} +.ec-lmri-12{ font-style:italic;} +.ec-lmri-12{ font-style:italic;} +.ec-lmri-12{ font-style:italic;} +.ec-lmri-12{ font-style:italic;} +.ec-lmri-12{ font-style:italic;} +.ec-lmri-12{ font-style:italic;} +.ec-lmri-12{ font-style:italic;} +.ec-lmtt-10{ font-family: monospace;} +.ec-lmtt-10{ font-family: monospace;} +.ec-lmtt-10{ font-family: monospace;} +.ec-lmtt-10{ font-family: monospace;} +.ec-lmtt-10{ font-family: monospace;} +.ec-lmtt-10{ font-family: monospace;} +.ec-lmtt-10{ font-family: monospace;} +.ec-lmtt-10{ font-family: monospace;} +.ec-lmtt-10{ font-family: monospace;} +.ec-lmtt-10{ font-family: monospace;} +.ec-lmtt-10{ font-family: monospace;} +.ec-lmtt-10{ font-family: monospace;} +.ec-lmtt-10{ font-family: monospace;} +.ec-lmtt-10{ font-family: monospace;} +.ec-lmtt-10{ font-family: monospace;} +.ec-lmtt-10{ font-family: monospace;} +.ec-lmtt-10{ font-family: monospace;} +.ec-lmtt-10{ font-family: monospace;} +.ec-lmtt-10{ font-family: monospace;} +.ec-lmtt-10{ font-family: monospace;} +.ec-lmtt-10{ font-family: monospace;} +.ec-lmss-10{ font-family: sans-serif;} +.ec-lmss-10{ font-family: sans-serif;} +.ec-lmss-10{ font-family: sans-serif;} +.ec-lmss-10{ font-family: sans-serif;} +.ec-lmss-10{ font-family: sans-serif;} +.ec-lmss-10{ font-family: sans-serif;} +.ec-lmss-10{ font-family: sans-serif;} +.ec-lmss-10{ font-family: sans-serif;} +.ec-lmss-10{ font-family: sans-serif;} +.ec-lmss-10{ font-family: sans-serif;} +.ec-lmss-10{ font-family: sans-serif;} +.ec-lmss-10{ font-family: sans-serif;} +.ec-lmss-10{ font-family: sans-serif;} +.ec-lmss-10{ font-family: sans-serif;} +.ec-lmss-10{ font-family: sans-serif;} +.ec-lmss-10{ font-family: sans-serif;} +.ec-lmss-10{ font-family: sans-serif;} +.ec-lmss-10{ font-family: sans-serif;} +.ec-lmss-10{ font-family: sans-serif;} +.ec-lmss-10{ font-family: sans-serif;} +.ec-lmss-10{ font-family: sans-serif;} +.ec-lmri-10{ font-style:italic;} +.ec-lmri-10{ font-style:italic;} +.ec-lmri-10{ font-style:italic;} +.ec-lmri-10{ font-style:italic;} +.ec-lmri-10{ font-style:italic;} +.ec-lmri-10{ font-style:italic;} +.ec-lmri-10{ font-style:italic;} +.ec-lmri-10{ font-style:italic;} +.ec-lmri-10{ font-style:italic;} +.ec-lmri-10{ font-style:italic;} +.ec-lmri-10{ font-style:italic;} +.ec-lmri-10{ font-style:italic;} +.ec-lmri-10{ font-style:italic;} +.ec-lmri-10{ font-style:italic;} +.ec-lmri-10{ font-style:italic;} +.ec-lmri-10{ font-style:italic;} +.ec-lmri-10{ font-style:italic;} +.ec-lmri-10{ font-style:italic;} +.ec-lmri-10{ font-style:italic;} +.ec-lmri-10{ font-style:italic;} +.ec-lmri-10{ font-style:italic;} +.ec-lmr-9{font-size:90%;} +.ec-lmr-8{font-size:80%;} +.ec-lmri-8{font-size:80%; font-style:italic;} +.ec-lmri-8{ font-style:italic;} +.ec-lmri-8{ font-style:italic;} +.ec-lmri-8{ font-style:italic;} +.ec-lmri-8{ font-style:italic;} +.ec-lmri-8{ font-style:italic;} +.ec-lmri-8{ font-style:italic;} +.ec-lmri-8{ font-style:italic;} +.ec-lmri-8{ font-style:italic;} +.ec-lmri-8{ font-style:italic;} +.ec-lmri-8{ font-style:italic;} +.ec-lmri-8{ font-style:italic;} +.ec-lmri-8{ font-style:italic;} +.ec-lmri-8{ font-style:italic;} +.ec-lmri-8{ font-style:italic;} +.ec-lmri-8{ font-style:italic;} +.ec-lmri-8{ font-style:italic;} +.ec-lmri-8{ font-style:italic;} +.ec-lmri-8{ font-style:italic;} +.ec-lmri-8{ font-style:italic;} +.ec-lmri-8{ font-style:italic;} +.ec-lmbx-10{ font-weight: bold;} +.ec-lmbx-10{ font-weight: bold;} +.ec-lmbx-10{ font-weight: bold;} +.ec-lmbx-10{ font-weight: bold;} +.ec-lmbx-10{ font-weight: bold;} +.ec-lmbx-10{ font-weight: bold;} +.ec-lmbx-10{ font-weight: bold;} +.ec-lmbx-10{ font-weight: bold;} +.ec-lmbx-10{ font-weight: bold;} +.ec-lmbx-10{ font-weight: bold;} +.ec-lmbx-10{ font-weight: bold;} +.ec-lmbx-10{ font-weight: bold;} +.ec-lmbx-10{ font-weight: bold;} +.ec-lmbx-10{ font-weight: bold;} +.ec-lmbx-10{ font-weight: bold;} +.ec-lmbx-10{ font-weight: bold;} +.ec-lmbx-10{ font-weight: bold;} +.ec-lmbx-10{ font-weight: bold;} +.ec-lmbx-10{ font-weight: bold;} +.ec-lmbx-10{ font-weight: bold;} +.ec-lmbx-10{ font-weight: bold;} +.ec-lmtk-10{ font-family: monospace;} +.ec-lmtk-10{ font-family: monospace;} +.ec-lmtk-10{ font-family: monospace;} +.ec-lmtk-10{ font-family: monospace;} +.ec-lmtk-10{ font-family: monospace;} +.ec-lmtk-10{ font-family: monospace;} +.ec-lmtk-10{ font-family: monospace;} +.ec-lmtk-10{ font-family: monospace;} +.ec-lmtk-10{ font-family: monospace;} +.ec-lmtk-10{ font-family: monospace;} +.ec-lmtk-10{ font-family: monospace;} +.ec-lmtk-10{ font-family: monospace;} +.ec-lmtk-10{ font-family: monospace;} +.ec-lmtk-10{ font-family: monospace;} +.ec-lmtk-10{ font-family: monospace;} +.ec-lmtk-10{ font-family: monospace;} +.ec-lmtk-10{ font-family: monospace;} +.ec-lmtk-10{ font-family: monospace;} +.ec-lmtk-10{ font-family: monospace;} +.ec-lmtk-10{ font-family: monospace;} +.ec-lmtk-10{ font-family: monospace;} +.ec-lmtt-8{font-size:80%; font-family: monospace;} +.ec-lmtt-8{ font-family: monospace;} +.ec-lmtt-8{ font-family: monospace;} +.ec-lmtt-8{ font-family: monospace;} +.ec-lmtt-8{ font-family: monospace;} +.ec-lmtt-8{ font-family: monospace;} +.ec-lmtt-8{ font-family: monospace;} +.ec-lmtt-8{ font-family: monospace;} +.ec-lmtt-8{ font-family: monospace;} +.ec-lmtt-8{ font-family: monospace;} +.ec-lmtt-8{ font-family: monospace;} +.ec-lmtt-8{ font-family: monospace;} +.ec-lmtt-8{ font-family: monospace;} +.ec-lmtt-8{ font-family: monospace;} +.ec-lmtt-8{ font-family: monospace;} +.ec-lmtt-8{ font-family: monospace;} +.ec-lmtt-8{ font-family: monospace;} +.ec-lmtt-8{ font-family: monospace;} +.ec-lmtt-8{ font-family: monospace;} +.ec-lmtt-8{ font-family: monospace;} +.ec-lmtt-8{ font-family: monospace;} +.ec-lmro-10{ font-style: oblique;} +.ec-lmro-10{ font-style: oblique;} +.ec-lmro-10{ font-style: oblique;} +.ec-lmro-10{ font-style: oblique;} +.ec-lmro-10{ font-style: oblique;} +.ec-lmro-10{ font-style: oblique;} +.ec-lmro-10{ font-style: oblique;} +.ec-lmro-10{ font-style: oblique;} +.ec-lmro-10{ font-style: oblique;} +.ec-lmro-10{ font-style: oblique;} +.ec-lmro-10{ font-style: oblique;} +.ec-lmro-10{ font-style: oblique;} +.ec-lmro-10{ font-style: oblique;} +.ec-lmro-10{ font-style: oblique;} +.ec-lmro-10{ font-style: oblique;} +.ec-lmro-10{ font-style: oblique;} +.ec-lmro-10{ font-style: oblique;} +.ec-lmro-10{ font-style: oblique;} +.ec-lmro-10{ font-style: oblique;} +.ec-lmro-10{ font-style: oblique;} +.ec-lmro-10{ font-style: oblique;} +.ec-lmtt-9{font-size:90%; font-family: monospace;} +.ec-lmtt-9{ font-family: monospace;} +.ec-lmtt-9{ font-family: monospace;} +.ec-lmtt-9{ font-family: monospace;} +.ec-lmtt-9{ font-family: monospace;} +.ec-lmtt-9{ font-family: monospace;} +.ec-lmtt-9{ font-family: monospace;} +.ec-lmtt-9{ font-family: monospace;} +.ec-lmtt-9{ font-family: monospace;} +.ec-lmtt-9{ font-family: monospace;} +.ec-lmtt-9{ font-family: monospace;} +.ec-lmtt-9{ font-family: monospace;} +.ec-lmtt-9{ font-family: monospace;} +.ec-lmtt-9{ font-family: monospace;} +.ec-lmtt-9{ font-family: monospace;} +.ec-lmtt-9{ font-family: monospace;} +.ec-lmtt-9{ font-family: monospace;} +.ec-lmtt-9{ font-family: monospace;} +.ec-lmtt-9{ font-family: monospace;} +.ec-lmtt-9{ font-family: monospace;} +.ec-lmtt-9{ font-family: monospace;} +.ec-lmssbx-10{ font-family: sans-serif; font-weight: bold;} +.ec-lmssbx-10{ font-family: sans-serif; font-weight: bold;} +.ec-lmssbx-10{ font-family: sans-serif; font-weight: bold;} +.ec-lmssbx-10{ font-family: sans-serif; font-weight: bold;} +.ec-lmssbx-10{ font-family: sans-serif; font-weight: bold;} +.ec-lmssbx-10{ font-family: sans-serif; font-weight: bold;} +.ec-lmssbx-10{ font-family: sans-serif; font-weight: bold;} +.ec-lmssbx-10{ font-family: sans-serif; font-weight: bold;} +.ec-lmssbx-10{ font-family: sans-serif; font-weight: bold;} +.ec-lmssbx-10{ font-family: sans-serif; font-weight: bold;} +.ec-lmssbx-10{ font-family: sans-serif; font-weight: bold;} +.ec-lmssbx-10{ font-family: sans-serif; font-weight: bold;} +.ec-lmssbx-10{ font-family: sans-serif; font-weight: bold;} +.ec-lmssbx-10{ font-family: sans-serif; font-weight: bold;} +.ec-lmssbx-10{ font-family: sans-serif; font-weight: bold;} +.ec-lmssbx-10{ font-family: sans-serif; font-weight: bold;} +.ec-lmssbx-10{ font-family: sans-serif; font-weight: bold;} +.ec-lmssbx-10{ font-family: sans-serif; font-weight: bold;} +.ec-lmssbx-10{ font-family: sans-serif; font-weight: bold;} +.ec-lmssbx-10{ font-family: sans-serif; font-weight: bold;} +.ec-lmssbx-10{ font-family: sans-serif; font-weight: bold;} +.ec-lmtti-10{ font-family: monospace; font-style:italic;} +.ec-lmtti-10{ font-family: monospace; font-style:italic;} +.ec-lmtti-10{ font-family: monospace; font-style:italic;} +.ec-lmtti-10{ font-family: monospace; font-style:italic;} +.ec-lmtti-10{ font-family: monospace; font-style:italic;} +.ec-lmtti-10{ font-family: monospace; font-style:italic;} +.ec-lmtti-10{ font-family: monospace; font-style:italic;} +.ec-lmtti-10{ font-family: monospace; font-style:italic;} +.ec-lmtti-10{ font-family: monospace; font-style:italic;} +.ec-lmtti-10{ font-family: monospace; font-style:italic;} +.ec-lmtti-10{ font-family: monospace; font-style:italic;} +.ec-lmtti-10{ font-family: monospace; font-style:italic;} +.ec-lmtti-10{ font-family: monospace; font-style:italic;} +.ec-lmtti-10{ font-family: monospace; font-style:italic;} +.ec-lmtti-10{ font-family: monospace; font-style:italic;} +.ec-lmtti-10{ font-family: monospace; font-style:italic;} +.ec-lmtti-10{ font-family: monospace; font-style:italic;} +.ec-lmtti-10{ font-family: monospace; font-style:italic;} +.ec-lmtti-10{ font-family: monospace; font-style:italic;} +.ec-lmtti-10{ font-family: monospace; font-style:italic;} +.ec-lmtti-10{ font-family: monospace; font-style:italic;} +.ec-lmr-7{font-size:70%;} +p.noindent { text-indent: 0em } +td p.noindent { text-indent: 0em; margin-top:0em; } +p.nopar { text-indent: 0em; } +p.indent{ text-indent: 1.5em } +@media print {div.crosslinks {visibility:hidden;}} +a img { border-top: 0; border-left: 0; border-right: 0; } +center { margin-top:1em; margin-bottom:1em; } +td center { margin-top:0em; margin-bottom:0em; } +.Canvas { position:relative; } +img.math{vertical-align:middle;} +li p.indent { text-indent: 0em } +li p:first-child{ margin-top:0em; } +li p:last-child, li div:last-child { margin-bottom:0.5em; } +li p~ul:last-child, li p~ol:last-child{ margin-bottom:0.5em; } +.enumerate1 {list-style-type:decimal;} +.enumerate2 {list-style-type:lower-alpha;} +.enumerate3 {list-style-type:lower-roman;} +.enumerate4 {list-style-type:upper-alpha;} +div.newtheorem { margin-bottom: 2em; margin-top: 2em;} +.obeylines-h,.obeylines-v {white-space: nowrap; } +div.obeylines-v p { margin-top:0; margin-bottom:0; } +.overline{ text-decoration:overline; } +.overline img{ border-top: 1px solid black; } +td.displaylines {text-align:center; white-space:nowrap;} +.centerline {text-align:center;} +.rightline {text-align:right;} +div.verbatim {font-family: monospace; white-space: nowrap; text-align:left; clear:both; } +.fbox {padding-left:3.0pt; padding-right:3.0pt; text-indent:0pt; border:solid black 0.4pt; } +div.fbox {display:table} +div.center div.fbox {text-align:center; clear:both; padding-left:3.0pt; padding-right:3.0pt; text-indent:0pt; border:solid black 0.4pt; } +div.minipage{width:100%;} +div.center, div.center div.center {text-align: center; margin-left:1em; margin-right:1em;} +div.center div {text-align: left;} +div.flushright, div.flushright div.flushright {text-align: right;} +div.flushright div {text-align: left;} +div.flushleft {text-align: left;} +.underline{ text-decoration:underline; } +.underline img{ border-bottom: 1px solid black; margin-bottom:1pt; } +.framebox-c, .framebox-l, .framebox-r { padding-left:3.0pt; padding-right:3.0pt; text-indent:0pt; border:solid black 0.4pt; } +.framebox-c {text-align:center;} +.framebox-l {text-align:left;} +.framebox-r {text-align:right;} +span.thank-mark{ vertical-align: super } +span.footnote-mark sup.textsuperscript, span.footnote-mark a sup.textsuperscript{ font-size:80%; } +div.footnotes{border-top:solid 1px black; border-bottom:solid 1px black; padding-bottom:1ex; padding-top:0.5ex; margin-right:15%; margin-top:2ex; font-style:italic; font-size:85%;} +div.footnotes p{margin-top:0; margin-bottom:0; text-indent:0;} +div.tabular, div.center div.tabular {text-align: center; margin-top:0.5em; margin-bottom:0.5em; } +table.tabular td p{margin-top:0em;} +table.tabular {margin-left: auto; margin-right: auto;} +td p:first-child{ margin-top:0em; } +td p:last-child{ margin-bottom:0em; } +div.td00{ margin-left:0pt; margin-right:0pt; } +div.td01{ margin-left:0pt; margin-right:5pt; } +div.td10{ margin-left:5pt; margin-right:0pt; } +div.td11{ margin-left:5pt; margin-right:5pt; } +table[rules] {border-left:solid black 0.4pt; border-right:solid black 0.4pt; } +td.td00{ padding-left:0pt; padding-right:0pt; } +td.td01{ padding-left:0pt; padding-right:5pt; } +td.td10{ padding-left:5pt; padding-right:0pt; } +td.td11{ padding-left:5pt; padding-right:5pt; } +table[rules] {border-left:solid black 0.4pt; border-right:solid black 0.4pt; } +.hline hr, .cline hr{ height : 1px; margin:0px; } +.tabbing-right {text-align:right;} +span.TEX {letter-spacing: -0.125em; } +span.TEX span.E{ position:relative;top:0.5ex;left:-0.0417em;} +a span.TEX span.E {text-decoration: none; } +span.LATEX span.A{ position:relative; top:-0.5ex; left:-0.4em; font-size:85%;} +span.LATEX span.TEX{ position:relative; left: -0.4em; } +div.float, div.figure {margin-left: auto; margin-right: auto;} +div.float img {text-align:center;} +div.figure img {text-align:center;} +.marginpar {width:20%; float:right; text-align:left; margin-left:auto; margin-top:0.5em; font-size:85%; text-decoration:underline;} +.marginpar p{margin-top:0.4em; margin-bottom:0.4em;} +table.equation {width:100%;} +.equation td{text-align:center; } +td.equation { margin-top:1em; margin-bottom:1em; } +td.equation-label { width:5%; text-align:center; } +td.eqnarray4 { width:5%; white-space: normal; } +td.eqnarray2 { width:5%; } +table.eqnarray-star, table.eqnarray {width:100%;} +div.eqnarray{text-align:center;} +div.array {text-align:center;} +div.pmatrix {text-align:center;} +table.pmatrix {width:100%;} +span.pmatrix img{vertical-align:middle;} +div.pmatrix {text-align:center;} +table.pmatrix {width:100%;} +span.bar-css {text-decoration:overline;} +img.cdots{vertical-align:middle;} +div.tabular, div.center div.tabular {text-align: center; margin-top:0.5em; margin-bottom:0.5em; } +table.tabular td p{margin-top:0em;} +table.tabular {margin-left: auto; margin-right: auto;} +td p:first-child{ margin-top:0em; } +td p:last-child{ margin-bottom:0em; } +div.td00{ margin-left:0pt; margin-right:0pt; } +div.td01{ margin-left:0pt; margin-right:5pt; } +div.td10{ margin-left:5pt; margin-right:0pt; } +div.td11{ margin-left:5pt; margin-right:5pt; } +table[rules] {border-left:solid black 0.4pt; border-right:solid black 0.4pt; } +td.td00{ padding-left:0pt; padding-right:0pt; } +td.td01{ padding-left:0pt; padding-right:5pt; } +td.td10{ padding-left:5pt; padding-right:0pt; } +td.td11{ padding-left:5pt; padding-right:5pt; } +table[rules] {border-left:solid black 0.4pt; border-right:solid black 0.4pt; } +.hline hr, .cline hr{ height : 1px; margin:0px; } +div.array {text-align:center;} +.partToc a, .partToc, .likepartToc a, .likepartToc {line-height: 200%; font-weight:bold; font-size:110%;} +.index-item, .index-subitem, .index-subsubitem {display:block} +div.caption {text-indent:-2em; margin-left:3em; margin-right:1em; text-align:left;} +div.caption span.id{font-weight: bold; white-space: nowrap; } +h1.partHead{text-align: center} +p.bibitem { text-indent: -2em; margin-left: 2em; margin-top:0.6em; margin-bottom:0.6em; } +p.bibitem-p { text-indent: 0em; margin-left: 2em; margin-top:0.6em; margin-bottom:0.6em; } +.paragraphHead, .likeparagraphHead { margin-top:2em; font-weight: bold;} +.subparagraphHead, .likesubparagraphHead { font-weight: bold;} +.quote {margin-bottom:0.25em; margin-top:0.25em; margin-left:1em; margin-right:1em; text-align:justify;} +.verse{white-space:nowrap; margin-left:2em} +div.maketitle {text-align:center;} +h2.titleHead{text-align:center;} +div.maketitle{ margin-bottom: 2em; } +div.author, div.date {text-align:center;} +div.thanks{text-align:left; margin-left:10%; font-size:85%; font-style:italic; } +.quotation {margin-bottom:0.25em; margin-top:0.25em; margin-left:1em; } +.abstract p {margin-left:5%; margin-right:5%;} +div.abstract {width:100%;} +.frenchb-nbsp{font-size:75%;} +.frenchb-thinspace{font-size:75%;} +.alltt P { margin-bottom : 0em; margin-top : 0em; } +.alltt { margin-bottom : 1em; margin-top : 1em; } +.figure img.graphics {margin-left:10%;} +table[rules] {border-left:solid black 0.4pt; border-right:solid black 0.4pt; } +div.longtable{text-align:center;} +.uline{ text-decoration:underline; } +.uuline{ text-decoration:underline; } +span.sout {text-decoration: line-through } +span.xout {text-decoration: line-through } +span.uwave {text-decoration:underline } +P.fancyvrb {white-space: nowrap; margin:0em;} +div#fancyvrb1{ border-top: solid 0.4pt; } +div#fancyvrb1{ border-left: solid 0.4pt; } +div#fancyvrb1{ border-bottom: solid 0.4pt; } +div#fancyvrb1{ border-right: solid 0.4pt; } +div#fancyvrb2{ border-top: solid 0.4pt; } +div#fancyvrb2{ border-left: solid 0.4pt; } +div#fancyvrb2{ border-bottom: solid 0.4pt; } +div#fancyvrb2{ border-right: solid 0.4pt; } +div#fancyvrb3{ border-top: solid 0.4pt; } +div#fancyvrb3{ border-left: solid 0.4pt; } +div#fancyvrb3{ border-bottom: solid 0.4pt; } +div#fancyvrb3{ border-right: solid 0.4pt; } +div#fancyvrb4{ border-top: solid 0.4pt; } +div#fancyvrb4{ border-left: solid 0.4pt; } +div#fancyvrb4{ border-bottom: solid 0.4pt; } +div#fancyvrb4{ border-right: solid 0.4pt; } +/* end css.sty */ + diff --git a/Master/texmf-dist/doc/texlive/texlive-fr/texlive-fr.html b/Master/texmf-dist/doc/texlive/texlive-fr/texlive-fr.html new file mode 100644 index 00000000000..79a9411e08c --- /dev/null +++ b/Master/texmf-dist/doc/texlive/texlive-fr/texlive-fr.html @@ -0,0 +1,6668 @@ + + + +Guide pratique de TeX Live +TeX Live 2012 + + + + + + + + + + +
+ + + + + +

Guide pratique de TEX Live
+TEX Live 2012

+
Karl Berry, éditeur +
http://tug.org/texlive/ +
Version française +
Manuel Pégourié-Gonnard*
+
+
Juin 2012
+
+

Table des matières

+
+1 Introduction +
 1.1 TEX Live et TEX Collection +
 1.2 Support des différents systèmes d’exploitation +
 1.3 Installation élémentaire de TEX Live +
 1.4 Remarques sur la sécurité +
 1.5 Obtenir de l’aide +
2 Structure de TEX Collection +
 2.1 TEX Collection : TEX Live, proTEXt, MacTEX +
 2.2 Répertoires situés à la racine de TEX Live +
 2.3 Description des arborescences « texmf » de TEX Live +
 2.4 Les extensions de TEX +
 2.5 Quelques autres programmes intéressants dans TEX Live +
 2.6 Fontes incluses dans TEX Live +
3 Installation +
 3.1 Démarrage de l’installation +
  3.1.1 Installation sous Unix +
  3.1.2 Installation sous Mac OS X +
  3.1.3 Installation sous Windows +
  3.1.4 Installation sous Cygwin +
  3.1.5 Installation en mode texte +
  3.1.6 Installation en mode graphique-expert +
  3.1.7 L’installation en mode magique +
 3.2 Choix des options d’installation +
  3.2.1 Choix des binaires (Unix seulement) +
  3.2.2 Sélection de ce qui va être installé +
  3.2.3 Répertoires d’installation + + +
  3.2.4 Options +
 3.3 Options de install-tl en ligne de commande +
  3.3.1 L’option -repository +
 3.4 Étapes post-installation +
  3.4.1 Variables d’environnement sous Unix +
  3.4.2 Variables d’environnement : configuration multi-utilisateur +
  3.4.3 Mises à jour par Internet après une installation par le DVD +
 3.5 Configuration des fontes pour XeTEX et LuaTEX +
  3.5.1 ConTEXt Mark IV +
  3.5.2 Ajout de fichiers locaux ou personnels +
  3.5.3 Ajout de fontes externes à TEX Live +
 3.6 Tester l’installation +
 3.7 Liens vers d’autres logiciels téléchargeables +
4 Installations spécialisées +
 4.1 Installation partagée entre plusieurs utilisateurs ou machines +
5 Installations « portable » de TEX Live +
 5.1 Installation sur DVD ou image ISO +
6 Maintenance de l’installation avec tlmgr +
 6.1 tlmgr en mode graphique +
 6.2 Exemples d’utilisation de tlmgr en ligne de commande +
7 Notes concernant Windows +
 7.1 Fonctionnalités supplémentaires à l’installation +
 7.2 Programmes supplémentaires +
 7.3 Répertoire personnel +
 7.4 Base de registre Windows +
 7.5 Droits d’accès sous Windows +
  7.5.1 Augmentation de la limite de mémoire sous Windows et Cygwin +
8 Guide d’utilisation du système Web2C +
 8.1 Kpathsea et la recherche de fichiers +
  8.1.1 Les différentes sources +
  8.1.2 Fichiers de configuration +
  8.1.3 Expansion d’un chemin de recherche +
  8.1.4 Expansion par défaut +
  8.1.5 Expansion spécifiée par les accolades +
  8.1.6 Expansion des sous-répertoires +
  8.1.7 Liste des caractères spéciaux et de leur signification : récapitulatif +
 8.2 Les bases de données +
  8.2.1 Le fichier base de données +
  8.2.2 kpsewhich : programme de recherche dans une arborescence +
  8.2.3 Exemples d’utilisation +
  8.2.4 Opérations de débogage +
 8.3 Options à l’exécution +
9 Remerciements +
10 Historique des versions successives +
 10.1 Les éditions précédentes +
  10.1.1 2003 +
  10.1.2 2004 +
  10.1.3 2005 + + +
  10.1.4 2006–2007 +
  10.1.5 2008 +
  10.1.6 2009 +
  10.1.7 2010 +
  10.1.8 2011 +
 10.2 Version présente +
 10.3 Versions futures +
+

+

1 Introduction

+

+

1.1 TEX Live et TEX Collection

+

Ce document décrit les principales caractéristiques de la distribution TEX Live, une distribution complète de +TEX pour Linux et autres Unix, Mac OS X et systèmes Windows. +

Cette distribution peut être obtenue par téléchargement, sur le DVD TEX Collection distribué par les groupes +d’utilisateurs de TEX à leurs membres, ou par d’autres moyens. La section 2.1 décrit brièvement le contenu du +DVD. TEX Live et TEX Collection sont le fruit des efforts des groupes d’utilisateurs de TEX. La description +qui suit porte essentiellement sur TEX Live. +

La distribution TEX Live comprend les binaires pré-compilés de TEX, LaTeX2e, ConTEXt, Metafont, +MetaPost, BibTeX et de nombreux autres programmes ainsi qu’une bibliothèque étendue de macros, de fontes +et de documentations. Elle permet aussi la composition de textes dans la plupart des langues utilisées dans le +monde. +

On trouvera à la fin du document, section 10 (page 76), un bref historique des principales modifications +apportées au fil du temps à la distribution TEX Live. +

Les utilisateurs des éditions précédentes de TEX Live sont invités à lire, avant toute mise à jour, la +section 10.2 page 85 qui présente les principaux changements intervenus cette année. +

+

1.2 Support des différents systèmes d’exploitation

+

TEX Live contient les exécutables pour les principales architectures Unix, dont GNU/Linux, Mac OS X et +Cygwin. Les sources inclus dans la distribution devraient être compilables sur des plate-formes pour lesquelles +nous ne fournissons pas d’exécutables. +

Concernant Windows, XP et les versions ultérieures sont supportés. Windows 2000 devrait probablement +fonctionner (en bonne partie). Il n’y a pas d’exécutables spécifiques 64-bit pour Windows, mais les exécutables +32-bit devraient focntionner sur les systèmes 64-bit. +

Consulter la section 2.1 pour des solutions alternatives sous Windows et Mac OS X. +

+

1.3 Installation élémentaire de TEX Live

+

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

L’installateur du DVD vous permet d’installer sur votre disque dur. Il n’est plus possible de lancer TEX Live +directement depuis le DVD TEX Collection (ou une image .iso), mais vous pouvez créer une installation +portable, par exemple sur une clé USB (voir section 5). +

La procédure d’installation est décrite en détail dans les sections suivantes (page 12), mais voici de quoi +commencer rapidement. +

+

+

1.4 Remarques sur la sécurité

+

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

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

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

+

1.5 Obtenir de l’aide

+

La communauté TEX est active et conviviale ; la plupart des questions finissent par obtenir une réponse. Par +contre, le support est informel, assuré par des volontaires et des lecteurs occasionnels, aussi est-il +particulièrement important que vous fassiez votre propre travail de recherche avant de poser une question (si +vous préférez un support commercial, vous pouvez renoncer à TEX Live et acheter un système payant ; voir +une liste à http://tug.org/interest.html#vendors). +

Voici une liste de ressources, classées selon l’ordre dans lequel nous recommandons de les utiliser : +

+

+Getting Started
– pour ceux qui débutent en TEX, la page web http://tug.org/begin.html + contient une courte description du système. +
+FAQ TEX
– la FAQ TEX est un vaste recueil de réponses à toutes sortes de questions, + de la plus élémentaire à la plus complexe. Elle est enregistrée sur le DVD dans + texmf-dist/doc/generic/FAQ-en/html/index.html et elle est disponible sur Internet à l’adresse + http://www.tex.ac.uk/faq. Merci de consulter cette FAQ avant toute question. + + +
+Catalogue TEX
– si vous recherchez une extension, une fonte, un programme, etc., le mieux est de + consulter le catalogue TEX ici : http://mirror.ctan.org/help/Catalogue/. +
+Ressources TEX sur le Web
– la page web http://tug.org/interest.html propose beaucoup de + liens relatifs à TEX, en particulier concernant des livres, manuels et articles portant sur tous les + aspects du système. +
+Archives des forums d’aide
– les principaux forums dédiés au support de TEX sont les groupes de + nouvelles Usenet news:comp.text.tex (en anglais) et news:fr.comp.text.tex (en français) ainsi + que les listes de diffusion texhax@tug.org (en anglais) et gut@ens.fr (en français). Les archives + correspondantes contiennent des milliers de questions et réponses déjà traitées et permettent + une recherche fructueuse. Voir http://groups.google.com/groups?group=fr.comp.text.tex + et http://tug.org/mail-archives/texhax, respectivement. Une question posée sur un moteur + de recherche, tel que http://google.com, peut aussi fournir des réponses pertinentes. +
+Poster une question
– si vous ne trouvez pas de réponse, vous pouvez poser la question (en français) + sur fr.comp.text.tex via Google ou votre lecteur de nouvelles, ou encore par messagerie à + texhax@tug.org (en anglais). Mais avant de le faire, merci de lire l’introduction de la FAQ + donnant les conseils sur la façon de rédiger la question pour avoir des chances d’obtenir une + réponse pertinente : http://www.tex.ac.uk/cgi-bin/texfaq2html?label=askquestion. Pour + de l’aide en anglais, vous pouvez également vous tourner vers le site LATEX Community : + http://www.latex-community.org/ et son forum http://www.latex-community.org/forum/, + ainsi que le site TEX StackExchange à http://tex.stackexchange.com/. +
+Support de TEX Live
– si vous voulez faire un rapport d’anomalie, émettre des suggestions ou + des commentaires sur la distribution TEX Live, son installation ou sa documentation, utilisez + la liste de diffusion tex-live@tug.org. Mais attention, si la question concerne l’utilisation d’un + programme particulier inclus dans TEX Live, il vaut mieux que vous vous adressiez directement + à la personne ou à la liste de diffusion qui maintient le programme. Il suffit souvent d’ajouter + l’option --help lors de l’exécution du programme pour trouver à qui adresser le rapport. +
+

L’autre aspect du sujet concerne l’aide à apporter aux personnes soumettant des questions. Les forums +comp.text.tex, fr.comp.text.tex ainsi que les listes de diffusion texhax et gut sont ouverts à tous, aussi +n’hésitez pas à vous y joindre, à commencer la lecture et à fournir de l’aide là où cela vous est +possible. +

+

2 Structure de TEX Collection

+

Nous décrivons ici le contenu de TEX Collection qui est un sur-ensemble de TEX Live. +

+

2.1 TEX Collection : TEX Live, proTEXt, MacTEX

+

Le DVD TEX Collection contient les éléments suivants : +

+

+TEX Live
– un système TEX complet à installer. Sa page web est http://tug.org/texlive/. +
+MacTEX
– un système TEX pour Mac OS X, qui ajoute à TEX Live un installateur spécifique + à Mac OS X et quelques applications propres au système Mac. Le site de MacTEX est + http://tug.org/mactex/. + + +
+proTEXt
– une extension du système MiKTEX pour Windows qui en facilite l’installation et ajoute + quelques outils. Cette distribution est totalement indépendante de TEX Live, elle nécessite un + mode d’installation spécifique. Le site de proTEXt est http://tug.org/protext. +
+CTAN
– une image du site d’archives CTAN. +
+texmf-extra
– un répertoire contenant quelques extensions supplémentaires. +
+

Les droits d’utilisation des fichiers présents dans CTAN, proTEXt et texmf-extra diffèrent de ceux de TEX +Live, pensez à lire les licences si vous envisagez de modifier ou de redistribuer certains de ces +fichiers. +

+

2.2 Répertoires situés à la racine de TEX Live

+

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

+

+ bin
+

– programmes de la famille TEX, rangés dans des sous-répertoires selon les plates-formes. +

+ readme-*.dir
+

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

+ source
+

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

+ texmf
+

– répertoire contenant les programmes et leur documentation ; ne contient ni les formats ni les + extensions (la variable TEXMFMAIN de la section suivante pointe sur ce répertoire). +

+ texmf-dist
+

– répertoire principal où se trouvent les extensions, les fontes, etc., avec leur documentation (la + variable TEXMFDIST de la section suivante pointe sur ce répertoire). +

+ tlpkg
+

– scripts et programmes d’installation, et éléments spécifiques pour Windows.

+

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

Concernant la documentation, le fichier doc.html, qui contient une liste exhaustive de liens vers les fichiers de +documentation, peut être bien utile. La documentation des programmes (manuels, pages de man, fichiers info) +se trouve dans texmf/doc. Celle des autres paquets et des formats est dans texmf-dist/doc. +Vous pouvez utiliser le programme texdoc pour trouver chaque fichier de documentation, où qu’il +soit. +

La documentation de TEX Live proprement dite (que vous consultez actuellement) est disponible dans le +répertoire texmf/doc/texlive en plusieurs langues, +

+

+

2.3 Description des arborescences « texmf » de TEX Live

+

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

Notez bien que toutes ces arborescences, y compris les arborescences personnelles, doivent suivre la structure +standard des répertoires de TEX (TDS : http://tug.org/tds) avec sa pléthore de sous-répertoires, +ou les fichiers ne seront pas pris en compte. La section 3.5.2 page 41 donne plus de détails à ce +sujet. +

+

+ TEXMFMAIN
+

– contient les éléments essentiels du système, comme les fichiers de configuration, des scripts + utilitaires, et la documentation des programmes. +

+ TEXMFDIST
+

– contient les fichiers de macros (Plain, LATEX, ConTEXt, etc.), les fontes, etc. Rien ne devrait + être ajouté, modifié ni supprimé manuellement dans cette arborescence. +

+ TEXMFLOCAL
+

– c’est là que l’administrateur de la machine doit placer les classes et extensions locales, les fontes + non disponibles dans TEX Live, etc. +

+ TEXMFHOME
+

– contient les fichiers personnels (extensions, classes, fontes) de l’utilisateur ; ce répertoire est + installé automatiquement dans le répertoire personnel de l’utilisateur. +

+ TEXMFCONFIG
+

– c’est là que les scripts texconfig updmap et fmtutil recherchent leurs fichiers de configuration + (personnelles) en priorité. +

+ TEXMFSYSCONFIG
+

– c’est là que les scripts texconfig-sys, updmap-sys et fmtutil-sys recherchent leurs fichiers de + configuration (globaux) en priorité. +

+ TEXMFVAR
+

– c’est là que les scripts texconfig, updmap et fmtutil rangent les (versions personnelles de) données + générées, comme les formats et les fichiers .map. +

+ TEXMFSYSVAR
+

– c’est là que les scripts texconfig-sys, updmap-sys et fmtutil-sys rangent les (versions globales des) + données générées, comme les formats et les fichiers .map. + + +

+ TEXMFCACHE
+

– arborescence(s) utilisée(s) par ConTEXt MkIV pour stocker des (versions de cache de) fichiers + de travails.

+

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

+racine multi-utilisateur
(par exemple /usr/local/texlive, D:\texlive,...) qui contient éventuellement + plusieurs distributions : +
+ 2011
+

– la distribution précédente, +

+ 2012
+

– la distribution actuelle, +

+ bin
+

  +

+ i386-linux
+

– exécutables Linux, +

+ ...
+

+

+ universal-darwin
+

– exécutables Mac OS X, +

+ win32
+

– exécutables Windows,

+
+ texmf       
+

– correspond à TEXMFMAIN, +

+ texmf-dist  
+

– correspond à TEXMFDIST, +

+ texmf-var   
+

– correspond à TEXMFSYSVAR, +

+ texmf-config
+

– correspond à TEXMFSYSCONFIG,

+
+ texmf-local
+

– correspond à TEXMFLOCAL, normalement commun à plusieurs distributions TEX Live (2007, 2008, + etc.),

+
+répertoire personnel de l’utilisateur
$HOME ou %USERPROFILE% : +
+ .texlive2011
+

– fichiers propres à l’utilisateur générés automatiquement par la distribution TEX Live + précédente, +

+ .texlive2012
+

– fichiers propres à l’utilisateur générés automatiquement par la distribution TEX Live + actuelle, + + +

+ texmf-var   
+

– correspond à TEXMFVAR, TEXMFCACHE, +

+ texmf-config
+

– correspond à TEXMFCONFIG,

+
+ texmf
+

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

+
+

+

2.4 Les extensions de TEX

+

Le programme TEX original de Knuth est figé, sauf corrections de bugs, rares. C’est toujours le programme +tex présent dans TEX Live, et ceci ne changera pas autant dans un futur prévisible. TEX Live contient +plusieurs variantes étendues de TEX. +

+

+e-TEX
ajoute un jeu de nouvelles primitives et les extensions TEX--XE T pour l’écriture de droite à + gauche ; e-TEX est, en mode normal, 100% compatible avec TEX standard. Pour plus de détails + consulter le fichier texmf-dist/doc/etex/base/etex_man.pdf du DVD. +
+pdfTEX
inclut les extensions e-TEX et produit, au choix, des fichiers au format Acrobat PDF + ou au format DVI ; il inclut aussi de nombreuses extensions indépendantes du format + de sortie. C’est le moteur de base sur lequel sont construits tous les formats autres + que plainTEX, comme etex, latex et pdflatex. Son site web est http://www.pdftex.org/. + Le manuel d’utilisation se trouve sur le DVD dans texmf/doc/pdftex/manual/. Le fichier + texmf/doc/pdftex/pdftex/manual/samplepdf/samplepdf.tex donne des exemples d’utilisation. +
+LuaTEX
est le successeur de pdfTEX avec lequel il reste en grande partie (mais pas totalement) + compatible. Ses possibilités sont aussi censées être un sur-ensemble de celles d’Aleph (voir + ci-dessous), bien qu’il ne soit pas prévu pour être techniquement compatible. LuaTEX inclut le + langage de script Lua (voir http://www.lua.org/) qui apporte des solutions élégantes à beaucoup + de problèmes épineux en TEX pur. La commande texlua fonctionne comme un interpréteur Lua + indépendant, et est déjà utilisée en tant que telle dans TEX Live. Voir http://www.luatex.org/ + et texmf-dist/doc/luatex/luatexref-t.pdf. +
+XeTEX
ajoute la possibilité d’utiliser en entrée le codage Unicode et en sortie les fontes + OpenType et les fontes système de la machine, ceci grâce à des bibliothèques externes : voir + http://tug.org/xetex/. +
+Omega (Omega)
fonctionne en utilisant Unicode et des caractères 16 bits, ce qui lui permet de + travailler directement et simultanément avec presque toutes les écritures du monde. L’extension + supporte aussi le chargement dynamique d’OTP (Omega Translation Processes) qui permet à + l’utilisateur d’appliquer sur des flux d’entrée quelconques des transformations complexes qu’il + aura lui-même définies. TEX Live n’inclut plus Omega en tant que programme séparé ; seul Alpeh + est fourni. +
+Aleph
combine les fonctionnalités de Omega et de e-TEX ; voir texmf-dist/doc/aleph/base. +
+ + +

+

2.5 Quelques autres programmes intéressants dans TEX Live

+

Voici quelques autres programmes couramment utilisés et présents dans TEX Live : +

+

+ bibtex, bibtex8
+

– traitement des bibliographies. +

+ makeindex, xindy
+

– traitement des index. +

+ dvips
+

– conversion DVI vers PostScript. +

+ xdvi
+

– visualisation DVI pour le système X Window. +

+ dvilj
+

– pilote DVI pour les imprimantes HP LaserJet. +

+ dviconcat, dviselect
+

– couper/Coller de pages à partir de fichiers DVI. +

+ dvipdfmx
+

– conversion DVI vers PDF, une alternative à pdfTEX (mentionné ci-dessus) pour produire des + fichiers PDF. +

+ psselect, psnup, ...
+

– utilitaires PostScript. +

+ pdfjam, pdfjoin, ...
+

– utilitaires PDF. +

+ texexec, texmfstart
+

– processeurs ConTEXt et PDF. +

+ tex4ht
+

– conversion TEX vers HTML et XML. +

+

+

2.6 Fontes incluses dans TEX Live

+

La distribution TEX Live contient un grand nombre de fontes vectorielles de haute qualité : voir +http://tug.org/fonts et texmf-dist/doc/fonts/free-math-fonts-survey. +

+

3 Installation

+ + +

+

3.1 Démarrage de l’installation

+

La première chose à faire est de récupérer le DVD TEX Collection ou de télécharger le programme +d’installation par le réseau. Le programme d’installation s’appelle install-tl pour Unix et install-tl.bat +pour Windows. La page http://tug.org/texlive/acquire.html donne plus d’informations sur les différentes +façons d’obtenir le logiciel. +

+

+Installeur réseau
– à télécharger sur CTAN + dans systems/texlive/tlnet ; l’url http://mirror.ctan.org/systems/texlive/tlnet vous + redirigera automatiquement vers le serveur d’archive le plus proche de chez vous. Deux versions + sont disponibles, install-tl.zip utilisable sous Unix et Windows, et install-unx.tar.gz pour + Unix seulement (y compris Mac OS X). Après décompression de l’un de ces deux fichiers, les + scripts install-tl et install-tl.bat se trouveront dans le sous-répertoire install-tl. +
+DVD TEX Collection
– aller dans son répertoire texlive. Sous Windows, l’installation démarre + en principe automatiquement quand vous insérerez le DVD, sinon, il faudra exécuter le + script d’installation install-tl ou install-tl.bat. Le DVD TEX Collection est distribué + gratuitement aux membres des groupes d’utilisateurs de TEX (Gutenberg par exemple en France, + voir la liste des groupes sur http://tug.org/usergroups.html). Il est également possible de + l’acheter séparément (http://tug.org/store) ou de graver une image ISO téléchargée, voire de + la monter directement, sur la plupart des systèmes. Après avoir installé depuis le DVD, si vous + voulez accéder aux mises à jour en continu depuis Internet, consultez la section 3.4.3.
+

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

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

+

3.1.1 Installation sous Unix
+

Dans ce qui suit l’invite du shell est notée > ; les commandes de l’utilisateur sont en gras. Le programme +install-tl est un script Perl ; la façon la plus simple de le démarrer sur un système Unix est la suivante. +

+

+> cd /chemin/de/installateur +
> perl install-tl +
+
(Vous pouvez aussi invoquer perl /chemin/de/installateur/install-tl ou ./install-tl si le +fichier est toujours exécutable, etc. ; nous ne répéterons plus toutes ces variantes.) Il est possible +que vous deviez agrandir la fenêtre de votre terminal pour voir le texte complet de l’installateur +(figure 1). +

Pour travailler en mode graphique expert (figure 2 – attention, le module Perl/TK doit être disponible, avec le +support de XFT, ce qui est en général le cas sous GNU/Linux, mais pas nécessairement sous d’autres +systèmes) :

+

+> cd /chemin/de/installeur +
> ./install-tl -gui + + +
+
+

La liste complète des options est donnée par

+

+> perl install-tl -help +
+
+

Attention : le matériel installé doit normalement être accessible à tous les utilisateurs de la machine ; si celui +qui installe n’est pas root, il devra s’assurer que son umask est adapté, par exemple umask 022 ou umask 002. +Consulter la documentation système pour plus de précisions. +

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

+

3.1.2 Installation sous Mac OS X
+

Une distribution spécifique, MacTEX (http://tug.org/mactex), a été mise au point pour Mac OS X. Nous +recommandons d’utiliser son installateur natif, plutôt que d’installer la distribution TEX Live en suivant la +procédure indiquée pour Unix. En effet, MacTEX comprend des ajustements spécifiques pour le système +Mac OS X et facilite la cohabitation entre plusieurs distributions TEX (MacTEX, Fink, MacPorts, +etc.). +

MacTEX est fortement basée sur TEX Live et les arborescences principales sont en tous points identiques. +Quelques répertoires contenant de la documentation et des applications spécifiques au Mac sont +ajoutés. +

+

3.1.3 Installation sous Windows
+

Si vous utilisez l’installeur réseau ou si l’insertion du DVD ne lance pas l’installation automatiquement, +double-cliquez sur install-tl.bat. Pour disposer de plus d’options, par exemple pour sélectionner +des collections de paquets spécifiques au lieu de faire une installation complète, utilisez plutôt +install-tl-advanced.bat. +

Il est également possible de travailler en ligne de commande ; dans ce qui suit l’invite du shell +est notée >, les commandes de l’utilisateur sont notées en gras. Voici les commandes à lancer : +

+

+> install-tl +
+
à condition d’être dans le répertoire du script d’installation, sinon
+

+> D:\texlive\install-tl +
+
D : désigne le lecteur de DVD où se trouve la collection TEX. La figure 3 montre l’installateur en mode +magique, qui est le mode par défaut pour Windows. +

Pour travailler en mode texte :

+ + +

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

+> install-tl -help +
+
+


+ + + + + +
  Installing TeX Live 2012 from: ...
  Platform: i386-linux => ’Intel x86 with GNU/Linux’
  Distribution: inst (compressed) +
  ...
   Detected platform: Intel x86 with GNU/Linux
  
   <B> platforms: 1 out of 19
  
   <S> installation scheme (scheme-full) +
       84 collections out of 85, disk space required: 3091 MB
  
   Customizing installation scheme: +
     <C> standard collections
     <L> language collections
  
   <D> directories:
     TEXDIR (the main TeX directory): +
       /usr/local/texlive/2012
     ...
  
   <O> options:
     [ ] use letter size instead of A4 by default
     ...
   +
   <V> set up for portable installation
  
  Actions:
   <I> start installation to hard disk
   <H> help
   <Q> quit
+
Figure 1: Écran principal de l’installateur en mode texte (GNU/Linux)
+ + +


+


+ + + + + + +

pict +

Figure 2: Installateur graphique en mode expert (GNU/Linux)
+ + +


+


+ + + + + + +

pict +

Figure 3: Installateur graphique en mode expert (Windows)
+ + +


+

+

3.1.4 Installation sous Cygwin
+

L’installateur TEX Live fonctionne uniquement sous Cygwin 1.7. Avant de commencer l’installation, utilisez le +programme setup.exe de Cygwin pour installer les paquets perl et wget si ce n’est déjà fait. Il est également +recommandé d’installer les paquets suivants : +

+

+

3.1.5 Installation en mode texte
+

La figure 1 présente l’écran principal de configuration en mode texte sous Unix/Linux, où c’est le mode par +défaut. +

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

L’interface est volontairement rudimentaire afin de permettre son utilisation sur le plus grand nombre possible +de systèmes même avec des versions très dépouillées de Perl. +

+

3.1.6 Installation en mode graphique-expert
+

La figure 2 page 20 présente l’écran principal de configuration en mode graphique sous GNU/Linux. À part +l’utilisation de boutons et menus, cet installateur ne diffère pas beaucoup de l’installateur en mode +texte. +

Ce mode peut être demandé explicitement avec

+

+> install-tl -gui=perltk +
+
+

+

3.1.7 L’installation en mode magique
+

Sous Windows, l’installateur démarre par défaut dans le mode le plus simple que nous avons pu concevoir, le +mode « magique » (figure 3. Dans ce mode, tout est installé et presque aucune question n’est posée. +Par contre, si vous souhaitez personnaliser votre installation, vous devriez utiliser un des autres +modes. +

Ce mode peut être demandé explicitement avec

+ + +

+> install-tl -gui=wizard +
+
+

+

3.2 Choix des options d’installation

+

Les options proposées sont censées être assez explicites, voici cependant quelques précisions. +

+

3.2.1 Choix des binaires (Unix seulement)
+


+ + + + + +
  Available platforms:
  =============================================================================== +
     a [ ] alpha-linux      DEC Alpha with GNU/Linux
     b [ ] amd64-freebsd    x86_64 with FreeBSD +
     c [ ] amd64-kfreebsd   x86_64 with GNU/FreeBSD
     d [ ] i386-cygwin      Intel x86 with Cygwin +
     e [ ] i386-freebsd     Intel x86 with FreeBSD
     f [ ] i386-kfreebsd    Intel x86 with GNU/FreeBSD +
     g [X] i386-linux       Intel x86 with GNU/Linux
     h [ ] i386-netbsd      Intel x86 with NetBSD +
     i [ ] i386-solaris     Intel x86 with Solaris
     j [ ] mips-irix        SGI IRIX
     k [ ] powerpc-aix      PowerPC with AIX +
     l [ ] powerpc-linux    PowerPC with GNU/Linux
     m [ ] sparc-linux      Sparc with GNU/Linux +
     o [ ] sparc-solaris    Sparc with Solaris
     p [ ] universal-darwin universal binaries for MacOSX/Darwin +
     s [ ] win32            Windows
     t [ ] x86_64-darwin    x86_64 with MacOSX/Darwin +
     u [ ] x86_64-linux     x86_64 with GNU/Linux
     v [ ] x86_64-solaris   x86_64 with Solaris
+
Figure 4: Menu pour le choix des binaires
+ + +


+

La figure 4 présente les choix de binaires possibles en mode texte. Seuls les binaires correspondant à +l’architecture détectée seront installés par défaut. Rien n’empêche d’en sélectionner d’autres si nécessaire, +ce qui peut être intéressant dans le cas de machines en réseau ou sur des systèmes en « double +boot ». +

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


+ + + + + +
  Select scheme:
  ===============================================================================
   a [X] full scheme (everything) +
   b [ ] medium scheme (small + more packages and languages)
   c [ ] small scheme (basic + xetex, metapost, a few languages) +
   d [ ] basic scheme (plain and latex)
   e [ ] minimal scheme (plain only)
   f [ ] ConTeXt scheme
   g [ ] GUST TeX Live scheme +
   h [ ] teTeX scheme (more than medium, but nowhere near full)
   i [ ] XML scheme
   j [ ] custom selection of collections
+
Figure 5: Menu « Scheme »
+ + +


+

Dans le menu « Scheme » (voir figure 5) on choisit un schéma général de configuration qui détermine un +ensemble de collections à installer. Le schéma par défaut (full) consiste à tout installer, ce qui est +recommandé. Vous pouvez également choisir basic pour un petit système, minimal pour des tests +uniquement, medium ou teTeX pour quelque chose d’intermédiaire. Il existe aussi des schémas spécialisés ou +spécifiques à un pays. +


+ + + + + + +

pict +

Figure 6: Menu « Collections » (Linux)
+ + +


+

Une fois choisi le schéma (scheme) général, il est possible d’ajouter ou de supprimer des composants, appelés +ici collections. Il y a deux types de collections : les « Standard Collections » qui concernent les fontes, les +extensions, les formats, etc. (voir figure 6) et les « Language Collections » qui permettent de préciser la liste +des langues qui seront utilisables sur le système (indispensable !). Attention, si vous travaillez en mode texte, +dans ces menus la casse des lettres est importante. En mode graphique, il suffit de cocher ou de décocher les +cases en cliquant. +

Il est possible de raffiner encore les choix mais il faudra alors utiliser le gestionnaire de paquets TeX Live +(tlmgr) ultérieurement, voir la section 6. +

3.2.3 Répertoires d’installation
+

L’arrangement par défaut des différents répertoire est donné à la section 2.3, page 9. La racine +de l’installation principale, TEXDIR, vaut par défaut /usr/local/texlive/2012 sous Unix et +%SystemDrive%\texlive\2012 sous Windows. +

Il peut être nécessaire de changer la valeur de TEXDIR lorsque celui qui procède à l’installation n’a pas les +droits d’écriture sur le répertoire TEXDIR (l’installation n’est pas réservée au superutilisateur root ou +« Administrateur », il suffit d’avoir les droits en écriture sur le répertoire TEXDIR). +

Un autre choix raisonnable est d’installer TEX Live dans votre répertoire personnel, surtout si vous prévoyez +d’en être le seul utilisateur. Vous pouvez utiliser ~ à cet effet, par exemple ~/texlive/2012. +

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

Le répertoire TEXMFHOME est destiné à regrouper les répertoires de macros personnelles. Par défaut, son +emplacement est ~/texmf ; ici, le ~ est préservé dans les fichiers de configurations crées, de façon à être +remplacé dynamiquement pour chaque utilisateur de TEX, par la valeur des variables d’environnement \$HOME +sous Unix et %USERPROFILE% sous Windows. Attention, comme tous les autres répertoires, TEXMFHOME doit +respecter la structure TDS ou les fichier ne seront pas trouvés. +

Enfin, TEXMFVAR est l’emplacement où sont stockées les fichiers de cache spécifiques à chaque +utilisateur. TEXMFCACHE est utilisé par ConTEXt MkIV pour le même but (voir la section 3.5.1 +page 40). +

+

3.2.4 Options
+


+ + + + + +
  Options setup:
  =============================================================================== +
   <P> use letter size instead of A4 by default: [ ]
   <E> execution of restricted list of programs: [X] +
   <F> create format files:                      [X]
   <D> install font/macro doc tree:              [X] +
   <S> install font/macro source tree:           [X]
   <L> create symlinks in standard directories:  [ ]
              binaries to: +
              manpages to:
                  info to:
   <Y> after installation, get package updates from CTAN: [X]
+
Figure 7: menu « Options » (Unix)
+ + +


+

La figure 7 présente le menu « Options » en mode texte, sur lesquelles voici quelques précisions. +

+use letter size instead of A4 by default
– la taille du papier par défaut pour des outils comme + dvips, pdftex, xdvi. Cette option n’a pas d’influence sur les tailles par défaut utilisées par des jeux + de macros comme les classes standard de LATEX ou ses modules, qui seront prioritaires. Dans + tous les cas, il est possible et recommandé de préciser la taille de papier souhaitée au sein de + chaque document. +
+execution of restricted list of programs
– à compter de TEX Live 2010, l’exécutions de certains + programmes externes depuis TEX est autorisée par défaut. La (très courte) liste de programmes + autorisés se trouve dans le fichier texmf.cnf. Voir la section 10.1.7 pour plus de détails. +
+create format files
– création de tous les formats à l’installation. Bien que cette opération prenne un + peu de temps, il est conseillé de ne pas la supprimer, sinon les formats seront créés au coup par + coup dans les répertoires personnels des utilisateurs (sous TEXMFVAR). Les formats personnels ainsi + créés ne bénéficieront pas des mises à jour éventuelles effectuées ultérieurement sur l’installation + TEX Live, ce qui peut engendrer des incompatibilités. +
+install font/macro . . . tree
– ces options permettent de ne pas installer les fichiers de documentation + et les sources présents dans la plupart des paquets. Il est recommandé de conserver la valeur par + défaut. +
+create symlinks in standard directories
– cette option (pour Unix seulement) permet d’éviter + d’avoir à modifier les variables d’environnement PATH, MANPATH et INFOPATH après l’installation. + Elle nécessite les droits d’écriture dans les répertoires cibles. Il est fortement recommandé de ne + pas utiliser cette option si un système TEX est déjà installé par votre système d’exploitation. + Elle est destinée uniquement à permettre l’accès à TEX depuis des répertoires standard comme + /usr/local/bin sur les systèmes où aucune autre installation TEX n’est présente. +
+after installation . . . CTAN
– lors d’une installation depuis le DVD, cette option est activés par + défaut, car on souhaite généralement bénéficier des mises à jour de paquets depuis la partie du + CTAN les hébergeant, qui est mise à jour toute l’année. La seule raison probable de la désactiver + est si vous installez seulement un sous-ensemble de TEX Live depuis le DVD et prévoyez de la + compléter ultérieurement, toujours depuis le DVD. Dans tous les cas, le dépôt de paquets utilisé + par l’installateur et celui utilisé après installation peuvent être choisis de façon indépendante ; + voir les sections 3.3.1 et 3.4.3.
+

Lorsque vous êtes satisfait des réglages faits, il vous reste à taper I pour lancer le processus d’installation. +Lorsque celui-ci sera terminé, sautez à la section 3.4 pour voir s’il y a d’autres choses à faire. +

3.3 Options de install-tl en ligne de commande

+

Tapez

+

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

+

+ -gui
+ + +

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

+ -no-gui
+

 : exécution en mode texte, même sous Windows. +

+ -lang LL
+

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

+

+ -in-place
+

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

+ -portable
+

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

+ -profile fichier
+

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

+ -repository url-ou-répertoire
+

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

+

+

3.3.1 L’option -repository
+

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

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

Par exemple, vous pouvez choisir un miroir du CTAN en particulier avec un valeur comme +http://ctan.example.org/tex-archive/systems/texlive/tlnet/, en substituant le nom d’un vrai miroir +et le chemine ver l’archive TEX spécifique à la place de ctan.example.org. La liste des miroirs du CTAN est +disponible sur http://ctan.org/mirrors. +

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

+

3.4 Étapes post-installation

+

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

+

3.4.1 Variables d’environnement sous Unix
+

Si vous avez choisi de créer des liens symboliques dans les répertoires standard (voir la section 3.2.4), alors il +est inutile de modifier vos variables d’environnement. Sinon, sur les systèmes Unix, le répertoire contenant les +binaires pour votre plateforme doit être ajouté au PATH. (Sous Windows, l’installateur s’en occupe, il n’y a rien +à faire.) +

À chaque architecture correspond un sous-répertoire de TEXDIR/bin, voir la liste à la figure 4 +27. +

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

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

+

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

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

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

Si vous avez déjà des réglages concernant ces variables dans vos fichiers de configurations, il suffit bien sûr d’y +rajouter les répertoires concernant TEX Live. +

+

3.4.2 Variables d’environnement : configuration multi-utilisateur
+

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

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

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

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

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

+

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

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

+

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

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

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

+

3.5 Configuration des fontes pour XeTEX et LuaTEX

+

XeTEX et LuaTEX peuvent utiliser toutes les polices installées au niveau du système et pas seulement +celles des arborescences TEX. Pour cela, ils utilisent des méthodes différentes mais pas tout à fait +indépendantes. +

Sous Windows, les fontes livrées avec TEX Live sont automatiquement rendues utilisables par XeTEX, mais si +vous avez installé le paquet xetex sur un système de type Unix, vous avez besoin de le configurer un peu pour +que XeTEX puisse trouver les fontes installées par TEX Live par leur nom sans être obligé d’utiliser le nom du +fichier. +

Pour faciliter ce réglage, lorsque le paquet xetex est installé, un fichier de configuration adéquat est créé : +TEXMFSYSVAR/fonts/conf/texlive-fontconfig.conf. +

Pour permettre à votre système l’accès aux polices TEX Live, si vous avez les privilèges suffisants, vous +pouvez procéder ainsi : +

    +
  1. Copiez le fichier texlive-fontconfig.conf dans /etc/fonts/conf.d/09-texlive.conf. +
  2. +
  3. Exécutez fc-cache -fsv.
+

Si vous n’avez pas les privilèges suffisants pour utiliser la méthode ci-dessus, ou si vous préférez ne rendre les +polices disponibles que pour un utilisateur, vous pouvez procéder comme suit. +

    +
  1. Copiez le fichier texlive-fontconfig.conf vers ~/.fonts.conf, où ~ représente votre répertoire + personnel. +
  2. +
  3. Exécutez fc-cache -fv.
+

Vous pouvez utiliser fc-list pour voir les noms des polices du système. L’incantation fc-list : +family style file spacing (avec ces arguments tels quels) donne en général des informations +utiles. +

+

3.5.1 ConTEXt Mark IV
+

La « vieille » version de ConTEXt (Mark II) ainsi que la « nouvelle » version (Mark IV) devraient fonctionner +directement après l’installation de TEX Live et ne réclamer aucune action particulière tant que vous n’utilisez +que tlmgr pour les mises à jour. + + +

Cependant, comme ConTEXt MkIV n’utilise pas la bibliothèque kpathsea, il faudra mettre à jour +manuellement le cache de fichiers de ConTEXt si jamais vous installez des nouveaux fichiers manuellement +(c’est-à-dire sans utiliser tlmgr). Pour cela, exécutez +

  context --generate
+

après chaque installation manuelle. Les fichiers résultants sont stockés dans TEXMFCACHE, dont la valeur par +défaut sous TEX Live est TEXMFSYSVAR ;TEXMFVAR. +

ConTEXt MkIV lira les fichiers de toutes les arborescences mentionnées dans TEXMFCACHE et les écrira dans le +premier de ces répertoire accessible en écriture. Lors de la lecture, les dernières informations lues sont prises en +compte de façon prioritaire par rapport à celles lues précédemment, dans le cas où certaines données de cache +seraient dupliquées. +

Pour plus d’informations, voir http://wiki.contextgarden.net/Running_Mark_IV. +

+

3.5.2 Ajout de fichiers locaux ou personnels
+

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

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

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

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

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

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

+

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

+

3.5.3 Ajout de fontes externes à TEX Live
+

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

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

Si vous ne pouvez pas y couper, le document essayant au mieux de décrire la procédure est +http://tug.org/fonts/fontinstall.html. Si vous maintenez vos propres associations de fontes (fichiers +.map) localement, la commande tlmgr generate updmap pourrait éventuellement vous être utile ; consultez la +documentation de tlmgr pour les détails. +

+

3.6 Tester l’installation

+

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

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

+

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

    + > tex --version +
    TeX 3.1415926 (TeX Live ...) +
    kpathsea version 6.0.1 +
    Copyright ... D.E. Knuth. +
    ...
    +
    +

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

  2. +
  3. Traiter un fichier LATEX simple : +
    +

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

    + > xdvi sample2e.dvi    # Unix +
    > dviout sample2e.dvi  # Windows
    +
    Une nouvelle fenêtre doit s’ouvrir et montrer un joli document expliquant les bases de LATEX + (document dont la lecture attentive est recommandée si vous êtes débutant !). Vous devez travailler sous + X pour que xdvi fonctionne. Dans le cas contraire, votre variable d’environnement DISPLAY ne sera pas + correcte et vous obtiendrez l’erreur « Can’t open display ». +
  6. +
  7. Créer un fichier PostScript pour l’imprimer ou l’afficher : +
    +

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

    + > pdflatex sample2e.tex
    +
    +
  10. +
  11. Prévisualiser le fichier PDF : +
    +

    + > gv sample2e.pdf +
    ou +
    > xpdf sample2e.pdf
    +
    +

    Ni gv ni xpdf ne sont inclus dans TEX Live, aussi devez-vous les installer séparément si ce n’est déjà fait. + Voir respectivement http://www.gnu.org/software/gv et http://www.foolabs.com/xpdf. Il y a + bien d’autres lecteurs de fichiers PDF ; pour Windows, nous recommandons Sumatra PDF + (http://blog.kowalczyk.info/software/sumatrapdf). +

  12. +
  13. Autres fichiers de tests utiles en plus de sample2e.tex : +

    +

    + small2e.tex
    +

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

    + testpage.tex
    +

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

    + nfssfont.tex
    +

    imprime des tables des fontes et des tests. +

    + testfont.tex
    +

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

    + story.tex
    +

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

    +
  14. +
  15. Si vous avez installé le paquet xetex, vous pouvez vérifier s’il a bien accès aux polices du système ainsi +
    +

    + > xetex opentype-info.tex +
    This is XeTeX, Version 3.1415926... +
    ... +
    Output written on opentype-info.pdf (1 page). +
    Transcript written on opentype-info.log.
    +
    (De même pour luatex.) +

    Si vous obtenez un message d’erreur disant « « Invalid fontname ‘Latin Modern Roman/ICU’... » », + alors vous devez revoir la configuration de votre système pour que XeTEX puisse accéder aux polices + livrées avec TEX Live comme indiqué en section 3.5. +

+

+

3.7 Liens vers d’autres logiciels téléchargeables

+

Si vous êtes débutant ou si vous avez besoin d’aide pour réaliser des documents TEX ou LATEX, n’hésitez +pas à consulter http://tug.org/begin.html. +

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

+Ghostscript
http://www.cs.wisc.edu/~ghost/ +
+Perl
http://www.perl.org/ avec des paquets supplémentaires du CPAN, http://www.cpan.org/ +
+ImageMagick
http://www.imagemagick.com pour les conversions entre formats graphiques, + notamment. +
+NetPBM
http://netpbm.sourceforge.net/ également pour les graphiques. +
+Éditeurs orientés TEX
Le choix est large, et est en bonne partie une question de goût personnel. Voici + une sélection classée par ordre alphabétique (dont certains ne sont disponibles que sous + Windows). + +
+

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

+

4 Installations spécialisées

+

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

+

4.1 Installation partagée entre plusieurs utilisateurs ou machines

+

TEX Live a été conçue pour pouvoir être partagée par plusieurs utilisateurs sur le même système et/ou +différents systèmes sur un réseau. Avec la disposition standard des répertoires, aucun chemin n’est codé en +dur : les emplacements des fichiers dont TEX Live a besoin sont trouvés automatiquement à partir des +emplacements des programmes. Vous pouvez le constater dans le fichier de configuration principal +\$TEXMFMAIN/web2c/texmf.cnf, qui contient des lignes comme +

  TEXMFMAIN = $SELFAUTOPARENT/texmf
  ...
  TEXMFLOCAL = $SELFAUTOPARENT/../texmf-local
+

Ceci signifie qu’il suffit aux utilisateurs d’ajouter à leur PATH le chemin des exécutables pour leurs +plate-formes, pour obtenir une configuration qui marche. +

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

Pour Windows, un exemple de script d’installation nommé w32client peut être téléchargé sur +http://tug.org/texlive/w32client.html. Il installe les réglages et les raccourcis pour utiliser un système +TEX Live installé sur un réseau local. Il déclare aussi un désinstallateur w32client, disponible dans la même +archive zip. Consultez la page web pour plus de détails. +

+

5 Installations « portable » de TEX Live

+

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

Pour utiliser TEX depuis cette installation portable, il suffit d’ajouter le bon répertoire de binaires à votre +path pour la session de terminal en cours, comme d’habitude. Sous Windows, vous pouvez double-cliquer sur le +fichier tl-tray-menu à la racine de l’installation pour choisir parmi quelques actions communes, comme dans +cette capture d’écran : + +

pict +

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

+

5.1 Installation sur DVD ou image ISO

+

Si vous n’avez pas besoin de mettre à jour ni de modifier votre installation souvent, et/ou que vous désirez +utiliser TEX Live sur plusieurs systèmes, il peut être commode de créer une image ISO de votre installation +TEX Live, pour les raisons suivantes : +

+

Bien sûr vous pouvez aussi graver votre image ISO sur une DVD, si cela vous est utile. +

Les systèmes GNU/Linux et autres Unix de bureau, y compris Mac OS X, sont capables de monter une image +ISO. À part ce montage, rien de change par rapport à une installation normale sur le disque dur, voir la +section 3.4.1. +

Dans la préparation d’une telle installation, il est préférable d’omettre le sous-répertoire avec le numéro de +l’année, et d’avoir texmf-local au même niveau que les autres arborescences (texmf, texmf-dist, etc.), ce +qui est possible avec les options habituelles de l’installateur. +

Pour une machine Windows physique (et non virtuelle) vous pouvez graver l’ISO sur un DVD. Cependant, il +est peut-être plus rentable pour vous de vous renseigner sur les différentes options libres ou gratuites de +montage d’images ISO. Pour XP, Microsoft propose winxpvirtualcdcontrolpanel. +

Pour l’intégration au système sous Windows, vous pouvez inclure dans l’image le script w32client décrit en +section 4.1 et à l’adresse http://tug.org/texlive/w32client.html ; il fonctionne aussi bien pour une image +ISO que pour une installation partagée par le réseau. +

Sous Mac OS X, TeXshop et TEXworks peuvent utiliser une telle installation si un lien symbolique +/usr/texbin existe et pointe vers le bon répertoire, par exemple + + +

+
  sudo ln -s /Volumes/MyTeXLive/bin/universal-darwin /usr/texbin
+
+

+

Remarque historique : TEX Live 2010 a été la première édition à ne pas être distribuée en version « live ». +Cependant, toutes les éditions précédentes exigeaient quelques acrobaties pour être utilisées depuis le DVD ; +en particulier il n’y avait pas moyen de s’en sortir sans devoir régler au moins une variable d’environnement +supplémentaire. Si vous créez votre ISO ou DVD depuis une installation existante ceci n’est plus +nécessaire. +

+

6 Maintenance de l’installation avec tlmgr

+


+ + + + + + +

pict +

Figure 8: tlmgr en mode graphique. La liste des paquets, collections et schémas d’installation +n’apparaît qu’après avoir cliqué sur le bouton « Charger le dépôt par défaut »).
+ + +


+


+ + + + + + +

pict +

Figure 9: tlmgr en mode graphique : options générales
+

pict +

Figure 10: tlmgr en mode graphique : +options de taille du papier
+ + +


+

TEX Live fournit un programme appelé tlmgr pour assurer la maintenance de la distribution après son +installation initiale. Les programmes updmap, fmtutil et texconfig ont été conservés et le seront à l’avenir, mais +tlmgr est désormais considéré comme l’interface standard pour ces opérations. tlmgr permet en +particulier +

+

6.1 tlmgr en mode graphique

+

On lance tlmgr en mode graphique (figure 8) par la commande

+

+> tlmgr -gui +
+
ou sous Windows dans le menu « Démarrer » : Démarrer Programmes TeX Live +2012 TeX Live Manager. La première chose à faire est de cliquer sur le bouton +« Load 2 » +ce qui affiche la liste des collections, extensions, etc. (à condition bien sûr qu’il soit possible de se connecter au +dépôt utilisé). +

Les figures 9 et 10 montrent les écrans de réglage des options générales et de celles concernant la taille du +papier. +

+

6.2 Exemples d’utilisation de tlmgr en ligne de commande

+

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

+

+> tlmgr update -all +
+
Si cela vous inquiète, vous pouvez commencer par
+

+> tlmgr update -all -dry-run +
+
ou (moins bavard) :
+

+> tlmgr update -list + + +
+
+

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

+

+> tlmgr -repository /local/mirror/tlnet install collection-xetex +
+
La sortie, abrégée, ressemble à ceci : +
  install: collection-xetex
  install: arabxetex
  ...
  install: xetex
  install: xetexconfig +
  install: xetex.i386-linux
  running post install action for xetex
  install: xetex-def
  ...
  running mktexlsr +
  mktexlsr: Updating /usr/local/texlive/2012/texmf/ls-R...
  ...
  running fmtutil-sys --missing
  ... +
  Transcript written on xelatex.log.
  fmtutil: /usr/local/texlive/2012/texmf-var/web2c/xetex/xelatex.fmt installed.
+

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

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

+

+> tlmgr show collection-latexextra +
+
Elle retourne par exemple : +
  package:    collection-latexextra
  category:   Collection
  shortdesc:  LaTeX supplementary packages +
  longdesc:   A large collection of add-on packages for LaTeX.
  installed:  Yes
  revision:   14675
+

Enfin, le plus important, pour la documentation complète, consultez http://tug.org/texlive/tlmgr.html, +ou tapez :

+

+> tlmgr help +
+
+

+

7 Notes concernant Windows

+

+

7.1 Fonctionnalités supplémentaires à l’installation

+

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

+Menus et raccourcis
– un sous-menu « TEX Live » est ajouté au menu « Démarrer », contenant des + entrées pour quelques programmes graphiques comme tlmgr, texdoctk, PS_View (psv) et pour de + la documentation. +
+Associations de fichiers
– si cette option n’est pas désactivée, TeXworks, Dviout et PS_view + deviennent le programme par défaut pour ouvrir leurs types de fichiers respectifs, ou, s’il y a déjà + un tel programme, sont ajoutés à la liste « Ouvrir avec... » du menu contextuel. + + +
+Convertisseur bitmap vers eps
– une entrée bitmap2eps est ajoutée à l’entrée « Ouvrir avec... » du + menu contextuel pour de nombreux formats d’images bitmap. Bitmap2eps est un script simple qui + utilise sam2p ou bmeps pour faire le vrai travail. +
+Ajustement automatique du path
– aucune intervention manuelle n’est nécessaire. +
+Désinstallation
– une entrée est ajoutée pour TEX Live dans le menu « Ajout et suppression de + programmes ». L’onglet « Uninstall » de tlmgr renvoie à ceci.
+

+

7.2 Programmes supplémentaires

+

Pour être complète, une installation TEX Live a besoin de quelques utilitaires qui ne sont pas présents en +général sur les machines Windows. TEX Live comprend donc les outils suivants. +

+Perl et Ghostscript
TEX Live installe des copies « cachées » de ces programmes : ce sont des + versions spécifiques adaptées à TEX Live, elles sont invisibles hors de TEX Live et n’interfèrent + donc en aucune façon avec d’autres versions éventuellement présentes sur la machine. +
+PS_View
– nouveau lecteur PostScript et PDF sous licence libre, voir figure 11. +


pict +
Figure 11: PS_View : de très forts grossissements sont possibles !
+


+
+dviout
– lecteur de DVI. La première fois que vous visualisez un fichier avec dviout, il va créer des polices, car + les versions des fontes pour écran ne sont pas installées. Au bout d’un moment, la plupart des polices que + vous utilisez auront été créées, et vous ne verrez plus que rarement la fenêtre de création des fontes. + Vous pouvez trouver plus d’informations dans le menu d’aide du logiciel (dont la lecture est + recommandée). +
+TEXworks
TEXworks est un éditeur conçu pour les fichiers TEX, avec un lecteur de PDF intégré. +
+Outils en ligne de commande
– des versions pour Windows de programmes Unix sont installées, en + particulier gzip, chktex, jpeg2ps, unzip, wget et quelques utilitaires de la suite xpdf (pdfinfo, pdffonts, ...). + Le lectuer xpdf lui-même n’est pas disponible sous Windows mais vous pouvez télécharger Sumatra + PDF, qui est basé dessus, voir http://blog.kowalczyk.info/software/sumatrapdf). +
+fc-list, fc-cache, etc.
– outils de la bibliothèque fontconfig, qui permettent à XeTEX d’accéder aux polices + système sous Windows. Vous pouvez utiliser fc-list pour connaître la liste des noms de police utilisables + avec la commande \font de XeTEX.
+

+

7.3 Répertoire personnel

+

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

+

7.4 Base de registre Windows

+

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

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

+

7.5 Droits d’accès sous Windows

+

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

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

Si celui qui fait l’installation est « administrateur », il dispose d’une option d’installation pour tous les +utilisateurs : si cette option est choisie, les raccourcis et les entrées de menu sont créés pour tous +les utilisateurs, et l’environnement est modifié au niveau du système. Sinon, les raccourcis et +entrées de menu sont créés pour l’utilisateur courant, et seul son environnement utilisateur est +modifié. +

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

Lorsqu’une installation TEX est présente sur la machine, l’installation de TEX Live par un utilisateur non +privilégié est problématique : cet utilisateur n’aura jamais accès aux exécutables TEX Live car la recherche +s’effectue d’abord dans les répertoires système, puis dans les répertoires de l’utilisateur. Une parade sommaire +a été prévue : l’installateur crée un raccourci vers une fenêtre de ligne de commande où les exécutables TEX +Live sont prioritaires : TEX Live est ainsi utilisable en ligne de commande à partir de ce raccourci. De même, le +raccourci pour TEXworks, s’il est installé, fait ce qu’il faut pour que les outils TEX Live soient +utilisés. +

Pour Vista et Windows 7, il y a une subtilité supplémentaire : même si vous êtes connecté en +tant qu’administrateur, vous devez explicitement demander les privilèges d’administrateur. En +fait, il ne sert pas à grand chose de se connecter en tant qu’administrateur ; le mieux est de faire +un clic droit sur le programme ou raccourci à utiliser, et d’utiliser l’entrée « exécuter en tant +qu’administrateur ». +

+

7.5.1 Augmentation de la limite de mémoire sous Windows et Cygwin
+

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

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

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

+

  Windows Registry Editor Version 5.00
  
  [HKEY_LOCAL_MACHINE\Software\Cygwin]
  "heap_chunk_in_mb"=dword:ffffff00
+

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

+

8 Guide d’utilisation du système Web2C

+

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

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

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

+

+ bibtex
+

– gère les bibliographies. +

+ dvicopy
+

– copie le fichier DVI en supprimant les fontes virtuelles. +

+ dvitomp
+

– convertit le fichier DVI en MPX (dessins MetaPost). +

+ dvitype
+

– convertit le fichier DVI en un texte lisible. +

+ gftodvi
+

– visualisation de fontes génériques GF. +

+ gftopk
+

– convertit les fontes génériques GF en fontes bitmap PK. +

+ gftype
+

– convertit le fichier GF en un texte lisible. +

+ mf
+

– création de fontes. +

+ mft
+

– mise en page de code source Metafont. +

+ mpost
+

– création de diagrammes techniques. + + +

+ patgen
+

– création de motifs de césure. +

+ pktogf
+

– convertit les fontes bitmap PK en fontes génériques GF. +

+ pktype
+

– convertit les fontes PK en un texte lisible. +

+ pltotf
+

– convertit les fichiers PL (lisibles) en TFM. +

+ pooltype
+

– affiche les fichiers WEB pool. +

+ tangle
+

WEB vers Pascal. +

+ tex
+

– composition de textes. +

+ tftopl
+

– convertit les fichiers TFM en PL (lisibles). +

+ vftovp
+

– convertit les fontes virtuelles VF en VPL (lisibles). +

+ vptovf
+

– convertit les fontes VPL en fontes virtuelles VF. +

+ weave
+

WEB vers TEX.

+

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

Presque tous ces programmes suivent les options standard de GNU : +

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

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

+

8.1 Kpathsea et la recherche de fichiers

+

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

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

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

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

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

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

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

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

+

8.1.1 Les différentes sources
+

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

+

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

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

+

8.1.2 Fichiers de configuration
+

Kpathsea lit les chemins de recherche et d’autres définitions dans des fichiers de configuration à l’exécution +nommés texmf.cnf . Le chemin pour accéder à ces fichiers dans l’arborescence est stocké dans la variable +TEXMFCNF, mais il n’est pas conseillé de modifier cette variable (ou une autre) au moyen d’une variable +d’environnement du même nom. +

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

Il est important de noter que tous les fichier texmf.cnf trouvés seront lus, et qu’en cas de conflit, la première +définition lue l’emporte. Par exemple, si les fichiers texmf.cnf sont cherchés dans le chemin .:$TEXMF, les +valeurs de ./texmf.cnf l’emportent sur celles de $TEXMF/texmf.cnf. +

+

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

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

+

+

8.1.3 Expansion d’un chemin de recherche
+

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

+

8.1.4 Expansion par défaut
+

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

+

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

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

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

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

+

8.1.5 Expansion spécifiée par les accolades
+

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

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

Avec ceci, on peut écrire quelque chose comme + + +

+
    TEXINPUTS = .;$TEXMF/tex//
+
+

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

+

8.1.6 Expansion des sous-répertoires
+

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

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

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

+

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

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

+

+  :
+

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

+  ;
+

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

+ $
+

Substitue le contenu d’une variable. +

+ ~
+

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

+ {...}
+

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

+ //
+

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

+ %
+

Début d’un commentaire. + + +

+ \
+

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

+  ! !
+

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

+

+

8.2 Les bases de données

+

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

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

+

8.2.1 Le fichier base de données
+

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

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

+

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

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

+

8.2.2 kpsewhich : programme de recherche dans une arborescence
+

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

+ + +

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

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

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

+

+ --dpi=num
+


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

+ --format=name
+


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

+ --mode=string
+


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

+ --must-exist
+


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

+ --path=string
+


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

+ --progname=name
+


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

+ --show-path=name
+


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

+ --debug=num
+


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

+ + +

+

8.2.3 Exemples d’utilisation
+

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

+

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

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

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

+

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

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

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

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

+

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

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

+

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

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

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

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

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

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

+

8.2.4 Opérations de débogage
+

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

+  1
+

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

+  2
+

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

+  4
+

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

+  8
+

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

+ 16
+

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

+ 32
+

Recherche de fichiers. +

+ 64
+

Valeur des variables.

+

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

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

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

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

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

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

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

+

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


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

+

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

+

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

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

+

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

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

+

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

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

+

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

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

8.3 Options à l’exécution

+

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

+ main_memory
+

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

+ extra_mem_bot
+

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

+ font_mem_size
+

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

+ hash_extra
+

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

+

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

+

9 Remerciements

+

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

+

Les binaires ont été compilés par : Ettore Aldrovandi (i386-solaris, x86_64-solaris), Alan Braslau +(amd64-kfreebsd, i386-kfreebsd), Peter Breitenlohner (x86_64-linux), Karl Berry (i386-linux), Ken Brown +(i386-cygwin), Akira Kakuto (win32), Dick Koch (universal-darwin, x86_64-darwin), Nikola Lečić +(amd64-freebsd, i386-freebsd), Mojca Miklavec (mipsel-linux), Norbert Preining (alpha-linux), Thomas Schmitz +(powerpc-linux), Boris Veytsman (armel-linux), Vladimir Volovich (powerpc-aix, sparc-solaris), Olaf Weber +(mips-irix). +

Traducteurs de ce manuel : Boris Veytsman (russe), Jjgod Jiang, Jinsong Zhao, Yue Wang, & Helin Gai +(chinois), Uwe Ziegenhagen (German), Manuel Pégourié-Gonnard (français), Marco Pallante (italien), Nikola +Lečić (serbe), Petr Sojka & Jan Busa (thèque et slovaque), Staszek Wawrykiewicz (polonais). La page +d’accueil de la documentation TEX Live est http://tug.org/texlive/doc.html. +

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

+

10 Historique des versions successives

+ + +

+

10.1 Les éditions précédentes

+

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

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

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

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

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

+

10.1.1 2003
+

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

+

+

10.1.2 2004
+

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

+

+

10.1.3 2005
+

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

+

+

10.1.4 2006–2007
+

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

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

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

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

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

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

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

+

10.1.5 2008
+

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

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

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

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

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

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

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

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

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

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

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

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

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

+

10.1.6 2009
+

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

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

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

Le nouvel éditeur intégré TEXworks est fourni pour Windows, ainsi que dans MacTEX. Pour les autres +plate-formes, ainsi que d’autres informations, voir la page de TEXworks : http://tug.org/texworks. Cet +éditeur fonctionnant sur de nombreuses plate-formes, inspiré par l’éditeur TEXshop de Mac OS X, vise à +faciliter l’utilisation de TEX. +

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

Le programme dvipdfm séparé a été remplacé par dvipdfmx qui, lorsqu’il est appelé par ce nom, travaille +dans un mode de compatibilité spécifique. Le programme dvipdfmx fournit des fonctionnalités pour les +écritures CJK et inclut de nombreux correctifs accumulés au fil des ans depuis la dernière sortie de dvipdfm. +Sa page d’accueil est http://project.ktug.or.kr/dvipdfmx. +

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

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

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

+

10.1.7 2010
+

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

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

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

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

XeTEX offre désormais un ajustement optique des marges similaire à celui de pdfTEX. (La dilatation des +fontes n’est pas contre pas disponible actuellement.) +

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

De nouveaux programmes sont inclus : le moteur pTEX et les utilitaires reliés pour la composition du +japonais ; le programme BibTeXU qui est une version de BibTeX gérant Unicode ; l’utilitaire chktex +(http://baruch.ev-en.org/proj/chktex) pour vérifier les documents (LA )TEX ; le programme de conversion +DVI vers SVG dvisvgm (http://dvisvgm.sourceforge.net). +

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

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

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

+

10.1.8 2011
+

Les binaires pour Mac OS X (universal-darwin et x86_64-darwin) ne fonctionnent désormais que sous +Leopard ou une version ultérieure ; Panther et Tiger ne sont plus supportés. + + +

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

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

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

+

10.2 Version présente

+

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

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

Les fichiers de sortie générés par pdftex et dvips, entre autres, peuvent maintenant dépasser les +2 Go. +

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

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

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

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

Plate-formes : armel-linux et mipsel-linux ont été ajoutés ; sparc-linux et i386-netbsd ne font plus partie de la +distribution principale, mais sont disponibles en tant que plate-formes complémentaires, ainsi que d’autres +plate-formes : http://tug.org/texlive/custom-bin.html. +

+

10.3 Versions futures

+

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

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

+

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

+

Bon travail avec TEX ! + + +

+*Précédentes versions françaises par Daniel Flipo, Éric Picheral, Jacques André, Fabrice Popineau et peut-être +d’autres avant eux — qu’ils en soient tous remerciés. Mes remerciements aussi aux aimables relecteurs : Arnaud +Schmittbuhl, Denis Bitouzé, Élie Roux, Hervé Vigier, Jean-Yves Beaudais, Laurent Méhats, tdc ; je suis bien +sûr responsable des erreurs restantes. N’hésitez pas à me les signaler par mail à mpg@elzevir.fr ! +

+

1.wizard mode en anglais +

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

+ + + + + + diff --git a/Master/texmf-dist/doc/texlive/texlive-fr/texlive-fr.pdf b/Master/texmf-dist/doc/texlive/texlive-fr/texlive-fr.pdf new file mode 100644 index 00000000000..c1abff07477 Binary files /dev/null and b/Master/texmf-dist/doc/texlive/texlive-fr/texlive-fr.pdf differ diff --git a/Master/texmf-dist/doc/texlive/texlive-fr/texlive-fr.tex b/Master/texmf-dist/doc/texlive/texlive-fr/texlive-fr.tex new file mode 100644 index 00000000000..b37ad2475af --- /dev/null +++ b/Master/texmf-dist/doc/texlive/texlive-fr/texlive-fr.tex @@ -0,0 +1,3653 @@ +% $Id$ +% +% French translation of the TeX Live documentation. +% See ../texlive-en for original version. +% This translation is released under the terms of the WTFPL v2. +% +% Last update based on ../texlive-en/texlive-en.tex r26703 +% +% Change history (started May 18th 2002) +% 2009/09/21: synced with 2009 English version, by Manuel Pégourié-Gonnard +% 2008/07/26: synced with 2008 English version, by Daniel Flipo +% 2007/01/18: synced with 2007 English version, by Daniel Flipo +% 2005/11/01: synced with 2005 English version, by Daniel Flipo +% 2005/05/05: re-added section on building binaries (Daniel Flipo) +% 2004/10/28: synced with 2004 English version, by Daniel Flipo +% 2003/08/28: synced with 2003 English version, by Éric Picheral & Jacques André +% 2002/05/25: proof-reading and corrections, by Daniel Flipo +% 2002/05/18: synced with English version, by Fabrice + +\documentclass{article} + +\usepackage[utf8]{inputenc} +\usepackage[T1]{fontenc} +\let\tldocfrench=1 % pour live4ht.cfg (ou en fait inutilisé?) (mpg) + +\usepackage[english, frenchb]{babel} +\usepackage{xspace} +\frenchbsetup{AutoSpacePunctuation=false, og=«, fg=»} + +\usepackage{tex-live} + +% Francisation de tex-live.sty (df) +\renewcommand{\samp}[1]{\og \texttt{#1}\fg{}} +% (df) La commande \TeXLive n'est pas utilisée en v.f. +\renewcommand{\TL}{\TeX{} Live\xspace}% Robuste (pas besoin de \protect)... +\renewcommand{\TK}{\TeX{} Collection\xspace}% idem. +% tex-live.sty fait précéder les no de page d'une fine... +% en français, une insécable normale est préférable +\def\p.{page~} + +% correction du support pour tex4ht relatif à frenchb.ldf 2.3 ou supérieur +\ifnum\Status=2 % generating html + \makeatletter + \AtBeginDocument{\let\FDP@space\FDP@colonspace} + \makeatother +\fi + +% plus de macros (mpg) +\newcommand\eng[1]{\foreignlanguage{english}{\emph{#1}}} +\newcommand*\semail[1]{\href{mailto:#1}{#1}} + +\setlength{\parindent}{0mm} +\addtolength{\parskip}{.25\baselineskip} + +\begin{document} + +\title{% + {\huge\itshape Guide pratique de \TL \\\smallskip}% + {\LARGE\sffamily \TL 2012}% +} + +\author{ + Karl Berry, éditeur \\[3mm] + \url{http://tug.org/texlive/} \\[6mm] + \textit{Version française} \\[3mm] + Manuel Pégourié-Gonnard\thanks{% + Précédentes versions françaises par Daniel + Flipo, Éric Picheral, Jacques André, Fabrice Popineau et peut-être + d'autres avant eux --- qu'ils en soient tous remerciés. Mes remerciements + aussi aux aimables relecteurs : + Arnaud Schmittbuhl, + Denis Bitouzé, + Élie Roux, + Hervé Vigier, + Jean-Yves Beaudais, + Laurent Méhats, + tdc + ; je suis bien sûr responsable des erreurs restantes. N'hésitez pas à me + les signaler par mail à \semail{mpg@elzevir.fr} ! + } +} + +% relecteurs 2009 : +% Denis Bitouzé, +% Élie Roux, +% Hervé Vigier, +% Jean-Yves Beaudais, +% Laurent Méhats, +% tdc +% relecteurs 2010 : +% Denis Bitouzé, +% Hervé Vigier, +% Arnaud Schmittbuhl + +\date{Juin 2012} + +\maketitle + +\begin{multicols}{2} +\tableofcontents +\end{multicols} + +\section{Introduction} +\label{sec:intro} + +\subsection{\TeX\ Live et \TeX\ Collection} + +Ce document décrit les principales caractéristiques de la +distribution \TL{}, une distribution complète de \TeX{} +pour Linux et autres Unix, \MacOSX{} et systèmes Windows. + +Cette distribution peut être obtenue par téléchargement, sur le \DVD{} \TK{} +distribué par les groupes d'utilisateurs de \TeX{} à leurs membres, ou par +d'autres moyens. +La section \ref{sec:tl-coll-dists} décrit brièvement le contenu du \DVD. +\TL{} et \TK{} sont le fruit des efforts des groupes d'utilisateurs de +\TeX. La description qui suit porte essentiellement sur \TL. + +La distribution \TL comprend les binaires +pré-compilés de \TeX, \LaTeXe, \ConTeXt, \MF, \MP, \BibTeX{} et de nombreux +autres programmes ainsi qu'une bibliothèque étendue de macros, de +fontes et de documentations. Elle permet aussi la composition de textes +dans la plupart des langues utilisées dans le monde. + +On trouvera à la fin du document, section~\ref{sec:history} +(page~\pageref{sec:history}), un bref historique des principales modifications +apportées au fil du temps à la distribution \TL. + +Les utilisateurs des éditions précédentes de \TL{} sont invités à lire, +\emph{avant toute mise à jour}, la section~\ref{sec:tlcurrent} +page~\pageref{sec:tlcurrent} qui présente les principaux changements +intervenus cette année. + +\htmlanchor{platforms} +\subsection{Support des différents systèmes d'exploitation} +\label{sec:os-support} + +\TL{} contient les exécutables pour les principales architectures Unix, dont +\GNU/Linux, \MacOSX et Cygwin. Les sources inclus dans +la distribution devraient être compilables sur des plate-formes pour lesquelles +nous ne fournissons pas d'exécutables. + +Concernant Windows, \acro{XP} et les versions ultérieures sont supportés. +Windows~2000 devrait probablement fonctionner (en bonne partie). Il n'y a pas +d'exécutables spécifiques 64-bit pour Windows, mais les exécutables 32-bit +devraient fonctionner sur les systèmes 64-bit. + +Consulter la section~\ref{sec:tl-coll-dists} pour des solutions alternatives +sous Windows et \MacOSX. + +\subsection{Installation élémentaire de \TL{}} +\label{sec:basic} + +Vous pouvez installer \TL{} de deux façons différentes : soit depuis le \DVD, +soit depuis Internet (\url{http://tug.org/texlive/acquire.html}). +L'installateur réseau est petit et télécharge tout ce +qu'il faut depuis Internet. + +L'installateur du \DVD vous permet d'installer sur votre disque dur. Il n'est +plus possible de lancer \TL directement depuis le \DVD{} \TK{} (ou une image +\code{.iso}), mais vous pouvez créer une installation portable, par exemple +sur une clé \USB{} (voir section~\ref{sec:portable-tl}). + +La procédure d'installation est décrite en détail dans les sections suivantes +(\p.\pageref{sec:install}), mais voici de quoi commencer rapidement. + +\begin{itemize*} + +\item Le script d'installation s'appelle \filename{install-tl}. Il peut + fonctionner en mode « magique\footnote{\eng{wizard mode} en anglais} » avec + l'option \code{-gui=wizard} (c'est le mode par défaut sous Windows), en mode + texte avec l'option \code{-gui=text} (mode par défaut partout ailleurs), ou + en mode graphique expert avec \code{-gui=perltk}. + +\item Ce script installe en particulier le programme « \TL\ Manager » appelé + \prog{tlmgr}. Comme l'installeur, il peut être utilisé en mode graphique ou + en mode texte. Il permet d'ajouter ou de supprimer des composants et de + procéder à différents réglages de configuration. + +\end{itemize*} + +\htmlanchor{security} +\subsection{Remarques sur la sécurité} +\label{sec:security} + +À notre connaissance, les programmes \TeX{} de base en eux-mêmes sont (et ont +toujours été) extrêmement robustes. Cependant, d'autres programmes livrés avec +\TL{} ne le sont peut-être pas autant, bien que chacun fasse de son mieux. De +façon générale, il faut faire preuve de prudence avant de lancer des +programmes sur des données en lesquelles vous n'avez pas toute confiance. Pour +plus de sécurité, travaillez dans un nouveau répertoire créé à cet effet. + +Il convient d'être particulièrement vigilant sous Windows, qui en général +cherche les programmes dans le répertoire courant avant tout, quel que soit le +chemin de recherche défini. Nous avons comblé de nombreuses failles, mais il +en reste certainement d'autres, notamment avec les programmes maintenus +extérieurement. C'est pourquoi nous recommandons de vérifier s'il n'y a pas de +fichiers suspects dans le répertoire courant, en particulier les exécutables +(binaires ou scripts). En général, il ne devrait pas y en avoir, et le simple +fait de compiler un document devrait encore moins en créer. + +Enfin, \TeX{} (et les programmes associés) ont la capacité d'écrire des +fichiers en compilant des documents, capacité qui peut être exploitée à des +fins malignes de nombreuses façons. Ici aussi, la meilleure protection est de +compiler les documents inconnus dans un répertoire nouvellement créé. + +\subsection{Obtenir de l'aide} +\label{sec:help} + +La communauté \TeX{} est active et conviviale ; la plupart des questions +finissent par obtenir une réponse. Par contre, le support est informel, assuré +par des volontaires et des lecteurs occasionnels, aussi est-il +particulièrement important que vous fassiez votre propre travail de recherche +avant de poser une question (si vous préférez un support commercial, vous +pouvez renoncer à \TL{} et acheter un système payant ; voir une liste à +\url{http://tug.org/interest.html#vendors}). + +Voici une liste de ressources, classées selon l'ordre dans lequel nous +recommandons de les utiliser : + +\begin{description} +\item [Getting Started] -- pour ceux qui débutent en \TeX, la page web +\url{http://tug.org/begin.html} contient une courte description +du système. + +\item [\acro{FAQ} \TeX{}] -- la \acro{FAQ} \TeX{} est un vaste recueil + de réponses à toutes sortes de questions, de la plus élémentaire à la + plus complexe. Elle est enregistrée sur le \DVD{} dans + \OnCD{texmf-dist/doc/generic/FAQ-en/html/index.html} + et elle est disponible sur Internet à + l'adresse \url{http://www.tex.ac.uk/faq}. + Merci de consulter cette FAQ avant toute question. + +\item [Catalogue \TeX{}] -- si vous recherchez une extension, une fonte, + un programme, etc., le mieux est de consulter le catalogue + \TeX{} ici : \url{http://mirror.ctan.org/help/Catalogue/}. + +\item [Ressources \TeX{} sur le Web] -- la page web + \url{http://tug.org/interest.html} propose + beaucoup de liens relatifs à \TeX{}, en particulier concernant des + livres, manuels et articles portant sur tous les aspects du système. + +\item [Archives des forums d'aide] -- les principaux forums dédiés + au support de \TeX{} sont les groupes de nouvelles Usenet + \url{news:comp.text.tex} (en anglais) et \url{news:fr.comp.text.tex} + (en français) ainsi que les listes de diffusion + \email{texhax@tug.org} (en anglais) et \email{gut@ens.fr} (en français). + Les archives correspondantes contiennent des + milliers de questions et réponses déjà traitées et permettent + une recherche fructueuse. Voir + \url{http://groups.google.com/groups?group=fr.comp.text.tex} + et \url{http://tug.org/mail-archives/texhax}, respectivement. Une + question posée sur un moteur de recherche, tel que + \url{http://google.com}, peut aussi fournir des réponses pertinentes. + +\item [Poster une question] -- si vous ne trouvez pas de réponse, vous pouvez + poser la question (en français) sur \dirname{fr.comp.text.tex} via Google ou + votre lecteur de nouvelles, ou encore par messagerie à + \email{texhax@tug.org} (en + anglais). Mais avant de le faire, merci de lire l'introduction de la + \acro{FAQ} donnant les conseils sur la façon de rédiger la question pour + avoir des chances d'obtenir une réponse pertinente : + \url{http://www.tex.ac.uk/cgi-bin/texfaq2html?label=askquestion}. Pour de + l'aide en anglais, vous pouvez également vous tourner vers le site \LaTeX{} + Community : \url{http://www.latex-community.org/} et son forum + \url{http://www.latex-community.org/forum/}, ainsi que le site \TeX\ + StackExchange à \url{http://tex.stackexchange.com/}. + +\item [Support de \TL{}] -- si vous voulez faire un rapport + d'anomalie, émettre des suggestions ou des commentaires sur la + distribution \TL{}, son installation ou sa documentation, utilisez + la liste de diffusion \email{tex-live@tug.org}. Mais attention, si + la question concerne l'utilisation d'un programme particulier inclus + dans \TL{}, il vaut mieux que vous vous adressiez directement à la + personne ou à la liste de diffusion qui maintient le programme. Il suffit + souvent d'ajouter l'option \code{-{}-help} lors de l'exécution du programme + pour trouver à qui adresser le rapport. + +\end{description} + +L'autre aspect du sujet concerne l'aide à apporter aux personnes +soumettant des questions. Les forums \dirname{comp.text.tex}, +\dirname{fr.comp.text.tex} ainsi que les listes de diffusion \code{texhax} +et \code{gut} +sont ouverts à tous, aussi n'hésitez pas à vous y joindre, à commencer +la lecture et à fournir de l'aide là où cela vous est possible. + +% No \protect needed as \TL is defined in French with \newcommand (robust). +\section{Structure de \TK} +\label{sec:overview-tl} + +Nous décrivons ici le contenu de \TK{} qui est un sur-ensemble de \TL. + +\subsection {\TK{} : \TL, pro\TeX{}t, Mac\TeX} +\label{sec:tl-coll-dists} + +Le \DVD{} \TK{} contient les éléments suivants : + +\begin{description} + +\item [\TL{}] -- un système \TeX{} complet à installer. Sa + page web est \url{http://tug.org/texlive/}. + +\item [Mac\TeX] -- un système \TeX\ pour \MacOSX, qui ajoute à \TL un + installateur spécifique à \MacOSX{} et quelques applications propres au + système Mac. Le site de Mac\TeX{} est \url{http://tug.org/mactex/}. + +\item [pro\TeX{}t] -- une extension du système \MIKTEX\ pour Windows qui en + facilite l'installation et ajoute quelques outils. Cette distribution est + totalement indépendante de \TL{}, elle nécessite un mode d'installation + spécifique. Le site de \ProTeXt\ est \url{http://tug.org/protext}. + +\item [CTAN] -- une image du site d'archives \CTAN. + +\item [\texttt{texmf-extra}] -- un répertoire contenant quelques extensions + supplémentaires. + +\end{description} + +Les droits d'utilisation des fichiers présents dans \CTAN, \ProTeXt{} +et \texttt{texmf-extra} diffèrent de ceux de \TL{}, pensez à lire +les licences si vous envisagez de modifier ou de redistribuer certains de +ces fichiers. + +\subsection{Répertoires situés à la racine de \TL{}} +\label{sec:tld} + +Voici une petite liste des répertoires situés à la racine d'une installation +\TL avec une courte description. + +\begin{ttdescription} +\item[bin] -- programmes de la famille \TeX{}, rangés dans des + sous-répertoires selon les plates-formes. +% +\item[readme-*.dir] -- une brève introduction et quelques liens utiles pour + \TL, dans divers langages, sous forme de pages \HTML\ ou de texte brut. +% +\item[source] -- le code source de tous les programmes, dont les principaux + programmes \TeX{} basés sur \Webc{}. +% +\item[texmf] -- répertoire contenant les programmes et leur documentation ; ne + contient ni les formats ni les extensions (la variable \envname{TEXMFMAIN} + de la section suivante pointe sur ce répertoire). +% +\item[texmf-dist] -- répertoire principal où se trouvent les extensions, + les fontes, etc., avec leur documentation (la variable \envname{TEXMFDIST} + de la section suivante pointe sur ce répertoire). +% +\item[tlpkg] -- scripts et programmes d'installation, et + éléments spécifiques pour Windows. +\end{ttdescription} + +On trouve également, au même niveau que les répertoires mentionnés ci-dessus, +les scripts d'installation et le fichier \filename{README} principal en +anglais (disponible en différentes langues dans les répertoires +\filename{readme-*.dir} susmentionnés). + +Concernant la documentation, le fichier \OnCD{doc.html}, qui contient une +liste exhaustive de liens vers les fichiers de documentation, peut être bien +utile. La documentation des programmes (manuels, pages de \cmdname{man}, +fichiers \cmdname{info}) se trouve dans \dirname{texmf/doc}. Celle des autres +paquets et des formats est dans \dirname{texmf-dist/doc}. Vous pouvez utiliser +le programme \cmdname{texdoc} pour trouver chaque fichier de documentation, où +qu'il soit. + +La documentation de \TL\ proprement dite (que vous consultez actuellement) est +disponible dans le répertoire \dirname{texmf/doc/texlive} en plusieurs +langues, + +\begin{itemize*} +\item{anglais :} \OnCD{texmf/doc/texlive/texlive-en}, +\item{allemand :} \OnCD{texmf/doc/texlive/texlive-de}, +\item{chinois (simplifié) :} \OnCD{texmf/doc/texlive/texlive-zh-cn}, +\item{français :} \OnCD{texmf/doc/texlive/texlive-fr}, +\item{italien :} \OnCD{texmf/doc/texlive/texlive-it} +\item{polonais :} \OnCD{texmf/doc/texlive/texlive-pl}, +\item{russe :} \OnCD{texmf/doc/texlive/texlive-ru}, +\item{tchèque \& slovaque :} \OnCD{texmf/doc/texlive/texlive-cz}. +\end{itemize*} + +\subsection{Description des arborescences « texmf » de \TL} +\label{sec:texmftrees} + +Nous donnons ici la liste des variables prédéfinies qui contiennent les noms +des différentes arborescences de type « texmf », l'usage qui en est fait, et +leurs valeurs par défaut dans \TL. La commande \cmdname{tlmgr~conf} montre +les valeurs de ces variables, ce qui permet de savoir où se trouvent ces +différentes arborescences dans une installation donnée. + +Notez bien que toutes ces arborescences, y compris les arborescences +personnelles, doivent suivre la structure standard des répertoires de \TeX{} +(\TDS{} : \url{http://tug.org/tds}) avec sa pléthore de sous-répertoires, ou +les fichiers ne seront pas pris en compte. La section +\ref{sec:local-personal-macros} page \pageref{sec:local-personal-macros} +donne plus de détails à ce sujet. + +\begin{ttdescription} +\item [TEXMFMAIN] -- contient les éléments essentiels du système, comme les + fichiers de configuration, des scripts utilitaires, et la documentation des + programmes. +\item [TEXMFDIST] -- contient les fichiers de macros (Plain, \LaTeX, \ConTeXt, + etc.), les fontes, etc. Rien ne devrait être ajouté, modifié ni supprimé + manuellement dans cette arborescence. +\item [TEXMFLOCAL] -- c'est là que l'administrateur de la machine doit + placer les classes et extensions locales, les fontes non disponibles + dans \TL, etc. +\item [TEXMFHOME] -- contient les fichiers personnels (extensions, classes, + fontes) de l'utilisateur ; ce répertoire est installé automatiquement dans + le répertoire personnel de l'utilisateur. +\item [TEXMFCONFIG] -- c'est là que les scripts \cmdname{texconfig} + \cmdname{updmap} et \cmdname{fmtutil} recherchent leurs fichiers de + configuration (personnelles) en priorité. +\item [TEXMFSYSCONFIG] -- c'est là que les scripts \cmdname{texconfig-sys}, + \cmdname{updmap-sys} et \cmdname{fmtutil-sys} recherchent leurs fichiers de + configuration (globaux) en priorité. +\item [TEXMFVAR] -- c'est là que les scripts \cmdname{texconfig}, + \cmdname{updmap} et \cmdname{fmtutil} rangent les (versions personnelles de) + données générées, comme les formats et les fichiers \verb+.map+. +\item [TEXMFSYSVAR] -- c'est là que les scripts \cmdname{texconfig-sys}, + \cmdname{updmap-sys} et \cmdname{fmtutil-sys} rangent les (versions globales + des) données générées, comme les formats et les fichiers \verb+.map+. +\item [TEXMFCACHE] -- arborescence(s) utilisée(s) par \ConTeXt\ Mk\acro{IV} + pour stocker des (versions de cache de) fichiers de travails. +\end{ttdescription} + +La structure de l'arborescence \TL{} est par défaut la suivante : +\begin{description} +\item[racine multi-utilisateur] (par exemple \verb|/usr/local/texlive|, + \verb|D:\texlive|,\dots) qui contient éventuellement plusieurs + distributions : + \begin{ttdescription} + \item[2011] -- la distribution précédente, + \item[2012] -- la distribution actuelle, + \begin{ttdescription} + \item [bin] ~ + \begin{ttdescription} + \item [i386-linux] -- exécutables Linux, + \item [...] + \item [universal-darwin] -- exécutables \MacOSX, + \item [win32] -- exécutables Windows, + \end{ttdescription} + \item [texmf\ \ \ \ \ \ \ ] -- correspond à \envname{TEXMFMAIN}, + \item [texmf-dist\ \ ] -- correspond à \envname{TEXMFDIST}, + \item [texmf-var\ \ \ ] -- correspond à \envname{TEXMFSYSVAR}, + \item [texmf-config] -- correspond à \envname{TEXMFSYSCONFIG}, + \end{ttdescription} + \item [texmf-local] -- correspond à \envname{TEXMFLOCAL}, normalement + commun à plusieurs distributions \TL{} (2007, 2008, etc.), + \end{ttdescription} + \item[répertoire personnel de l'utilisateur] \texttt{\$HOME} ou + \texttt{\%USERPROFILE\%} : + \begin{ttdescription} + \item[.texlive2011] -- fichiers propres à l'utilisateur générés + automatiquement par la distribution \TL{} précédente, + \item[.texlive2012] -- fichiers propres à l'utilisateur générés + automatiquement par la distribution \TL{} actuelle, + \begin{ttdescription} + \item [texmf-var\ \ \ ] -- correspond à \envname{TEXMFVAR}, + \envname{TEXMFCACHE}, + \item [texmf-config] -- correspond à \envname{TEXMFCONFIG}, + \end{ttdescription} + \item[texmf] -- correspond à \envname{TEXMFHOME}, répertoire regroupant + tous les répertoires de macros personnelles : \dirname{texmf/tex/latex} + par exemple pour les fichiers de macros \LaTeX, etc. + \end{ttdescription} +\end{description} + +\subsection{Les extensions de \TeX} +\label{sec:tex-extensions} + +Le programme \TeX\ original de Knuth est figé, sauf corrections de bugs, +rares. C'est toujours le programme \prog{tex} présent dans \TL, et ceci ne +changera pas autant dans un futur prévisible. \TL contient plusieurs variantes +étendues de \TeX. + +\begin{description} + +\item [\eTeX{}] \label{text:etex} ajoute un jeu de nouvelles + primitives et les extensions \TeXXeT{} pour l'écriture de droite + à gauche ; \eTeX{} est, en mode normal, 100\% compatible avec + \TeX{} standard. Pour plus de détails consulter le + fichier \OnCD{texmf-dist/doc/etex/base/etex_man.pdf} du \DVD{}. + +\item [pdf\TeX{}] inclut les extensions \eTeX{} et produit, au choix, des + fichiers au format Acrobat \acro{PDF} ou au format \dvi{} ; il inclut aussi + de nombreuses extensions indépendantes du format de sortie. C'est le moteur + de base sur lequel sont construits tous les formats autres que plain\TeX{}, + comme \prog{etex}, \prog{latex} et \prog{pdflatex}. Son site web est + \url{http://www.pdftex.org/}. Le manuel d'utilisation se trouve sur le + \DVD{} dans \OnCD{texmf/doc/pdftex/manual/}. Le fichier + \OnCD{texmf/doc/pdftex/pdftex/manual/samplepdf/samplepdf.tex} donne des + exemples d'utilisation. + +\item [Lua\TeX] est le successeur de pdf\TeX{} avec lequel il reste en grande + partie (mais pas totalement) compatible. Ses possibilités sont aussi censées + être un sur-ensemble de celles d'Aleph (voir ci-dessous), bien qu'il ne soit + pas prévu pour être techniquement compatible. Lua\TeX{} inclut le langage + de script Lua (voir \url{http://www.lua.org/}) qui apporte des solutions + élégantes à beaucoup de problèmes épineux en \TeX{} pur. La commande + \filename{texlua} fonctionne comme un interpréteur Lua indépendant, et est + déjà utilisée en tant que telle dans \TL. Voir \url{http://www.luatex.org/} + et \OnCD{texmf-dist/doc/luatex/luatexref-t.pdf}. + +\item [Xe\TeX] ajoute la possibilité d'utiliser en entrée le codage Unicode + et en sortie les fontes OpenType et les fontes système de la machine, ceci + grâce à des bibliothèques externes : voir \url{http://tug.org/xetex/}. + +\item [\OMEGA{} (Omega)] fonctionne en utilisant Unicode et des caractères 16 + bits, ce qui lui permet de travailler directement et simultanément avec + presque toutes les écritures du monde. L'extension supporte aussi le + chargement dynamique d'\acro{OTP} (\OMEGA{} \emph{Translation Processes}) + qui permet à l'utilisateur d'appliquer sur des flux d'entrée quelconques des + transformations complexes qu'il aura lui-même définies. \TL n'inclut plus + Omega en tant que programme séparé ; seul Alpeh est fourni. + +\item [Aleph] combine les fonctionnalités de \OMEGA\ et de \eTeX ; voir + \OnCD{texmf-dist/doc/aleph/base}. + +\end{description} + +\subsection{Quelques autres programmes intéressants + dans \TL} + +Voici quelques autres programmes couramment utilisés et présents dans +\TL{} : + +\begin{cmddescription} + +\item [bibtex, bibtex8] -- traitement des bibliographies. + +\item [makeindex, xindy] -- traitement des index. + +\item [dvips] -- conversion \dvi{} vers \PS{}. + +\item [xdvi] -- visualisation \dvi{} pour le système X Window. + +\item [dvilj] -- pilote \dvi{} pour les imprimantes HP LaserJet. + +\item [dviconcat, dviselect] -- couper/Coller de pages à partir de fichiers + \dvi{}. + +\item [dvipdfmx] -- conversion \dvi{} vers \acro{PDF}, une alternative à + pdf\TeX{} (mentionné ci-dessus) pour produire des fichiers \acro{PDF}. + +\item [psselect, psnup, \ldots] -- utilitaires \PS{}. + +\item [pdfjam, pdfjoin, \ldots] -- utilitaires \acro{PDF}. + +\item [texexec, texmfstart] -- processeurs Con\TeX{}t et \acro{PDF}. + +\item [tex4ht] -- conversion \TeX{} vers \acro{HTML} et \acro{XML}. + +\end{cmddescription} + +\subsection{Fontes incluses dans \TL} +\label{sec:tl-fonts} + +La distribution \TL{} contient un grand nombre de fontes vectorielles de haute +qualité : voir \url{http://tug.org/fonts} et +\OnCD{texmf-dist/doc/fonts/free-math-fonts-survey}. + + +\htmlanchor{installation} +\section{Installation} +\label{sec:install} + +\subsection{Démarrage de l'installation} +\label{sec:inst_start} + +La première chose à faire est de récupérer le \DVD{} \TK ou de +télécharger le programme d'installation par le réseau. +Le programme d'installation s'appelle \filename{install-tl} pour Unix +et \filename{install-tl.bat} pour Windows. La page +\url{http://tug.org/texlive/acquire.html} donne plus d'informations sur les +différentes façons d'obtenir le logiciel. + +\begin{description} +\item [Installeur réseau] -- à télécharger sur CTAN dans + \dirname{systems/texlive/tlnet}; l'url + \url{http://mirror.ctan.org/systems/texlive/tlnet} vous redirigera + automatiquement vers le serveur d'archive le plus proche de chez vous. + Deux versions sont disponibles, \filename{install-tl.zip} utilisable sous + Unix et Windows, et \filename{install-unx.tar.gz} pour Unix seulement + (y compris \MacOSX). Après décompression de l'un de ces deux fichiers, les + scripts \filename{install-tl} et \filename{install-tl.bat} se trouveront + dans le sous-répertoire \dirname{install-tl}. + +\item [\DVD \TK{}] -- aller dans son répertoire \dirname{texlive}. + Sous Windows, l'installation démarre en principe + automatiquement quand vous insérerez le \DVD, sinon, il faudra exécuter le + script d'installation \filename{install-tl} ou \filename{install-tl.bat}. + Le \DVD \TK{} est distribué gratuitement aux membres des groupes + d'utilisateurs de \TeX{} (Gutenberg par exemple en France, voir la liste + des groupes sur \url{http://tug.org/usergroups.html}). Il est également + possible de l'acheter séparément (\url{http://tug.org/store}) ou de graver + une image \ISO{} téléchargée, voire de la monter directement, sur la plupart + des systèmes. Après avoir installé depuis le \DVD{}, si vous voulez accéder + aux mises à jour en continu depuis Internet, consultez la + section~\ref{sec:dvd-install-net-updates}. +\end{description} + +Le même programme d'installation est utilisé quelle que soit la source +d'installation. La différence la plus visible entre ces deux modes et qu'avec +l'installation par le réseau, vous obtenez les version courantes des +différents paquets, contrairement au \DVD{} (ou image \ISO) qui n'est pas mis +à jour entre deux versions majeures. + +Les sections suivantes expliquent plus en détails le fonctionnement de +l'installateur. + +\subsubsection{Installation sous Unix} + +Dans ce qui suit l'invite du \textit{shell} est notée \texttt{>} ; les +commandes de l'utilisateur sont en \Ucom{\texttt{gras}}. Le programme +\filename{install-tl} est un script Perl ; la façon la plus simple de +le démarrer sur un système Unix est la suivante. +\begin{alltt} +> \Ucom{cd /chemin/de/installateur} +> \Ucom{perl install-tl} +\end{alltt} +(Vous pouvez aussi invoquer \Ucom{perl /chemin/de/installateur/install-tl} ou +\Ucom{./install-tl} si le fichier est toujours exécutable, etc. ; nous ne +répéterons plus toutes ces variantes.) Il est possible que vous deviez +agrandir la fenêtre de votre terminal pour voir le texte complet de +l'installateur (figure~\ref{fig:text-main}). + +Pour travailler en mode graphique expert (figure~\ref{fig:gui-main} -- +attention, le module \dirname{Perl/TK} doit être disponible, avec le support +de \acro{XFT}, ce qui est en général le cas sous \GNU/Linux, mais pas +nécessairement sous d'autres systèmes) : +\begin{alltt} +> \Ucom{cd /chemin/de/installeur} +> \Ucom{./install-tl -gui} +\end{alltt} + +La liste complète des options est donnée par +\begin{alltt} +> \Ucom{perl install-tl -help} +\end{alltt} + +\textbf{Attention} : le matériel installé doit normalement être accessible à +tous les utilisateurs de la machine ; si celui qui installe n'est pas +\textit{root}, il devra s'assurer que son \code{umask} est adapté, par +exemple \code{umask 022} ou \code{umask 002}. +Consulter la documentation système pour plus de précisions. + +\textbf{Remarques particulières pour Cygwin} : contrairement aux autres +système compatibles Unix, Cygwin ne comprend pas par défaut tous les +programmes requis pour faire fonctionner l'installateur \TL. Voir la +section~\ref{sec:cygwin} pour plus de détails. + +\subsubsection{Installation sous Mac\,OS\,X} + +Une distribution spécifique, Mac\TeX\ (\url{http://tug.org/mactex}), a été +mise au point pour \MacOSX. Nous recommandons d'utiliser son installateur +natif, plutôt que d'installer la distribution \TL{} en suivant la procédure +indiquée pour Unix. En effet, Mac\TeX{} comprend des ajustements spécifiques +pour le système \MacOSX{} et facilite la cohabitation entre plusieurs +distributions \TeX{} (Mac\TeX, Fink, MacPorts, etc.). + +Mac\TeX\ est fortement basée sur \TL et les arborescences principales sont en +tous points identiques. Quelques répertoires contenant de la documentation et +des applications spécifiques au Mac sont ajoutés. + +\subsubsection{Installation sous Windows} + +Si vous utilisez l'installeur réseau ou si l'insertion du \DVD{} ne lance pas +l'installation automatiquement, double-cliquez sur \filename{install-tl.bat}. +Pour disposer de plus d'options, par exemple pour sélectionner des collections +de paquets spécifiques au lieu de faire une installation complète, utilisez +plutôt \filename{install-tl-advanced.bat}. + +Il est également possible de travailler en ligne de commande ; +dans ce qui suit l'invite du \textit{shell} est notée \texttt{>}, les +commandes de l'utilisateur sont notées \Ucom{\texttt{en gras}}. Voici les +commandes à lancer : +\begin{alltt} +> \Ucom{install-tl} +\end{alltt} +à condition d'être dans le répertoire du script d'installation, sinon +\begin{alltt} +> \Ucom{D:\bs{}texlive\bs{}install-tl} +\end{alltt} +où \texttt{D:} désigne le lecteur de \DVD où se trouve la collection \TeX. +La figure~\ref{fig:wizard-w32} montre l'installateur en mode magique, qui est +le mode par défaut pour Windows. + +Pour travailler en mode texte : +\begin{alltt} +> \Ucom{install-tl -no-gui} +\end{alltt} +La liste complète des options est donnée par +\begin{alltt} +> \Ucom{install-tl -help} +\end{alltt} + +\begin{figure}[tb] +\begin{boxedverbatim} +Installing TeX Live 2012 from: ... +Platform: i386-linux => 'Intel x86 with GNU/Linux' +Distribution: inst (compressed) +... + Detected platform: Intel x86 with GNU/Linux + + platforms: 1 out of 19 + + installation scheme (scheme-full) + 84 collections out of 85, disk space required: 3091 MB + + Customizing installation scheme: + standard collections + language collections + + directories: + TEXDIR (the main TeX directory): + /usr/local/texlive/2012 + ... + + options: + [ ] use letter size instead of A4 by default + ... + + set up for portable installation + +Actions: + start installation to hard disk + help + quit +\end{boxedverbatim} +\caption{Écran principal de l'installateur en mode texte (\GNU/Linux)}% +\label{fig:text-main} +\end{figure} + +\begin{figure}[tb] +\tlpng{install-lnx-main}{\linewidth, trim=10 4 0 20, clip} +\caption{Installateur graphique en mode expert (\GNU/Linux)} +\label{fig:gui-main} +\end{figure} + +\begin{figure}[tb] +\tlpng{wizard-w32}{\linewidth,trim=0 4 0 0,clip} +\caption{Installateur graphique en mode expert (Windows)} +\label{fig:wizard-w32} +\end{figure} + + +\htmlanchor{cygwin} +\subsubsection{Installation sous Cygwin} +\label{sec:cygwin} + +L'installateur \TL fonctionne uniquement sous Cygwin 1.7. Avant de commencer +l'installation, utilisez le programme \filename{setup.exe} de Cygwin pour +installer les paquets \filename{perl} et \filename{wget} si ce n'est déjà +fait. Il est également recommandé d'installer les paquets suivants : +\begin{itemize*} +\item \filename{fontconfig}, utilisé par \XeTeX ; +\item \filename{ghostscript}, nécessaire pour divers utilitaires ; +\item \filename{libXaw7}, utilisé par \code{xdvi} ; +\item \filename{ncurses}, qui fournit la commande \code{clear} utilisée par + l'installateur. +\end{itemize*} + +\subsubsection{Installation en mode texte} + +La figure~\ref{fig:text-main} présente l'écran principal de configuration en +mode texte sous Unix/Linux, où c'est le mode par défaut. + +Il s'agit d'un installateur en mode ligne de commande, il n'y a pas de notion +de curseur ; par exemple, vous ne pouvez pas naviguer entre les cases à cocher +et les champs d'entrée avec la touche tabulation. Tapez une des lettres proposées +(en respectant la casse) suivie de « entrée » (retour-chariot), l'écran se +mettra automatiquement à jour. + +L'interface est volontairement rudimentaire afin de permettre son utilisation +sur le plus grand nombre possible de systèmes même avec des versions très +dépouillées de Perl. + +\subsubsection{Installation en mode graphique-expert} + +La figure~\ref{fig:gui-main} page~\pageref{fig:gui-main} présente l'écran +principal de configuration en mode graphique sous \GNU/Linux. À part +l'utilisation de boutons et menus, cet installateur ne diffère pas beaucoup de +l'installateur en mode texte. + +Ce mode peut être demandé explicitement avec +\begin{alltt} +> \Ucom{install-tl -gui=perltk} +\end{alltt} + +\subsubsection{L'installation en mode magique} + +Sous Windows, l'installateur démarre par défaut dans le mode le plus simple +que nous avons pu concevoir, le mode « magique » (figure~\ref{fig:wizard-w32}. +Dans ce mode, tout est installé et presque aucune question n'est posée. Par +contre, si vous souhaitez personnaliser votre installation, vous devriez +utiliser un des autres modes. + +Ce mode peut être demandé explicitement avec +\begin{alltt} +> \Ucom{install-tl -gui=wizard} +\end{alltt} + +\subsection{Choix des options d'installation} +\label{sec:runinstall} + +Les options proposées sont censées être assez explicites, voici cependant +quelques précisions. + +\subsubsection{Choix des binaires (Unix seulement)} +\label{sec:binary} + +\begin{figure}[tbh] +\centering +\begin{boxedverbatim} +Available platforms: +=============================================================================== + a [ ] alpha-linux DEC Alpha with GNU/Linux + b [ ] amd64-freebsd x86_64 with FreeBSD + c [ ] amd64-kfreebsd x86_64 with GNU/FreeBSD + d [ ] i386-cygwin Intel x86 with Cygwin + e [ ] i386-freebsd Intel x86 with FreeBSD + f [ ] i386-kfreebsd Intel x86 with GNU/FreeBSD + g [X] i386-linux Intel x86 with GNU/Linux + h [ ] i386-netbsd Intel x86 with NetBSD + i [ ] i386-solaris Intel x86 with Solaris + j [ ] mips-irix SGI IRIX + k [ ] powerpc-aix PowerPC with AIX + l [ ] powerpc-linux PowerPC with GNU/Linux + m [ ] sparc-linux Sparc with GNU/Linux + o [ ] sparc-solaris Sparc with Solaris + p [ ] universal-darwin universal binaries for MacOSX/Darwin + s [ ] win32 Windows + t [ ] x86_64-darwin x86_64 with MacOSX/Darwin + u [ ] x86_64-linux x86_64 with GNU/Linux + v [ ] x86_64-solaris x86_64 with Solaris +\end{boxedverbatim} +\caption{Menu pour le choix des binaires}\label{fig:bin-text} +\end{figure} + +La figure~\ref{fig:bin-text} présente les choix de binaires possibles en mode +texte. Seuls les binaires correspondant à l'architecture détectée seront +installés par défaut. Rien n'empêche d'en sélectionner d'autres si nécessaire, +ce qui peut être intéressant dans le cas de machines en réseau ou sur des +systèmes en « double boot ». + +\subsubsection{Sélection de ce qui va être installé} +\label{sec:components} + +\begin{figure}[tbh] +\centering +\begin{boxedverbatim} +Select scheme: +=============================================================================== + a [X] full scheme (everything) + b [ ] medium scheme (small + more packages and languages) + c [ ] small scheme (basic + xetex, metapost, a few languages) + d [ ] basic scheme (plain and latex) + e [ ] minimal scheme (plain only) + f [ ] ConTeXt scheme + g [ ] GUST TeX Live scheme + h [ ] teTeX scheme (more than medium, but nowhere near full) + i [ ] XML scheme + j [ ] custom selection of collections +\end{boxedverbatim} +\caption{Menu « Scheme »}\label{fig:scheme-text} +\end{figure} + +Dans le menu « Scheme » (voir figure~\ref{fig:scheme-text}) on choisit un +schéma général de configuration qui détermine un ensemble de collections à +installer. Le schéma par défaut (\optname{full}) consiste à tout installer, +ce qui est recommandé. Vous pouvez également choisir \optname{basic} pour un +petit système, \optname{minimal} pour des tests uniquement, \optname{medium} +ou \optname{teTeX} pour quelque chose d'intermédiaire. Il existe aussi des +schémas spécialisés ou spécifiques à un pays. + +\begin{figure}[tbh] +\centering +\tlpng{stdcoll}{.7\linewidth,trim=0 4 0 0,clip} +\caption{Menu « Collections » (Linux)}\label{fig:collections-gui} +\end{figure} + +Une fois choisi le schéma (\eng{scheme}) général, il est possible d'ajouter ou +de supprimer des composants, appelés +ici collections. Il y a deux types de collections : les +« Standard Collections » qui concernent les fontes, les extensions, les +formats, etc. (voir figure~\ref{fig:collections-gui}) et les +« Language Collections » qui permettent de préciser la liste des langues +qui seront utilisables sur le système (indispensable !). Attention, si vous +travaillez en mode texte, dans ces menus la casse des lettres est importante. +En mode graphique, il suffit de cocher ou de décocher les cases en cliquant. + +Il est possible de raffiner encore les choix mais il faudra alors utiliser le +gestionnaire de paquets TeX Live (\prog{tlmgr}) ultérieurement, voir la +section~\ref{sec:tlmgr}. + +\subsubsection{Répertoires d'installation} +\label{sec:directories} + +L'arrangement par défaut des différents répertoire est donné à la +section~\ref{sec:texmftrees}, page~\pageref{sec:texmftrees}. La racine de +l'installation principale, \dirname{TEXDIR}, vaut par défaut +\dirname{/usr/local/texlive/2012} sous Unix et |%SystemDrive%\texlive\2012| +sous Windows. + +Il peut être nécessaire de changer la valeur de \dirname{TEXDIR} +lorsque celui qui procède à l'installation n'a pas les droits d'écriture +sur le répertoire \dirname{TEXDIR} (l'installation n'est pas réservée au +superutilisateur \eng{root} ou « Administrateur », il suffit d'avoir les droits +en écriture sur le répertoire \dirname{TEXDIR}). + +Un autre choix raisonnable est d'installer \TL{} dans votre répertoire +personnel, surtout si vous prévoyez d'en être le seul utilisateur. Vous +pouvez utiliser |~| à cet effet, par exemple |~/texlive/2012|. + +Dans tous les cas, il est recommandé d'inclure l'année dans le chemin afin de +pouvoir conserver plusieurs versions de \TL{} en parallèle. +Rien n'empêche d'ajouter un lien symbolique (par exemple +\dirname{/usr/local/texlive-current}) qui pointe sur la version actuellement +utilisée. Ceci facilite les basculements d'une version à une autre. + +Le répertoire \envname{TEXMFHOME} est destiné à +regrouper les répertoires de macros personnelles. Par défaut, son emplacement +est |~/texmf| ; ici, le |~| est préservé dans les fichiers de configurations +crées, de façon à être remplacé dynamiquement pour chaque utilisateur de \TeX, +par la valeur des variables d'environnement \dirname{\$HOME} sous Unix et +|%USERPROFILE%| sous Windows. +Attention, comme tous les autres répertoires, \envname{TEXMFHOME} doit +respecter la structure \TDS{} ou les fichier ne seront pas trouvés. + +Enfin, \dirname{TEXMFVAR} est l'emplacement où sont stockées les fichiers de +cache spécifiques à chaque utilisateur. \dirname{TEXMFCACHE} est utilisé par +\ConTeXt\ Mk\acro{IV} pour le même but (voir la section~\ref{sec:context-mkiv} +page~\pageref{sec:context-mkiv}). + +\subsubsection{Options} +\label{sec:options} + +\begin{figure}[tbh] +\begin{boxedverbatim} +Options setup: +=============================================================================== +

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