summaryrefslogtreecommitdiff
path: root/info/latex2e-help-texinfo-fr/latex2e-fr.dbk
diff options
context:
space:
mode:
Diffstat (limited to 'info/latex2e-help-texinfo-fr/latex2e-fr.dbk')
-rw-r--r--info/latex2e-help-texinfo-fr/latex2e-fr.dbk6836
1 files changed, 5631 insertions, 1205 deletions
diff --git a/info/latex2e-help-texinfo-fr/latex2e-fr.dbk b/info/latex2e-help-texinfo-fr/latex2e-fr.dbk
index 8771be8b35..70a500266a 100644
--- a/info/latex2e-help-texinfo-fr/latex2e-fr.dbk
+++ b/info/latex2e-help-texinfo-fr/latex2e-fr.dbk
@@ -4,16 +4,26 @@
<!ENTITY latex "LaTeX">
]>
<book id="latex2e-fr.dbk" lang="fr">
-<title>manuel de référence officieux de &latex;2e (Août 2017)</title>
+<!-- $Id: common.texi 729 2018-11-13 23:22:27Z karl $ -->
+<!-- Public domain. -->
+
+<title>Manuel de référence officieux de &latex;2e (Septembre 2020)</title>
<!-- % ** fin de tête (c'est pour courir Texinfo sur une région.) -->
<!-- latex 2.09 commandes devraient tous être présents maintenant, -->
+<!-- xx À faire: -->
+<!-- - -shell-escape & -file-line-no pris en charge par MiKTeX -->
+<!-- - exemple pdflatex -interaction=nonstopmode -file-line-error '\documentclass{minimal}\begin{document}\errmessage{Foirage}Salut\end{document}' -->
+<!-- => le jobname est minimal, créer un nœud sur jobname -->
+<!-- => style de message d'erreur traditionnel, car on n'est pas dans un fichier -->
+<!-- => ajouter un nœud sur \errmessage -->
+<!-- -->
+<!-- - ajouter @node Colon character & \colon -->
+<!-- -->
<!-- xx mais LaTeX2e substance est manquant. -->
<!-- xx une liste aléatoire de quelques items manquant est à la fin de ce fichier -->
+<!-- xx Lire le fichier NEWS pour les choses à mettre à jour. -->
<!-- -->
-<!-- xx misc commands from clsguide.pdf: MakeUpperCase, \ignorespacesafterend, -->
-<!-- \normalsfcodes -->
-<!-- xx color (include info from clsguide.pdf) -->
<!-- xx ending a run with errors -->
<!-- xx ctan, distributions, composant de TeX -->
<!-- xx mention \nocorr, \textit et ic -->
@@ -25,10 +35,21 @@
<!-- xx fusionner style mathématique hors texte -->
<!-- xx mode veritical, mode horizontal -->
<!-- -->
+<!-- -->
+<!-- -->
+<!-- xx Notes de P. Bideault -->
+<!-- -->
+<!-- xx Le sommaire précède immédiatement la table des matières. C'est curieux, -->
+<!-- xx C'est curieux, et perturbant. -->
+<!-- xx Cette table des matières ne serait-elle mieux située en fin de document ? -->
+<!-- -->
+<!-- -->
+<!-- -->
<!-- xx Le source2e typographie a un index avec tous noyau -->
<!-- commandes xx, même si certains sont internes et ne devraient pas être inclus. -->
<!-- xx classes.dtx et al. définir des commandes supplémentaires. -->
<!-- xx Voir aussi http://ctan.org/pkg/macros2e. -->
+<!-- xx Tous les caractères spéciaux devraient une fois pour toute être dérits -->
<!-- -->
<!-- packages xx - requis, plus, utile; Oberdiek; polices -->
@@ -40,32 +61,32 @@
<!-- -->
<!-- Autres ressources: -->
<!-- https://www.latex-project.org/help/books/lc2fr-apb.pdf -->
+<!-- http://mirror.ctan.org/info/impatient/fr/fbook.pdf -->
<bookinfo><legalnotice><para>Ce document est un manuel de référence officieux pour &latex;, un
-système de préparation de documents, version « Août 2017 ».
+système de préparation de documents, version « Septembre 2020 ».
</para>
<para>Ce manuel a été traduit du fichier <filename>LATEX.HLP</filename> v1.0a de la
-bibliothèque d&#8217;aide VMS. La version pré-traduction a été rédigé par
-George D. Greenwade de Sam Houston State University. La version
+bibliothèque d&#8217;aide VMS. La version pré-traduction a été rédigée par
+George D. Greenwade de l&#8217;université d&#8217;État Sam Houston, au Texas (USA). La version
&latex; 2.09 a été rédigée par Stephen Gilmore. La version &latex;2e a
-été adapté à partir de cellce-ci par Torsten Martinsen. Karl Berry a
+été adaptée à partir de celle-ci par Torsten Martinsen. Karl Berry a
fait d&#8217;autres mises à jour et ajouts, et reconnaît avec gratitude avoir
utilisé <citetitle>Hypertext Help with &latex;</citetitle>, de Sheldon Green, et
<citetitle>&latex; Command Summary</citetitle> (pour &latex;2.09) de L. Botway et
C. Biemesderfer (publié par le &tex; Users Group en tant que
-<citetitle>&tex;niques</citetitle> numéro 10), il l&#8217;a utilisé en tant que matériel de
-référence (aucun texte n&#8217;était directement copié).
+<citetitle>&tex;niques</citetitle> numéro 10) ; il a utilisé ces documents en tant que matériel de
+référence et n&#8217;en a copié aucun texte directement.
</para>
-<para>Tous droits réservés &#169; 2015-2017 Vincent Belaïche &#8212; traduction.
+<para>Tous droits réservés &#169; 2015-2020 Vincent Belaïche &#8212; traduction.
-Tous droits réservés &#169; 2007, 2008, 2009, 2010, 2011, 2012, 2013,
-2014, 2015, 2016, 2017 Karl Berry.
+Tous droits réservés &#169; 2007-2020 Karl Berry.
Tous droits réservés &#169; 1988, 1994, 2007 Stephen Gilmore.
Tous droits réservés &#169; 1994, 1995, 1996 Torsten Martinsen.
</para>
-<para>Ci-après se trouve la licence sous laquelle est distribuée ce manuel,
+<para>Ci-après se trouve la licence sous laquelle est distribuée ce manuel ;
une traduction en est donnée en annexe, voir <link linkend="License-translation">License translation</link>.
</para>
<!-- start of License -->
@@ -86,30 +107,29 @@ into another language, under the above conditions for modified versions.
<para>Ce document est un manuel de référence officieux pour &latex;, un
-système de préparation de documents, version « Août 2017 ».
+système de préparation de documents, version « Septembre 2020 ».
</para>
<para>Ce manuel a été traduit du fichier <filename>LATEX.HLP</filename> v1.0a de la
-bibliothèque d&#8217;aide VMS. La version pré-traduction a été rédigé par
-George D. Greenwade de Sam Houston State University. La version
+bibliothèque d&#8217;aide VMS. La version pré-traduction a été rédigée par
+George D. Greenwade de l&#8217;université d&#8217;État Sam Houston, au Texas (USA). La version
&latex; 2.09 a été rédigée par Stephen Gilmore. La version &latex;2e a
-été adapté à partir de cellce-ci par Torsten Martinsen. Karl Berry a
+été adaptée à partir de celle-ci par Torsten Martinsen. Karl Berry a
fait d&#8217;autres mises à jour et ajouts, et reconnaît avec gratitude avoir
utilisé <citetitle>Hypertext Help with &latex;</citetitle>, de Sheldon Green, et
<citetitle>&latex; Command Summary</citetitle> (pour &latex;2.09) de L. Botway et
C. Biemesderfer (publié par le &tex; Users Group en tant que
-<citetitle>&tex;niques</citetitle> numéro 10), il l&#8217;a utilisé en tant que matériel de
-référence (aucun texte n&#8217;était directement copié).
+<citetitle>&tex;niques</citetitle> numéro 10) ; il a utilisé ces documents en tant que matériel de
+référence et n&#8217;en a copié aucun texte directement.
</para>
-<para>Tous droits réservés &#169; 2015-2017 Vincent Belaïche &#8212; traduction.
+<para>Tous droits réservés &#169; 2015-2020 Vincent Belaïche &#8212; traduction.
-Tous droits réservés &#169; 2007, 2008, 2009, 2010, 2011, 2012, 2013,
-2014, 2015, 2016, 2017 Karl Berry.
+Tous droits réservés &#169; 2007-2020 Karl Berry.
Tous droits réservés &#169; 1988, 1994, 2007 Stephen Gilmore.
Tous droits réservés &#169; 1994, 1995, 1996 Torsten Martinsen.
</para>
-<para>Ci-après se trouve la licence sous laquelle est distribuée ce manuel,
+<para>Ci-après se trouve la licence sous laquelle est distribuée ce manuel ;
une traduction en est donnée en annexe, voir <link linkend="License-translation">License translation</link>.
</para>
<!-- start of License -->
@@ -131,12 +151,11 @@ into another language, under the above conditions for modified versions.
<!-- Best Effort Symbol -->
-
<chapter label="" id="Top">
<title>&latex;2e : un manuel de référence officieux</title>
<para>Ce document est un manuel de référence officieux pour &latex;2e, un
-système de préparation de document, dans sa version « Août 2017 ».
+système de préparation de document, dans sa version « Septembre 2020 ».
</para>
@@ -144,14 +163,14 @@ système de préparation de document, dans sa version « Août 2017 ».
<chapter label="1" id="About-this-document">
<title>À propos de ce document</title>
-<indexterm role="fn"><primary><ulink url="http://puszcza.gnu.org.ua/software/latexrefman/">http://puszcza.gnu.org.ua/software/latexrefman/</ulink> page d&#8217;accueil</primary></indexterm>
+<indexterm role="fn"><primary><ulink url="https://latexref.xyz">https://latexref.xyz</ulink> page d&#8217;accueil</primary></indexterm>
<para>Ceci est un manuel de référence officieux pour le système &latex;2e de
-préparation de document, ce système est mis en oeuvre sous forme d&#8217;un
+préparation de document. Ce système est mis en œuvre sous forme d&#8217;un
paquet de macros pour le programme de composition &tex;
-(voir <link linkend="Overview">Overview</link>). La page d&#8217;accueil de ce document est
-<ulink url="http://puszcza.gnu.org.ua/software/latexrefman/">http://puszcza.gnu.org.ua/software/latexrefman/</ulink>. Cette page contient des liens vers
-les produits courants de fabrication du document dans différents
-formats, les sources, les listes de diffusion, et d&#8217;autres
+(see <link linkend="Overview">Overview</link>). La page d&#8217;accueil de ce document est
+<ulink url="https://latexref.xyz">https://latexref.xyz</ulink>. Cette page contient des liens vers
+différentes versions de ce document, dans différents
+formats et langues, mais aussi vers ses sources, vers les archives des listes de diffusion qui lui sont consacrées ainsi que vers d&#8217;autres
infrastructures.
</para>
<indexterm role="cp"><primary>&latex; ou &latex;2e, que choisir ?</primary></indexterm>
@@ -172,11 +191,14 @@ par les mainteneurs de &latex;.
<indexterm role="cp"><primary>bogues, rapports</primary></indexterm>
<indexterm role="cp"><primary>anomalies, rapports</primary></indexterm>
Ne leur envoyez donc pas de rapports d&#8217;anomalie ou quoi que ce soit
-d&#8217;autre. Au lieu de cela, s&#8217;il vous plaît envoyez tous commentaires à
+d&#8217;autre.
+</para>
+<para>En revanche, n&#8217;hésitez pas à adresser vos commentaires à
<email>latexrefman@tug.org</email>.
</para>
-<para>Ce document est un manuel de référence. Il y a une vaste gamme d&#8217;autres sources d&#8217;information sur
-&latex;, de tous niveaux. Voici quelques introductions :
+<para>Ce document est un manuel de référence. Il y a d&#8217;autres sources d&#8217;information sur
+&latex; : elles sont très nombreuses, et s&#8217;adressent à des utilisateurs de tous niveaux.
+Voici quelques introductions :
</para>
<!-- voir http://mirror.ctan.org/help/ctan/CTAN-upload-addendum.html#urls -->
<variablelist><varlistentry><term><ulink url="http://ctan.org/pkg/latex-doc-ptr">http://ctan.org/pkg/latex-doc-ptr</ulink>
@@ -215,28 +237,34 @@ est un.
<indexterm role="cp"><primary>Knuth, Donald E.</primary></indexterm>
<indexterm role="cp"><primary>Lamport, Leslie</primary></indexterm>
<indexterm role="cp"><primary>&latex; aperçu</primary></indexterm>
-<para>&latex; est un système de composition de document. Il fut à l&#8217;origine
-créé par Leslie Lamport et est desormais maintenu par un groupe de
+<para>&latex; est un système de composition de documents. Il fut à l&#8217;origine
+créé par Leslie Lamport ; il est désormais maintenu par un groupe de
volontaires (<ulink url="http://latex-project.org">http://latex-project.org</ulink>). Il est largement utilisé,
en particulier pour les documents complexes et techniques, tels que ceux
impliquant des mathématiques.
</para>
+<!-- - Au début, ajout de « à l'aide d'un simple éditeur de texte ». -->
+<!-- - Emploi d'italiques pour les notions principales. -->
+<!-- - À la fin, ajout de « qui contient son texte mis en page ». -->
<indexterm role="cp"><primary>paquet de macro, &latex; en tant que</primary></indexterm>
-<para>Un utilisateur &latex; écrit un fichier d&#8217;entrée contenant le texte
-d&#8217;un document avec des commandes qui y sont intercalées pour décrire
-comment le texte doit être formaté. &latex; est mis en œuvre comme un
+<para>À l&#8217;aide d&#8217;un simple éditeur de texte,
+un utilisateur &latex; écrit un fichier, dit <emphasis>fichier d&#8217;entrée</emphasis>,
+qui contient son texte ; des <emphasis>commandes</emphasis> y sont intercalées :
+ce sont des instructions servant à décrire la manière dont le texte
+doit être formaté. En effet, &latex; est mis en œuvre comme un
ensemble de commandes liées s&#8217;interfaçant avec le programme de
composition &tex; de Donald E. Knuth (le terme technique est que
&latex; est un <firstterm>paquet de macros</firstterm> pour le moteur &tex;).
-L&#8217;utilisateur produit le document de sortie en donnant ce fichier
-d&#8217;entrée au moteur &tex;.
+En donnant le fichier d&#8217;entrée au moteur &tex;,
+l&#8217;utilisateur produit le <emphasis>document de sortie</emphasis>
+qui contient son texte mis en page.
</para>
<!-- - Les fichiers @LaTeX{} sont des fichiers texte ordinaires qui -->
<!-- - peuvent être écrits avec n'importe quel éditeur de texte aux -->
<!-- - performances raisonnables. -->
<para>Le terme &latex; est aussi parfois utilisé pour signifier le langage à
-balises dans lequel le code source du document est écrit, c.-à-d. pour
+balises dans lequel le code source du document est écrit, c&#8217;est-à-dire pour
signifier l&#8217;ensemble des commandes à la disposition d&#8217;un utilisateur de
&latex;.
</para>
@@ -245,7 +273,7 @@ signifier l&#8217;ensemble des commandes à la disposition d&#8217;un utilisateu
<para>Le nom &latex; est l&#8217;abréviation de &#8220;Lamport &tex;&#8221;. On le prononce
LA-TÈQUE. Au sein du document, on produit le logo avec <literal>\LaTeX</literal>.
Là où l&#8217;utilisation du logo n&#8217;est pas raisonnable, comme dans du texte
-brut, écrivez le &#8216;<literal>LaTeX</literal>&#8217;.
+brut, écrivez-le &#8216;<literal>LaTeX</literal>&#8217;.
</para>
@@ -258,7 +286,8 @@ brut, écrivez le &#8216;<literal>LaTeX</literal>&#8217;.
<indexterm role="cp"><primary>Bonjour le monde</primary></indexterm>
<para>Les fichiers &latex; ont une structure globale simple, avec un début et
-une fin standards. Voici un exemple « Bonjour le monde » :
+une fin standards. Voici un exemple : il s&#8217;agit d&#8217;obtenir un document
+contenant la phrase « Bonjour le monde ».
</para>
<screen>\documentclass{article}
\begin{document}
@@ -266,11 +295,11 @@ Bonjour le monde \LaTeX.
\end{document}
</screen>
<indexterm role="cp"><primary>classe de document, définition</primary></indexterm>
-<para>Ici &#8216;<literal>article</literal>&#8217; et ce qu&#8217;on appelle la <firstterm>classe de document</firstterm>,
-implémentée dans une fichier <filename>article.cls</filename>. N&#8217;importe quelle classe
+<para>Ici &#8216;<literal>article</literal>&#8217; est ce que l&#8217;on appelle la <firstterm>classe de document</firstterm> ;
+elle est implémentée dans une fichier <filename>article.cls</filename>. N&#8217;importe quelle classe
de document peut être utilisée. Quelques classes de document sont
définies par &latex; lui-même, et un grand nombre d&#8217;autres sont
-largement disponibles. Voir <link linkend="Document-classes">Document classes</link>.
+largement disponibles. See <link linkend="Document-classes">Document classes</link>.
</para>
<indexterm role="cp"><primary>préambule, définition</primary></indexterm>
<para>Vous pouvez inclure d&#8217;autres commandes &latex; entre les commandes
@@ -281,12 +310,13 @@ appelée le <firstterm>préambule</firstterm>).
<indexterm role="cp"><primary>environnement</primary></indexterm>
appelle un <firstterm>environnement</firstterm> ; l&#8217;environnement &#8216;<literal>document</literal>&#8217; (et
aucun autre) est obligatoire dans tous les documents &latex;
-(voir <link linkend="document">document</link>). &latex; fournit lui-même beaucoup
+(see <link linkend="document">document</link>). &latex; fournit lui-même beaucoup
d&#8217;environnements, et bien plus encore sont définis séparément.
-Voir <link linkend="Environments">Environments</link>.
+See <link linkend="Environments">Environments</link>.
</para>
-<para>Les rubriques suivantes discutent de la façon de produire des PDF et
-d&#8217;autres format de sortie à partir d&#8217;un fichier d&#8217;entrée &latex;.
+<para>Les rubriques suivantes sont consacrées aux façons de produire,
+à partir d&#8217;un fichier d&#8217;entrée &latex;, des documents PDF ou
+d&#8217;autres formats.
</para>
</sect1>
@@ -304,25 +334,25 @@ soit en <filename>.dvi</filename> soit en <filename>.pdf</filename>.
<indexterm role="fn"><primary>commande dvips</primary></indexterm>
<indexterm role="fn"><primary>commande dvipdfmx</primary></indexterm>
<indexterm role="fn"><primary>commande dvitype</primary></indexterm>
-<para>Si il est invoqué avec la commande système <command>latex</command>, alors il
+<para>S&#8217;il est invoqué avec la commande système <command>latex</command>, alors il
produit un fichier « DeVice Independent<footnote><para>Indépendant du
périphérique de sortie, ce n&#8217;est toutefois pas un format portable de
document</para></footnote> » (<filename>.dvi</filename>). Vous pouvez visualiser ce fichier avec une
commande comme <command>xdvi</command>, ou le convertir en fichier PostScript
<literal>.ps</literal> avec <command>dvips</command> ou en fichier « Portable Document
Format<footnote><para>Format portable de document</para></footnote> » <literal>.pdf</literal> avec
-<command>dvipdfmx</command>. Un grand nombre d&#8217;autres progammes utilitaires DVI
-sont disponibles (<ulink url="http://mirror.ctan.org/dviware">http://mirror.ctan.org/dviware</ulink>).
+<command>dvipdfmx</command>. Un grand nombre d&#8217;autres progammes utilitaires
+pour fichiers DVI sont disponibles (<ulink url="http://mirror.ctan.org/dviware">http://mirror.ctan.org/dviware</ulink>).
</para>
</listitem></varlistentry><varlistentry><term><literal>.pdf</literal>
</term><listitem><indexterm role="fn"><primary>.pdf fichier</primary></indexterm>
<indexterm role="cp"><primary>pdf&tex;</primary></indexterm>
<indexterm role="fn"><primary>commande pdflatex</primary></indexterm>
<para>Si &latex; est invoqué avec la commande système <command>pdflatex</command>,
-parmi d&#8217;autres commandes (voir <link linkend="TeX-engines">&tex; engines</link>), alors la sortie
-principale est un fichier &#8220;Portable Document Format&#8221;
+alors la sortie principale est un fichier &#8220;Portable Document Format&#8221;
(<filename>.pdf</filename>). Typiquement, il s&#8217;agit d&#8217;un fichier autonome, avec toutes
les polices et images incorporées.
+D&#8217;autres commandes (see <link linkend="TeX-engines">&tex; engines</link>) produisent des fichiers PDF.
</para>
<!-- - Cela peut être très utile, mais cela rend le fichier de sortie beaucoup -->
<!-- - plus grand que le fichier @file{.dvi} produit à partir du même document. -->
@@ -351,7 +381,7 @@ les polices et images incorporées.
informations sommaires telles que la liste des paquetages chargés. Il
contient aussi des messages de diagnostic
<!-- - pour toutes les erreurs découvertes dans le fichier d'entrée. -->
-et possiblement des informations supplémentaires concernant toutes
+et, possiblement, des informations supplémentaires concernant toutes
erreurs.
</para>
</listitem></varlistentry><varlistentry><term><literal>.aux</literal>
@@ -363,12 +393,12 @@ erreurs.
<para>De l&#8217;information auxiliaire est utilisée par &latex; pour des choses
telles que les doubles renvois. Par exemple, la première fois que
&latex; trouve un renvoi en aval &#8212; une double référence à
-quelque-chose qui n&#8217;est pas encore apparu dans le code source &#8212; il
+quelque chose qui n&#8217;est pas encore apparu dans le code source &#8212; il
apparaîtra dans la sortie comme un double point d&#8217;interrogation
<literal>??</literal>. Quand l&#8217;endroit auquel le renvoi fait référence finit par
-appraître dans le code source, alors &latex; écrit son information de
+apparaître dans le code source, alors &latex; écrit son information de
localisation dans ce fichier <literal>.aux</literal>. À l&#8217;invocation suivante,
-&latex; lit l&#8217;inforlation de localisation à partir de ce fichier et
+&latex; lit l&#8217;information de localisation à partir de ce fichier et
l&#8217;utilise pour résoudre le renvoi, en remplaçant le double point
d&#8217;interrogation avec la localisation mémorisée.
</para>
@@ -402,9 +432,9 @@ fin définie.
<indexterm role="cp"><primary>entrée Unicode, native</primary></indexterm>
<indexterm role="cp"><primary>polices TrueType</primary></indexterm>
<indexterm role="cp"><primary>polices OpenType</primary></indexterm>
-<para>&latex; est défini comme un ensemble de commande qui sont exécutées par
-une implémentation &tex; (voir <link linkend="Overview">Overview</link>). Cette section donne une
-vue d&#8217;ensemble laconique des principaux programmes.
+<para>&latex; est défini comme un ensemble de commandes qui sont exécutées par
+une implémentation &tex; (see <link linkend="Overview">Overview</link>). Cette section donne une
+brève vue d&#8217;ensemble des principaux programmes.
</para>
<variablelist><varlistentry><term><literal>latex</literal>
</term><term><literal>pdflatex</literal>
@@ -437,9 +467,9 @@ l&#8217;hyptohèse que les extension e-&tex; sont disponibles en &latex;.
<para>Si &latex; est invoqué avec la commandes systèmes <command>lualatex</command>,
alors le moteur Lua&tex; est exécuté
(<ulink url="http://ctan.org/pkg/luatex">http://ctan.org/pkg/luatex</ulink>). Ce programme permet que du code
-écrit dans le langage script Lua (<ulink url="http://luatex.org">http://luatex.org</ulink>) intéragisse
+écrit dans le langage script Lua (<ulink url="http://luatex.org">http://luatex.org</ulink>) interagisse
avec la compostion faite par &tex;. Lua&tex; traite nativement
-l&#8217;entrée en Unicode UTF-8, peut traiter les polices OpenType et
+l&#8217;entrée en codage Unicode UTF-8, peut traiter les polices OpenType et
TrueType, et produit un fichier <filename>.pdf</filename> par défaut. Il y a aussi
<command>dvilualatex</command> pour produire un fichier <filename>.dvi</filename>, mais cela
est rarement utilisé.
@@ -451,10 +481,10 @@ est rarement utilisé.
<indexterm role="fn"><primary>xdvipdfmx</primary></indexterm>
<para>Si &latex; est invoqué avec la commandes système <command>xelatex</command>, le
moteur Xe&tex; est exécuté (<ulink url="http://tug.org/xetex">http://tug.org/xetex</ulink>). Comme
-Lua&tex;, Xe&tex; prend en charge nativement UTF-8 Unicode et les
-polices TrueType et OpenType, bien que l&#8217;implementation soit
-complètement différente, utilisant principalement des bibliothèque
-externe plutôt que du code interne. Xe&tex; produit un fichier <filename>.pdf</filename>
+Lua&tex;, Xe&tex; prend en charge nativement le codage Unicode UTF-8 et les
+polices TrueType et OpenType, bien que leur implémentation soit
+complètement différente, en utilisant principalement des bibliothèques
+externes plutôt que du code interne. Xe&tex; produit un fichier <filename>.pdf</filename>
en sortie ; il ne prend pas en charge la sortie DVI.
</para>
<para>En interne, Xe&tex; crée un fichier <literal>.xdv</literal> file, une variante de
@@ -463,8 +493,8 @@ programme (<literal>x</literal>)<literal>dvipdfmx</literal>, mais ce processus e
Le fichier <literal>.xdv</literal> n&#8217;est utile que pour le débogage.
</para>
</listitem></varlistentry></variablelist>
-<para>D&#8217;autres vairantes de &latex; et &tex; existent, par ex. pour fournir
-une prise en charge supplémentaires du japonais des d&#8217;autres langages
+<para>D&#8217;autres variantes de &latex; et &tex; existent, par exemple pour fournir
+une prise en charge supplémentaire du japonais et d&#8217;autres langages
([u]p&tex;, <ulink url="http://ctan.org/pkg/ptex">http://ctan.org/pkg/ptex</ulink>,
<ulink url="http://ctan.org/pkg/uptex">http://ctan.org/pkg/uptex</ulink>).
</para>
@@ -478,41 +508,53 @@ une prise en charge supplémentaires du japonais des d&#8217;autres langages
<indexterm role="fn"><primary>[...] pour les arguments optionnels</primary></indexterm>
<indexterm role="fn"><primary>{...} pour les arguments obligatoires</primary></indexterm>
<para>Dans le fichier d&#8217;entrée &latex;, un nom de commande commence avec une
-contr&#8217;oblique, <literal>\</literal>. Le nom lui-même consiste soit en (a) une
-chaîne de lettres ou (b) une unique non-lettre.
+contre-oblique, <literal>\</literal>. Le nom lui-même consiste soit en (a) une
+chaîne de lettres ou (b) un unique caractère, qui dans ce cas n&#8217;est pas une lettre.
</para>
<para>Les noms de commandes &latex; sont sensibles à la casse de sorte que
<literal>\pagebreak</literal> diffère de <literal>\Pagebreak</literal> (ce dernier n&#8217;est pas une
-commande standarde). La plupart des noms de commandes sont en bas de
-casse, mais en tout cas vous devez saisir toutes les commandes dans la
-même casse où elles sont définies.
+commande standard). La plupart des noms de commandes sont en bas de
+casse, mais elles sont sensibles à la casse : vous devez toujours saisir
+les commandes en respectant la casse où elles ont été définies.
</para>
<para>Une commande peut être suivie de zéro, un ou plus d&#8217;arguments. Ces
arguments peuvent être soit obligatoires, soit optionnels. Les
arguments obligatoires sont entre accolades, <literal>{...}</literal>. Les
-arguments optionnels sont entre crochets, <literal>[...]</literal>. En général,
-mais ce n&#8217;est pas universel, si la commande prend un argument optionnel,
+arguments optionnels sont entre crochets, <literal>[...]</literal>. En général
+(mais ce n&#8217;est pas universel), si la commande prend un argument optionnel,
il vient en premier, avant tout argument obligatoire.
</para>
<para>Au sein d&#8217;un argument optionnel, pour utiliser le crochet
-fermant (<literal>]</literal>) cachez le au sein d&#8217;accolades, comme
+fermant (<literal>]</literal>) cachez-le au sein d&#8217;accolades, comme
dans <literal>\item[crochet fermant {]}]</literal>. De même, si un argument
optionnel vient en dernier, sans argument obligatoire à sa suite, alors
-pour qie le premier caractère dans le texte suivant soit un crochet
-ouvrant, cachez le entre accolades.
+pour que le premier caractère dans le texte suivant soit un crochet
+ouvrant, cachez-le entre accolades.
</para>
-<para>&latex; a la convetion que certaines commandes ont une forme en a
-<literal>*</literal> qui est en relation avec la forme sans le <literal>*</literal>, telles que
+<para>&latex; obéit à la convention selon laquelle certaines commandes ont une forme étoilée
+(<literal>*</literal>) qui est en relation avec la forme sans le <literal>*</literal>, telles que
<literal>\chapter</literal> et <literal>\chapter*</literal>. La différence exacte de
comportement dépend de la commande.
</para>
-<para>Ce manuel décrit toutes les options accepté et les formes en <literal>*</literal>
-pour les commandes dont il traite (à l&#8217;exeption des omissions
-involontaires, ou bogues de ce manuel).
+<para>Ce manuel décrit toutes les options acceptées et les formes en <literal>*</literal>
+pour les commandes dont il traite (à l&#8217;exception des omissions
+involontaires ou bogues de ce manuel).
</para>
+<!-- xxx Revoir le menu -->
+
-<sect2 label="2.4.1" id="Environment">
+<sect2 label="2.4.1" id="Declaration">
+<title>Les déclarations de commandes</title>
+
+<para>Certaines commandes changent la valeur ou la signification d&#8217;une
+autre commande ou d&#8217;un paramètre. Par exemple, la commande <literal>\mainmatter</literal>
+change le réglage de la numérotation des pages en passant de chiffres
+romains à des chiffres arabes.
+</para>
+</sect2>
+</sect1>
+<sect1 label="2.5" id="Environment">
<title>Les environnements</title>
<para>Synopsis :
@@ -526,376 +568,64 @@ comportement différent. Par exemple, pour la poésie en &latex; mettez
les lignes entre <literal>\begin{verse}</literal> et <literal>\end{verse}</literal>.
</para>
<screen>\begin{verse}
- There once was a man from Nantucket \\
+ Plus ne suis ce que j'ai été \\
...
\end{verse}
</screen>
<para>Voir <link linkend="Environments">Environments</link> pour une liste des environnements.
</para>
-<para>Le <replaceable>nom environnement</replaceable> au début doit s&#8217;accorder exactement avec
-celui à la fin. Ceci comprend le cas où <replaceable>nom environnement</replaceable> se
-termine par une étoile(<literal>*</literal>) ; l&#8217;argument à la fois de
+<para>Le <replaceable>nom environnement</replaceable> du début doit s&#8217;accorder exactement avec
+celui de la fin. Cela vaut aussi dans le cas où <replaceable>nom environnement</replaceable> se
+termine par une étoile (<literal>*</literal>) ; l&#8217;argument à la fois de
<literal>\begin</literal> et <literal>\end</literal> doit comprendre l&#8217;étoile.
</para>
<para>Les environnements peuvent avoir des arguments, y compris des arguments
optionnels. L&#8217;exemple ci-dessous produit un tableau. Le premier
-argument est optionnel (et implique de la table est alignée
-verticalement sur sa première ligne) alors que le second argument et
-obligatoire (il spécifie le format des colonnes).
+argument est optionnel (il aligne verticalement le tableau
+sur sa première ligne) alors que le second argument est
+obligatoire (il spécifie le format des colonnes du tableau).
</para>
<screen>\begin{tabular}[t]{r|l}
... lignes du tableau ...
\end{tabular}
</screen>
+</sect1>
+<sect1 label="2.6" id="CTAN">
+<title>CTAN : The Comprehensive &tex; Archive Network</title>
-</sect2>
-<sect2 label="2.4.2" id="Declaration">
-<title>Les déclarations de commandes</title>
-
-<para>Une commande qui change la valeur, ou change la signification, d&#8217;une
-autre commande ou paramètre. Par exemple, la commande <literal>\mainmatter</literal>
-change le réglage de la numérotation des pages en passant de numéros
-romains à des numéros arabes.
-</para>
-</sect2>
-<sect2 label="2.4.3" id="_005cmakeatletter-and-_005cmakeatother">
-<title><literal>\makeatletter</literal> et <literal>\makeatother</literal></title>
-
-<para>Synopsis :
-</para>
-<screen>\makeatletter
- ... définition de commande comprenant @ dans leur nom ..
-\makeatother
-</screen>
-<para>Utilisé pour redéfinir des commandes internes de &latex;.
-<literal>\makeatletter</literal> a pour effet que le caractère arobe <literal>@</literal> ait
-le code de catégorie des lettres, c.-à-d. 11. <literal>\makeatother</literal>
-règle de code de catégorie de <literal>@</literal> à 12, sa valeur d&#8217;origine.
-</para>
-<para>À mesure que chaque caractère est lu par &tex; pour &latex;, un code
-de catégorie lui est assigné. On appelle aussi ce code
-<indexterm role="cp"><primary>catcode</primary></indexterm>
-<indexterm role="cp"><primary>code de catégorie de caractère</primary></indexterm>
-<indexterm role="cp"><primary>catégorie, code de &#8230; de caractère</primary></indexterm>
-<firstterm>catcode</firstterm> pour faire court. Par exemple, la contr&#8217;oblique <literal>\</literal>
-reçoit le catcode 0, qui correspond aux catactères qui commencent une
-commande. Ces deux commandes altèrent le catcode assigné à <literal>@</literal>.
-</para>
-<para>Cette altération est nécessaire parce que beaucoup des commandes de
-&latex; utilisent <literal>@</literal> dans leur nom, de sorte à empécher les
-utilisateurs de définir accidentellement une commande qui remplacerait
-l&#8217;une des commandes privées de &latex;. Les noms de commandes
-consistent en un caractère de catégorie 0, d&#8217;ordinaire une
-contr&#8217;oblique, suivi de lettres, c.-à-d. des caractères de
-catégorie 11 (à ceci près q&#8217;un nom de commande peut aussi consister d&#8217;un
-catactère de catégorie 0 suivi d&#8217;un seul symbole non-lettre). Ainsi sous
-le régime par défaut de codes de catégorie, les commandes définies par
-l&#8217;utilisateur ne peuvent pas contenir de <literal>@</literal>. Mais
-<literal>\makeatletter</literal> et <literal>\makeatother</literal> permettent aux utilisateurs
-de définir et re-définir des commandes dont le nom comprend un
-<literal>@</literal>.
-</para>
-<para>À utiliser dans un fichier <filename>.tex</filename>, dans le préambule. Ne pas
-utiliser dans des fichiers <filename>.sty</filename> ou <filename>.cls</filename> puisque les
-commandes <literal>\usepackage</literal> et <literal>\documentclass</literal> règlent le code de
-catégorie de l&#8217;arobe à celui d&#8217;une lettre.
-</para>
-<indexterm role="fn"><primary>paquetage <literal>macros2e</literal></primary></indexterm>
-<indexterm role="fn"><primary><literal>macros2e</literal>, paquetage</primary></indexterm>
-<para>Pour une liste complète des macros contenant un arobe dans leur nom,
-voir le document <ulink url="http://ctan.org/pkg/macros2e">http://ctan.org/pkg/macros2e</ulink>. Ces macros sont
-surtout à l&#8217;intention des auteurs de classes et de paquetages.
-</para>
-<!-- xxxx TODO : ajouter une avertissement sur cet exemple. -->
-<para>L&#8217;exemple ci-après est typique. Une commande
-<literal>\these@nomuniversite</literal> se trouve dans le fichier de classe de
-l&#8217;utilisateur. L&#8217;utilisateur veut changer sa définition. Pour cela, il
-suffit d&#8217;insérer les trois lignes suivantes dans le préambule, avant le
-<literal>\begin{document}</literal> :
-</para>
-<screen>\makeatletter
-\renewcommand{\these@nomuniversite}{Université Lyon III Jean Moulin}
-\makeatother
-</screen>
-
-
-
-<sect3 label="2.4.3.1" id="_005c_0040startsection">
-<title><literal>\@startsection</literal></title>
+<indexterm role="cp"><primary>CTAN</primary></indexterm>
-<para>Synopsis :
+<para>Le &#171;Comprehensive &tex; Archive
+Network&#187;, ou CTAN, est le dépôt de matériel libre de la
+communauté &tex; et &latex;. C&#8217;est un ensemble de sites Internet
+réparti dans le monde qui offre de télécharger du matériel en relation
+avec &latex;. Visitez CTAN sur la Toile à l&#8217;adresse
+<ulink url="https://ctan.org">https://ctan.org</ulink>.
</para>
-<screen>\@startsection{<replaceable>nom</replaceable>}{<replaceable>niveau</replaceable>}{<replaceable>retrait</replaceable>}{<replaceable>avant</replaceable>}{<replaceable>après</replaceable>}{<replaceable>style</replaceable>}
-</screen>
-<para>Cette commande permet de redéfinir les commandes de rubricage telles que <literal>\section</literal> ou <literal>\subsection</literal>.
+<para>Ce matériel est organisé en paquetages, des paquets discrets qui offrent
+typiquement une fonctionalité cohérente et sont maintenus par une
+personne ou un petit nombre de personnes. Par exemple, beaucoup
+d&#8217;organismes d&#8217;édition on un paquetage qui permet aux auteurs de
+formater leurs articles conformément aux spécification de cet organisme.
</para>
-<para>Notez que le paquetage <filename>titlesec</filename> rend la manipulation du rubricage
-plus facile. De plus, bien que la plupart des exigences concernant les
-commandes de rubricage peuvent être remplies avec
-<literal>\@startsection</literal>, ce n&#8217;est pas le cas de toutes. Par exemple,
-dans les classes &latex; standardes <literal>book</literal> et <literal>report</literal> les
-commandes <literal>\chapter</literal> et <literal>\report</literal> ne sont pas construite de
-cette manière. Pour fabriquer une telle commande il est possible
-d&#8217;utiliser la commande <literal>\secdef</literal>.
-<!-- xx define, and make a cross reference to, secdef. -->
+<para>En plus des resources massives, le site <literal>ctan.org</literal> offre des fonctions telles que
+la recherche par nom ou par fonctionalité.
</para>
-<para>Techniquement, cette commande a la forme :
-</para><screen>\@startsection{<replaceable>nom</replaceable>}{<replaceable>niveau</replaceable>}{<replaceable>retrait</replaceable>}{<replaceable>avant</replaceable>}{<replaceable>après</replaceable>}{<replaceable>style</replaceable>}
- *[<replaceable>titretdm</replaceable>]{<replaceable>titre</replaceable>}
-</screen><para>de sorte que faire :
-</para><screen>\renewcommand{\section}{\@startsection{<replaceable>nom</replaceable>}{<replaceable>niveau</replaceable>}{<replaceable>retrait</replaceable>}%
- {<replaceable>avant</replaceable>}{<replaceable>après</replaceable>}{<replaceable>style</replaceable>}}
-</screen><para>redéfinit <literal>\section</literal> en gardant sa forme standarde d&#8217;appel
-<literal>\section*[<replaceable>titretdm</replaceable>]{<replaceable>titre</replaceable>}</literal>. Voir <link linkend="Sectioning">Sectioning</link> et
-les exemples plus bas.
-</para>
-
-<variablelist>
-<varlistentry><term><replaceable>nom</replaceable>
-</term><listitem><anchor id="_005c_0040startsection_002fname"/><para>Nom du compteur (qui doit être défini
-séparément) utilisé pour numéroter le titre de rubrique. Ceux le plus
-communément utilisés sont <literal>section</literal>, <literal>subsection</literal>, ou
-<literal>paragraph</literal>. Bien que dans ces trois cas le nom du compteur soit le
-même que celui de la commande elle-même, utiliser le même nom n&#8217;est pas
-exigé.
-</para>
-<para>Alors <literal>\the</literal><replaceable>name</replaceable> affiche le numéro de titre, et
-<literal>\</literal><replaceable>name</replaceable><literal>mark</literal> sert aux en-têtes de page.
-</para>
-</listitem></varlistentry><varlistentry><term><replaceable>niveau</replaceable>
-</term><listitem><anchor id="_005c_0040startsection_002flevel"/><para>Un entier donnant la profondeur de la
-commande de rubricage, par ex. 0 pour <literal>chapter</literal> (ceci ne
-s&#8217;applique qu&#8217;aux classes standardes <literal>book</literal> et <literal>report</literal>), 1
-pour <literal>section</literal>, 2 pour <literal>subsection</literal>, 3 pour
-<literal>subsubsection</literal>, 4 pour <literal>paragraph</literal> et 5 pour
-<literal>subparagraph</literal>. Dans les classes <literal>book</literal> et <literal>report</literal>,
-<literal>part</literal> a pour niveau -1, alors que dans la classe <literal>article</literal>,
-<literal>part</literal> a pour niveau 0.
-</para>
-<para>Si <replaceable>niveau</replaceable> est inférieur ou égal à la valeur de <literal>secnumdepth</literal>
-alors les titres pour cette commande de rubricage sont numérotés. Par
-ex. dans un <literal>article</literal>, si <literal>secnumdepth</literal> vaut 1 alors une
-commande <literal>\section{Introduction}</literal> produira en sortie quelque
-chose du genre de <literal>1 Introduction</literal> alors que
-<literal>\subsection{Historique}</literal> produit en sortie quelque chose du
-genre de <literal>Historique</literal>, sans numéro en
-préfixe. Voir <link linkend="Sectioning_002fsecnumdepth">Sectioning/secnumdepth</link>.
-</para>
-<para>Si <replaceable>niveau</replaceable> est inférieur ou égal à la valeur de <literal>secnumdepth</literal>
-alors la table des matières aura un article pour cette rubrique. Par
-exemple, dans un <literal>article</literal>, si <literal>tocdepth</literal> vaut 1 alors la
-table des matières listera les <literal>section</literal>s, mais pas les
-<literal>subsection</literal>s.
+<indexterm role="cp"><primary>DANTE e.V.</primary></indexterm>
+<para>CTAN n&#8217;est pas un site unique, mais au lieu de cela un ensemble de
+sites. L&#8217;un des ces sites est le cœur. Ce site gère activement le
+matériel, par exemple en acceptant les téléversements de matériel
+nouveau ou mis à jour. Il est hébergé par le groupe &tex; allemand
+DANTE e.V.
</para>
-
-</listitem></varlistentry><varlistentry><term><replaceable>retrait</replaceable>
-</term><listitem><anchor id="_005c_0040startsection_002findent"/><para>Une longueur donnant le renfoncement de
-toutes les lignes du titre relativement à la marge. Pour un
-renfoncement nul, utilisez <literal>0pt</literal>.
-<!-- vous pouvez utiliser la macro @code{\z@@} définie à @code{0pt} pour -->
-<!-- que le code soit plus efficace -->
-Une valeur négative telle que <literal>-1em</literal> cause un débord du titre dans
-la marge.
-</para>
-</listitem></varlistentry><varlistentry><term><replaceable>avant</replaceable>
-</term><listitem><anchor id="_005c_0040startsection_002fbeforeskip"/><para>Longueur dont la valeur absolue est
-la longueur de l&#8217;espace vertical à insérer avant le titre de la
-rubrique. Cet espacement est ignoré si la rubrique commence au début
-d&#8217;une page. Si en plus <replaceable>avant</replaceable> est négatif, alors le premier
-paragraphe suivant immédiatement le titre n&#8217;est pas renfoncé, s&#8217;il est
-positif ou nul il l&#8217;est. (Notez que l&#8217;opposé de <literal>1pt plus 2pt
-minus 3pt</literal> est <literal>-1pt plus -2pt minus -3pt</literal>).
+<indexterm role="cp"><primary>mirrors of CTAN</primary></indexterm>
+<para>D&#8217;autres sites autour du monde apportent leur aide en miroitant, c&#8217;est à
+dire en synchronisant automatiquement leurs collections sur le site
+maître et en rendant à leur tour leurs copies publiquement
+disponibles. Ceci donne aux utilisateurs géographiquement proches un
+meilleur accès et allège la charge sur le site maître. La liste des
+miroirs se trouve à <ulink url="https://ctan.org/mirrors">https://ctan.org/mirrors</ulink>.
</para>
-<para>Par exemple si <replaceable>avant</replaceable> vaut <literal>-3.5ex plus -1ex minus -0.2ex</literal>
-alors pour commencer la nouvelle rubrique, &latex; ajoute environ 3,5
-fois la hauteur d&#8217;une lettre x en espace veritical, et le premier
-paragraphe de la rubrique n&#8217;est pas renfoncé. Utiliser une longueur
-élastique, c.-à-d. comprenant <literal>plus</literal> et <literal>minus</literal>, est une
-bonne pratique ici car cela donne à &latex; plus de latitude lors de la
-fabrication de la page.
-</para>
-<para>La quantité totale d&#8217;espace vertical entre la ligne de base de la ligne
-précédant le titre de cette rubrique est la ligne de base du titre est
-la somme du <literal>\parskip</literal> dans la police du corps de texte, du
-<literal>\baselineskip</literal> de la police du titre, et de la valeur absolue de
-l&#8217;argument <replaceable>avant</replaceable>. Cet espace est typiquement élastique et peut se
-dilater ou se contracter. (Si la rubrique commence en début d&#8217;une page
-de sorte que cet espace soit ignoré, alors la ligne de base du titre
-correspond à la ligne de base qu&#8217;aurait la première ligne de texte sur
-cette page si celle-ci commençait par du texte).
-</para>
-</listitem></varlistentry><varlistentry><term><replaceable>après</replaceable>
-</term><listitem><anchor id="_005c_0040startsection_002fafterskip"/><para>Longueur. Lorsque elle est positive
-ou nulle, il s&#8217;agit de l&#8217;espace vertical à insérer après le titre de la
-rubrique. Lorsque elle est négative, alors le titre fait corps avec le
-paragraphe le suivant immédiatement. Dans ce cas la valeur absolue de
-la longueur donne l&#8217;espace horizontal entre la fin du titre et le début
-du paragraphe suivant. (Notez que l&#8217;opposé de <literal>1pt plus 2pt minus
-3pt</literal> est <literal>-1pt plus -2pt minus -3pt</literal>).
-</para>
-<para>Comme c&#8217;est le cas avec <replaceable>avant</replaceable>, utiliser une longueur élastique
-avec des composantes <literal>plus</literal> et <literal>minus</literal> est une bonne pratique
-ici puisque elle donne à &latex; plus de latitude pour assembler la
-page.
-</para>
-<para>Si <replaceable>après</replaceable> est positif ou nul alors la quantité totale d&#8217;espace
-vertical entre la ligne de base du titre de la rubrique et la ligne de
-base de la première ligne du paragraphe suivant est la somme du
-<literal>\parskip</literal> de la police du titre, de <literal>\baselineskip</literal> de la
-police du corps de texte, et de la valeur de <replaceable>après</replaceable>. Cet espace est
-typiquement élastique de sorte qu&#8217;il puisse se dilater ou se
-contracter. (Notez que du fait que le signe d&#8217;<replaceable>après</replaceable> contrôle que
-le titre soit indépendant du texte le suivant, ou fasse corps avec lui,
-vous ne pouvez pas utiliser un <replaceable>après</replaceable> négatif pour annuler une
-partie du <literal>\parskip</literal>).
-</para>
-</listitem></varlistentry><varlistentry><term><replaceable>style</replaceable>
-</term><listitem><anchor id="_005c_0040startsection_002fstyle"/><para>Contrôle le style du titre, voir les
-exemples plus bas. Les commandes typiquement utilisées ici sont
-<literal>\centering</literal>, <literal>\raggedright</literal>, <literal>\normalfont</literal>,
-<literal>\hrule</literal>, ou <literal>\newpage</literal>. La dernière commande au sein de
-<replaceable>style</replaceable> peut être une commande prenant un argument, telle que
-<literal>\MakeUppercase</literal> ou <literal>\fbox</literal>. Le titre de la rubrique est passé
-en argument à cette commande. Par exemple régler <replaceable>style</replaceable> à
-<literal>\bfseries\MakeUppercase</literal> a pour effet de produire des titres gras
-et en capitales.
-</para></listitem></varlistentry></variablelist>
-<para>Voici des exemples. Pour les utiliser mettez les soit au sein d&#8217;un
-fichier de paquetage ou de classe, ou placez les dans le préambule d&#8217;un
-document &latex; entre des commandes <literal>\makeatletter</literal> et
-<literal>\makeatother</literal>. (Le message d&#8217;erreur <literal>You can't use
-`\spacefactor' in vertical mode.</literal> est le plus probable lorsque on
-oublie de faire cela). Voir <link linkend="_005cmakeatletter-and-_005cmakeatother">\makeatletter and \makeatother</link>.
-</para>
-<para>L&#8217;exemple suivant redéfinit la commande de rubricage <literal>\section</literal>
-pour qu&#8217;elle centre le titre et le mette en gras :
-</para>
-<screen>\renewcommand\section{%
- \@startsection{section}% <link linkend="_005c_0040startsection_002fname"><replaceable>nom</replaceable></link>.
- {1}% <link linkend="_005c_0040startsection_002flevel"><replaceable>niveau</replaceable></link>.
- {0pt}% <link linkend="_005c_0040startsection_002findent"><replaceable>retrait</replaceable></link>.
- {-3.5ex plus -1ex minus -.2ex}% <link linkend="_005c_0040startsection_002fbeforeskip"><replaceable>avant</replaceable></link>.
- {2.3ex plus.2ex}% <link linkend="_005c_0040startsection_002fafterskip"><replaceable>après</replaceable></link>.
- {\centering\normalfont\Large\bfseries}}% <link linkend="_005c_0040startsection_002fstyle"><replaceable>style</replaceable></link>.
-</screen>
-<para>Cet exemple met les titres de <literal>subsection</literal> en petites capitales, et
-leur fait faire corps avec le paragraphe suivant.
-</para>
-<screen>\renewcommand\subsection{%
- \@startsection{subsection}% <link linkend="_005c_0040startsection_002fname"><replaceable>nom</replaceable></link>.
- {2}% <link linkend="_005c_0040startsection_002flevel"><replaceable>niveau</replaceable></link>.
- {0em}% <link linkend="_005c_0040startsection_002findent"><replaceable>retrait</replaceable></link>.
- {-1ex plus 0.1ex minus -0.05ex}% <link linkend="_005c_0040startsection_002fbeforeskip"><replaceable>avant</replaceable></link>.
- {-1em plus 0.2em}% <link linkend="_005c_0040startsection_002fafterskip"><replaceable>après</replaceable></link>.
- {\scshape}% <link linkend="_005c_0040startsection_002fstyle"><replaceable>style</replaceable></link>.
- }
-</screen>
-<para>Les exemples précédents redéfinissait les commandes de titre de
-rubriques existantes. celui-ci en définit une nouvelle, illustrant la
-nécessité d&#8217;un compteur et de macros pour son affichage.
-</para>
-<!-- From https://groups.google.com/forum/#!searchin/comp.text.tex/startsection%7Csort:relevance/comp.text.tex/sB-nTS-oL08/ZZeKYdG0llMJ -->
-<screen>\setcounter{secnumdepth}{6}% affiche les compteur justqu'à ce niveau
-\newcounter{subsubparagraph}[subparagraph]% compteur pour la
- % numérotation
-\renewcommand{\thesubsubparagraph}%
- {\thesubparagraph.\@arabic\c@subsubparagraph}% comment afficher
- % la numérotation
-\newcommand{\subsubparagraph}{\@startsection
- {subsubparagraph}%
- {6}%
- {0em}%
- {\baselineskip}%
- {0.5\baselineskip}%
- {\normalfont\normalsize}}
-\newcommand*\l@subsubparagraph%
- {\@dottedtocline{6}{10em}{5em}}% pour la table des matières
-\newcommand{\subsubparagraphmark}[1]{}% pour les en-têtes de page
-</screen>
-
-
-</sect3>
-<sect3 label="2.4.3.2" id="_005c_0040ifstar">
-<title><literal>\@ifstar</literal></title>
-
-<indexterm role="fn"><primary>\@ifstar</primary></indexterm>
-<indexterm role="cp"><primary>commandes, variantes étoilées</primary></indexterm>
-<indexterm role="cp"><primary>étoilées, variantes de commandes</primary></indexterm>
-
-
-<!-- Inpirée des trucs & astuces de Manuel Pégourié-Gonnard -->
-<!-- (https://elzevir.fr/imj/latex/tips.html#stared) -->
-
-<para>Vous l&#8217;avez sans doute remarqué, beaucoup d&#8217;environnements ou commandes
-standards de &latex; existent sous une variante étoilée. Vous pouvez avoir
-envie de reprendre cette idée quand vous définissez vos commandes et arguments.
-</para>
-<para>Si vous avez lu <link linkend="_005cnewenvironment-_0026-_005crenewenvironment">\newenvironment &amp; \renewenvironment</link>, vous aurez compris
-que c&#8217;est immédiat pour les environnements car l&#8217;étoile est un caractère
-autorisé dans les noms d&#8217;environnements. Il vous suffit donc de faire
-<literal>\newenvironment{<replaceable>monenv</replaceable>}</literal> et
-<literal>\newenvironment{<replaceable>monenv</replaceable>*}</literal> avec les définitions souhaitées.
-</para>
-<para>Pour les commandes, c&#8217;est plus compliqué car l&#8217;étoile ne peut pas faire partie
-du nom de la commande. Il y aura donc une première commande, qui devra être
-capable de regarder si elle est ou non suivie d&#8217;une étoile et d&#8217;adapter son
-comportement en conséquence. Cette première commande ne pourra pas accepter
-d&#8217;argument, mais pourra faire appel à des commandes qui en acceptent. Par
-ailleurs, on utilise la commande <literal>\@ifstar</literal> interne du noyau &latex; et
-vous pouvez vous reportez à « <link linkend="_005cmakeatletter-and-_005cmakeatother">\makeatletter and \makeatother</link> » pour
-comprendre pourquoi cela implique l&#8217;usage d&#8217;un bloc
-<literal>\makeatletter...\makeatother</literal>.
-</para>
-<para>Dans cet exemple, on définit <literal>\ciel</literal> comme une commande avec un
-argument obligatoire et admettant une variante étoilée <literal>\ciel*</literal>
-également avec un argument obligatoire :
-</para>
-<screen>\makeatletter
-\newcommand*\ciel@starred[1]{ciel #1 étoilé}
-\newcommand*\ciel@unstarred[1]{ciel #1 non étoilé}
-\newcommand\ciel{\@ifstar{\ciel@starred}{\ciel@unstarred}}
-\makeatother
-</screen>
-<para>ainsi, <literal>\ciel{bleu}</literal> composera « ciel bleu non étoilé » tandis que
-<literal>\ciel*{nocturne}</literal> composera « ciel nocturne étoilé ».
-</para>
-<para>Notez que les commandes intermédiaires <literal>\ciel@starred</literal> et
-<literal>\ciel@unstarred</literal> comportent un <literal>@</literal> dans leur nom ce qui est
-possible puisque elles apparaissent au sein d&#8217;un bloc
-<literal>\makeatletter...\makeatother</literal>. Ceci assure qu&#8217;elles ne puissent pas être
-utilisées directement dans le document. L&#8217;utilisation de @ dans le nom
-comporte certes un risque de collision avec une commande interne du noyeau
-&latex;, mais une telle collision est facile à détecter et corriger car
-<literal>\newcommand*{\<replaceable>cmd</replaceable>}</literal> vérifie que si la commande <literal>\<replaceable>cmd</replaceable></literal>
-n&#8217;est pas déjà définie et génère une erreur si c&#8217;est le cas.
-</para>
-<para>Voici un autre exemple où la commande <literal>\agentsecret</literal> comporte deux
-arguments et sa variante étoilée <literal>\agentsecret*</literal> un seul :
-</para>
-<screen>\makeatletter
-\newcommand*\agentsecret@starred[1]{\textsc{#1}}
-\newcommand*\agentsecret@unstarred[2]{\textit{#1} \textsc{#2}}
-\newcommand\agentsecret{\@ifstar{\agentsecret@starred}{\agentsecret@unstarred}}
-\makeatother
-</screen>
-<para>Avec cette définition la célèbre réplique de l&#8217;agent 007 :
-</para>
-<screen>Je m'appelle \agentsecret*{Bond}, \agentsecret{James}{Bond}.
-</screen>
-<para>est équivalente à :
-</para>
-<screen>Je m'appelle \textsc{Bond}, \textit{James} textsc{Bond}.
-</screen>
-<para>Un dernier mot : contrairement aux noms d&#8217;environnement où l&#8217;étoile fait partie
-du nom lui-même, et pourrait donc être à n&#8217;importe quelle position, dans le nom
-d&#8217;une commande l&#8217;étoile est comme une sorte d&#8217;argument optionnel. D&#8217;un point de
-vue purement &tex;nique il est donc possible de mettre un nombre indéfini
-d&#8217;espaces entre la commande et l&#8217;étoile. Ainsi <literal>\agentsecret*{Bond}</literal> et
-<literal>\agentsecret *{Bond}</literal> sont équivalents. Toutefois la pratique commune
-est de ne jamais insérer de tels espaces.
-</para>
-</sect3>
-</sect2>
</sect1>
</chapter>
<chapter label="3" id="Document-classes">
@@ -904,7 +634,8 @@ est de ne jamais insérer de tels espaces.
<indexterm role="cp"><primary>classes de documents</primary></indexterm>
<indexterm role="fn"><primary>\documentclass</primary></indexterm>
-<para>La classe d&#8217;un document donné est définie avec la commande:
+<para>La classe globale d&#8217;un document est définie avec cette commande, c&#8217;est
+normalement la première commande dans une fichier source &latex;.
</para>
<screen>\documentclass[<replaceable>options</replaceable>]{<replaceable>classe</replaceable>}
</screen>
@@ -916,14 +647,37 @@ fichier source &latex;.
<indexterm role="fn"><primary>classe book</primary></indexterm>
<indexterm role="fn"><primary>classe letter</primary></indexterm>
<indexterm role="fn"><primary>classe slides</primary></indexterm>
-<para>Les noms de <replaceable>classe</replaceable> &latex; encastrés sont (beaucoup d&#8217;autres
-classes de documents sont disponibles en modules ; voir <link linkend="Overview">Overview</link>):
+<para>Les noms de <replaceable>classe</replaceable> de document incorporés à &latex;. (Beaucoup
+de classes de document sont disponibles dans des paquetages séparés ;
+see <link linkend="Overview">Overview</link>.)
+</para>
+<variablelist><varlistentry><term><literal>article</literal>
+</term><listitem><anchor id="document-classes-article"/><para>Pour un article de journal, une présentation, et diverses utilisations
+générales.
+</para>
+</listitem></varlistentry><varlistentry><term><literal>book</literal>
+</term><listitem><anchor id="document-classes-book"/>
+<para>Des livres complets, y compris des chapitres et possiblement incluant
+des pièces préliminaires telles qu&#8217;une préface, et postliminaires telles
+qu&#8217;un appendice (see <link linkend="Front_002fback-matter">Front/back matter</link>).
+</para>
+</listitem></varlistentry><varlistentry><term><literal>letter</literal>
+</term><listitem><anchor id="document-classes-letter"/><para>Courrier, incluant optionnellement des étiquettes pour enveloppes
+(see <link linkend="Letters">Letters</link>).
+</para>
+</listitem></varlistentry><varlistentry><term><literal>report</literal>
+</term><listitem><anchor id="document-classes-report"/><para>Pour des documents de longueur entre celle d&#8217;un <literal>article</literal> et celle
+d&#8217;un <literal>book</literal>, tels que des rapports techniques ou des thèses, et qui
+peuvent contenir plusieurs chapitres.
+</para>
+</listitem></varlistentry><varlistentry><term><literal>slides</literal>
+</term><listitem><anchor id="document-classes-slides"/><para>Pour des présentations de diapositive &#8212; rarement utilisé de nos jours.
+À sa place la classe <literal>beamer</literal> est sans doute celle dont l&#8217;usage est
+le plus répendu (<ulink url="https://ctan.org/pkg/beamer">https://ctan.org/pkg/beamer</ulink>). See <link linkend="beamer-template">beamer
+template</link>, pour un petit partron de document beamer.
</para>
-<screen>article report book letter slides
-</screen>
-<!-- xx décrire brièvement chacun -->
-
-<para>Les <replaceable>options</replaceable> standardes sont décrites ci-dessous.
+</listitem></varlistentry></variablelist>
+<para>Les <replaceable>options</replaceable> standardes sont décrites dans les rubriques suivantes.
</para>
<sect1 label="3.1" id="Document-class-options">
@@ -982,13 +736,17 @@ taille du papier (ci-après hauteur sur largeur) :
<indexterm role="fn"><primary>\pdfpagewidth</primary></indexterm>
<indexterm role="fn"><primary>\pdfpageheight</primary></indexterm>
<indexterm role="fn"><primary>paquetage <literal>geometry</literal></primary></indexterm>
-<indexterm role="fn"><primary><literal>geometry</literal>, paquetage Lorsque on utilise l'un des moteurs pdf&latex;,</primary></indexterm>
-<para>Lua&latex;, ou Xe&latex; (voir <link linkend="TeX-engines">&tex; engines</link>), les options autres
+<indexterm role="fn"><primary><literal>geometry</literal>, paquetage</primary></indexterm>
+<para>Lorsque on utilise l&#8217;un des moteurs pdf&latex;,
+Lua&latex;, ou Xe&latex; (see <link linkend="TeX-engines">&tex; engines</link>), les options autres
que <literal>letterpaper</literal> règlent la zone d&#8217;impression mais vous devez
également régler la taille du papier physique. Un méthode pour faire
cela est de placer <literal>\pdfpagewidth=\paperwidth</literal> et
<literal>\pdfpageheight=\paperheight</literal> dans le préambule de votre document.
-Le paquetage <literal>geometry</literal> fournit des méthodes flexibles pour régler
+<indexterm role="fn"><primary>paquetage <literal>geometry</literal></primary></indexterm>
+<indexterm role="fn"><primary><literal>geometry</literal>, paquetage</primary></indexterm>
+</para>
+<para>Le paquetage <literal>geometry</literal> fournit des méthodes flexibles pour régler
la zone d&#8217;impression et la taille du papier physique.
</para>
<indexterm role="fn"><primary>option draft</primary></indexterm>
@@ -1093,7 +851,7 @@ pourriez créer une nouvelle classe <literal>cmsnote.cls</literal> et commencer
documents par <literal>\documentclass{cmsnote}</literal>.
</para>
<para>Ce qui distingue un paquetage d&#8217;une classe de document c&#8217;est que les
-commandes d&#8217;une paquatage sont utilisables pour différentes classes
+commandes d&#8217;une paquetage sont utilisables pour différentes classes
alors que celles dans une classes de document sont spécifiques à cette
classes. Ainsi, une commande qui permet de régler les en-têtes de pages
irait dans un paquetage alors qu&#8217;une commande intitulant en-têtes de
@@ -1102,10 +860,10 @@ une classe.
<indexterm role="cp"><primary>classe et paquetage, différence</primary></indexterm>
<indexterm role="cp"><primary>différence entre classe et paquetage</primary></indexterm>
</para>
-<para>Au sein d&#8217;un fichier classe pour paquetate on peu utiliser l&#8217;arobe
+<para>Au sein d&#8217;un fichier classe ou paquetage on peut utiliser l&#8217;arobe
<literal>@</literal> comme un caractère dans les noms de commande sans avoir à
entourer le code contenant la commande en question par
-<literal>\makeatletter</literal> et <literal>\makeatother</literal>. Voir <link linkend="_005cmakeatletter-and-_005cmakeatother">\makeatletter and
+<literal>\makeatletter</literal> et <literal>\makeatother</literal>. See <link linkend="_005cmakeatletter-_0026-_005cmakeatother">\makeatletter &amp;
\makeatother</link>. Ceci permet de créer des commandes que les utilisateurs
ne risquent pas de redéfinir accidentellement. Une autre technique est
de préfixer les commandes spécifiques à une classe ou paquetage avec une
@@ -1208,7 +966,7 @@ d&#8217;appel. Voir aussi <link linkend="_005cAtBeginDocument">\AtBeginDocument
</term><listitem><indexterm role="fn"><primary>\CheckCommand</primary></indexterm>
<indexterm role="fn"><primary>\CheckCommand*</primary></indexterm>
<indexterm role="cp"><primary>nouvelle commande, vérification</primary></indexterm>
-<para>Similaire à <literal>\newcommand</literal> (voir <link linkend="_005cnewcommand-_0026-_005crenewcommand">\newcommand &amp; \renewcommand</link>)
+<para>Similaire à <literal>\newcommand</literal> (see <link linkend="_005cnewcommand-_0026-_005crenewcommand">\newcommand &amp; \renewcommand</link>)
mais ne définit pas <replaceable>cmd</replaceable> ; à la place vérifie que la définition
actuelle de <replaceable>cmd</replaceable> est exactement celle donnée par <replaceable>définition</replaceable>
et est ou n&#8217;est pas <firstterm>longue</firstterm> selon ce que l&#8217;on attend.
@@ -1270,10 +1028,10 @@ uniquement être utilisé au sein de l&#8217;argument <replaceable>code</replace
</term></varlistentry><varlistentry><term><literal>\DeclareOption*{<replaceable>option</replaceable>}{<replaceable>code</replaceable>}</literal>
</term><listitem><indexterm role="fn"><primary>\DeclareOption</primary></indexterm>
<indexterm role="fn"><primary>\DeclareOption*</primary></indexterm>
-<indexterm role="cp"><primary>class options</primary></indexterm>
-<indexterm role="cp"><primary>package options</primary></indexterm>
-<indexterm role="cp"><primary>options, class</primary></indexterm>
-<indexterm role="cp"><primary>options, package</primary></indexterm>
+<indexterm role="cp"><primary>classe, options</primary></indexterm>
+<indexterm role="cp"><primary>paquetage, options</primary></indexterm>
+<indexterm role="cp"><primary>options de classe</primary></indexterm>
+<indexterm role="cp"><primary>options de paquetage</primary></indexterm>
<para>Rend un option <replaceable>option</replaceable> disponible pour l&#8217;utilisateur, de sorte à ce
qu&#8217;il puisse la passer à leur commande <literal>\documentclass</literal>. Par
exemple, la classe <literal>notecms</literal> pourrait avoir une option <literal>logo</literal>
@@ -1311,9 +1069,9 @@ l&#8217;option à la classe <literal>article</literal>.
<indexterm role="fn"><primary>\DeclareRobustCommand*</primary></indexterm>
<indexterm role="cp"><primary>nouvelle commande, définition</primary></indexterm>
<para>Similaire à <literal>\newcommand</literal> et <literal>\newcommand*</literal>
-(voir <link linkend="_005cnewcommand-_0026-_005crenewcommand">\newcommand &amp; \renewcommand</link>) mais déclare une commande robuste,
+(see <link linkend="_005cnewcommand-_0026-_005crenewcommand">\newcommand &amp; \renewcommand</link>) mais déclare une commande robuste,
même si <replaceable>définition</replaceable> comprend du code fragile. (Pour une discussion
-sur les commandes robustes et fragiles voir <link linkend="_005cprotect">\protect</link>). Utilisez ces
+sur les commandes robustes et fragiles see <link linkend="_005cprotect">\protect</link>). Utilisez ces
commande pour définir de nouvelles commandes robustes, ou redéfinir des
commandes existantes en les rendant robustes. Contrairement à
<literal>\newcommand</literal> elle ne produisent pas d&#8217;ereru si la macro <replaceable>cmd</replaceable>
@@ -1326,13 +1084,14 @@ le contenu de la commande soit fragile et que la commande soit utilisée
au sein d&#8217;un argument mouvant, utilisez <literal>\newcommand</literal>.
</para>
<indexterm role="fn"><primary>paquetage <literal>etoolbox</literal></primary></indexterm>
-<indexterm role="fn"><primary><literal>etoolbox</literal>, paquetage Le paquetage <literal>etoolbox</literal> offre les commandes</primary></indexterm>
-<para><literal>\newrobustcmd</literal>, <literal>\newrobustcmd*</literal>, <literal>\renewrobustcmd</literal>,
+<indexterm role="fn"><primary><literal>etoolbox</literal>, paquetage</primary></indexterm>
+<para>Le paquetage <literal>etoolbox</literal> offre les commandes
+<literal>\newrobustcmd</literal>, <literal>\newrobustcmd*</literal>, <literal>\renewrobustcmd</literal>,
<literal>\renewrobustcmd*</literal>, <literal>\providerobustcmd</literal>, et
<literal>\providrobustcmd*</literal> qui sont similaire aux commandes standardes
<literal>\newcommand</literal>, <literal>\newcommand*</literal>, <literal>\renewcommand</literal>,
<literal>\renewcommand*</literal>, <literal>\providecommand</literal>, et
-<literal>\providcommand*</literal>, mais définissent une commande <replaceable>cmd</replaceable> robuste
+<literal>\providecommand*</literal>, mais définissent une commande <replaceable>cmd</replaceable> robuste
avec deux advanges par rapport à <literal>\DeclareRobustCommand</literal> :
</para><orderedlist numeration="arabic"><listitem><para>Elle utilisent un mécanisme de protection de bas niveau d&#8217;e-&tex; au
lieu du mécanisme de plus au niveau de &latex; utilisant
@@ -1412,7 +1171,7 @@ et le plus souvent elle est utilisée de cette façon :
classe est traité, le nom du format donné ici doit s&#8217;accorder avec le
format qui est en cours d&#8217;exécution (y compris le fait que la chaîne
<replaceable>format</replaceable> est sensible à la casse). Si il ne s&#8217;y accorde pas alors
-l&#8217;exécution est interrompue par une erruer du genre de &#8216;<literal>This file
+l&#8217;exécution est interrompue par une erreur du genre de &#8216;<literal>This file
needs format `LaTeX2e' but this is `xxx'.</literal>&#8217;
</para>
<para>Pour spécifier une version du format dont vous savez qu&#8217;elle prend en
@@ -1479,9 +1238,9 @@ option. L&#8217;utilisateur peut commencer son fichier &latex; avec
</term></varlistentry><varlistentry><term><literal>\ProcessOptions*<replaceable>\@options</replaceable></literal>
</term><listitem><indexterm role="fn"><primary>\ProcessOptions</primary></indexterm>
<indexterm role="fn"><primary>\ProcessOptions*</primary></indexterm>
-<para>Exécute le code associé à chaque option que l&#8217;utilisateur a invoquée. À
-include dans le fichier classe sous la forme
-<literal>\ProcessOptions\relax</literal> (à cause de l&#8217;existance de la variant
+<para>Exécute le code pour chaque option que l&#8217;utilisateur a invoquée. À
+inclure dans le fichier classe sous la forme
+<literal>\ProcessOptions\relax</literal> (à cause de l’existence de la variante
étoilée de la commande).
</para>
<para>Les options tombent dans deux catégories. Les <firstterm>options locales</firstterm>
@@ -1578,10 +1337,10 @@ essai.cls</literal>&#8217;.
</term><listitem><indexterm role="fn"><primary>\RequirePackage</primary></indexterm>
<indexterm role="fn"><primary>\RequirePackageWithOptions</primary></indexterm>
<para>Charge un paquetage, comme la commande <literal>\usepackage</literal> pour les
-auteurs de documents. Voir <link linkend="Additional-packages">Additional packages</link>. Voici un exemple :
+auteurs de documents. See <link linkend="Additional-packages">Additional packages</link>. Voici un exemple :
<literal>\RequirePackage[landscape,margin=1in]{geometry}</literal>. Notez que
l&#8217;équipe de développement de &latex; recommande fortement l&#8217;utilisation
-de ces commande de préférence à l&#8217;<literal>\input</literal> de Plain&#160;&tex; ;
+de ces commandes de préférence à l&#8217;<literal>\input</literal> de &tex; de base ;
voir le « Class Guide ».
</para>
<para>La <replaceable>liste d&#8217;options</replaceable>, si présente, est une liste ponctuée de
@@ -1696,7 +1455,7 @@ environnement ; par exemple, <literal>\begin{ttfamily} &#8230;
</listitem></varlistentry><varlistentry><term><literal>\texttt (\ttfamily)</literal>
</term><listitem><indexterm role="fn"><primary>\texttt</primary></indexterm>
<indexterm role="fn"><primary>\ttfamily</primary></indexterm>
-<para>Machine à écrire.
+<para>Tapuscrit, encore appelé « machine à écrire ».
</para>
</listitem></varlistentry><varlistentry><term><literal>\textnormal (\normalfont)</literal>
</term><listitem><indexterm role="fn"><primary>\textnormal</primary></indexterm>
@@ -1717,7 +1476,7 @@ environnement ; par exemple, <literal>\begin{ttfamily} &#8230;
</para>
</listitem></varlistentry><varlistentry><term><literal>\mathtt</literal>
</term><listitem><indexterm role="fn"><primary>\mathtt</primary></indexterm>
-<para>Machine à écrire, pour une utilisation en mode mathématique.
+<para>Tapuscrit, pour une utilisation en mode mathématique.
</para>
</listitem></varlistentry><varlistentry><term><literal>\mathit</literal>
</term><term><literal>(\mit)</literal>
@@ -1745,6 +1504,7 @@ formules. <literal>\mathversion{normal}</literal> restaure la valeur par défaut
<indexterm role="cp"><primary>chiffres de revêtement</primary></indexterm>
<indexterm role="fn"><primary>paquetage <literal>textcomp</literal></primary></indexterm>
<indexterm role="fn"><primary><literal>textcomp</literal>, paquetage</primary></indexterm>
+
<para>Enfin, la commande <literal>\oldstylenums{<replaceable>chiffres</replaceable>}</literal> sert à
composer des chiffres dits de &#8220;à l&#8217;ancienne&#8221;, qui ont des hauteurs et
profondeur (et parfois largeurs) distincts de l&#8217;alignement standard des
@@ -1800,8 +1560,9 @@ l&#8217;une avec l&#8217;autre.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\tt</primary></indexterm><literal>\tt</literal>
</term><listitem><indexterm role="cp"><primary>police machine à écrire</primary></indexterm>
+<indexterm role="cp"><primary>police tapuscrit</primary></indexterm>
<indexterm role="cp"><primary>police de largeur fixe</primary></indexterm>
-<para>Machine à écrire (largeur fixe).
+<para>Tapuscrit, encore appelé « Machine à écrire » (largeur fixe).
</para>
</listitem></varlistentry></variablelist>
<para>Certaines personnes considèrent que les commandes commutation
@@ -1810,7 +1571,7 @@ inconditionnelles de polices, comme <literal>\tt</literal>, sont obsolète et qu
utilisées. Je (Karl) ne suis pas d&#8217;accord. il y a situations tout à fait
raisonnables quand un commutateur de police inconditionnelle est
précisément ce dont vous avez besoin pour obtenir le résultat souhaité ;
-pour un exemple, voir <link linkend="description"><literal>description</literal></link>. Les deux
+pour un exemple, see <link linkend="description"><literal>description</literal></link>. Les deux
ensembles de commandes ont leur place.
</para>
</sect1>
@@ -1820,11 +1581,11 @@ ensembles de commandes ont leur place.
<indexterm role="cp"><primary>tailles des polices de caractères</primary></indexterm>
<indexterm role="cp"><primary>tailles de texte</primary></indexterm>
-<para>Les commandes de type de taille standard suivants sont pris en charge
+<para>Les commandes de type de taille standardes suivantes sont pris en charge
par &latex;. Le tableau indique le nom de la commande et taille
utilisée (en points) correspondant réellement pour la police avec les
options &#8216;<literal>10pt</literal>&#8217;, &#8216;<literal>11pt</literal>&#8217;, et &#8216;<literal>12pt</literal>&#8217; de classe de document,
-respectivement (voir <link linkend="Document-class-options">Document class options</link>).
+respectivement (see <link linkend="Document-class-options">Document class options</link>).
</para>
<indexterm role="fn"><primary>\tiny</primary></indexterm>
<indexterm role="fn"><primary>\scriptsize</primary></indexterm>
@@ -1860,13 +1621,37 @@ respectivement (voir <link linkend="Document-class-options">Document class optio
</para></entry></row><row><entry><para><literal>\Huge</literal>
</para></entry><entry><para>24.88 </para></entry><entry><para>24.88 </para></entry><entry><para>24.88
</para></entry></row></tbody></tgroup></informaltable>
-<para>Les commandes énumérées ici sont des &#8220;forme déclaratives&#8221;. La portée
-d&#8217;une forme déclarative s&#8217;étend jusqu&#8217;à la prochaine la commande de type
-style ou la fin du groupe courant. Vous pouvez également utiliser la
-&#8220;forme d&#8217;environnement&#8221; de ces commandes ; par exemple,
-<literal>\begin{tiny} ... \end{tiny}</literal>.
+<indexterm role="cp"><primary>déclarative, forme des commandes de contrôle de la taille de police</primary></indexterm>
+<indexterm role="cp"><primary>forme déclarative des commandes de contrôle de la taille de police</primary></indexterm>
+<para>Les commandes énumérées ici sont des <firstterm>formes déclaratives</firstterm>. On est
+utilise en les déclarant comme dans l&#8217;exemple qui suit :
+</para>
+<screen>\begin{quotation} \small
+ Le Tao que l'on peut nommer n'est pas le Tao.
+\end{quotation}
+</screen>
+<para>Dans ce qui précède, la portée de <literal>\small</literal> s&#8217;étend jusqu&#8217;à la fin
+de l&#8217;environnement <literal>quotation</literal>. Elle s&#8217;arrêterait également à la
+prochaine commande de style ou à la fin du groupe courant, de sorte
+qu&#8217;on aurait pu la mettre entre accolades <literal>{\small Ce texte est en
+petits caractères.}</literal>.
+</para>
+<indexterm role="cp"><primary>forme par environnement des commandes</primary></indexterm>
+<para>Une <firstterm>forme par environnement</firstterm> de chacune de ces commandes est également
+définie ; par exemple, <literal>\begin{tiny}...\end{tiny}</literal>. Toutefois,
+en pratique cette forme peut aisément mener à des espaces indésirables au
+début et/ou à la fin de d&#8217;environnement si on n&#8217;y prête pas attention,
+ainsi on risque en général moins de faire d&#8217;erreur si on s&#8217;en tient à la
+forme déclarative.
+</para>
+<para>(Digression : techniquement, vu la façon dont &latex; définit
+<literal>\begin</literal> et <literal>\end</literal>, presque toutes les commandes qui ne
+prennent pas d&#8217;argument on une forme par environnement. Mais dans
+presque tous les cas ce serait juste une source de confusion de
+l&#8217;utiliser. La raison pour mentionner en particulier la forme par
+environnement des déclarations de taille de police est que leur
+utilisation s&#8217;avère assez courante, en dépit des problèmes qu&#8217;il pose).
</para>
-
</sect1>
<sect1 label="4.3" id="Low_002dlevel-font-commands">
<title>commandes de fontes de bas niveau</title>
@@ -1876,91 +1661,226 @@ style ou la fin du groupe courant. Vous pouvez également utiliser la
<para>Ces commandes sont principalement destinés aux auteurs de macros et
paquetages. Les commandes indiquées ici sont seulement un sous-ensemble
de celles disponibles.
+<!-- xx but it should be complete -->
+<!-- xx something about ultimately reading ENCFAM.fd? -->
</para>
<variablelist><varlistentry><term><literal>\fontencoding{codage}</literal>
</term><listitem><indexterm role="fn"><primary>\fontencoding</primary></indexterm>
-<para>Sélectionnez le codage de police. Les codages valides comprennent <literal>OT1</literal> et <literal>T1</literal>.
-</para>
-</listitem></varlistentry><varlistentry><term><literal>\fontfamily{famille}</literal>
+<para>Sélectionne le codage de police, le codage de la police utilisée en
+sortie. Il y a un grand nombre de codages valides. Les plus usuels sont
+<literal>OT1</literal>, le codage original de D. Knuth pour la police Computer
+Modern (la police par défaut), et <literal>T1</literal>, également désigné par
+codage Cork, qui prend en charage les caractères accentués utilisés par
+les langues européennes les plus parlées (allemand, français, italien,
+polonais et d&#8217;autres encore), ce qui permet à &tex; de faire la césure
+des mots contenant des lettres accentuées. Pour plus d&#8217;information, voir
+<ulink url="https://ctan.org/pkg/encguide">https://ctan.org/pkg/encguide</ulink>.
+</para>
+</listitem></varlistentry><varlistentry><term><literal>\fontfamily{<replaceable>famille</replaceable>}</literal>
</term><listitem><indexterm role="fn"><primary>\fontfamily</primary></indexterm>
-<para>Sélectionnez la famille de polices. Familles valides sont :
-</para>
-<itemizedlist><listitem><para><literal>cmr</literal> pour Computer Modern Roman
-</para></listitem><listitem><para><literal>cmss</literal> pour Computer Modern Sans Serif
-</para></listitem><listitem><para><literal>cmtt</literal> pour Computer Modern Typewriter
-</para></listitem></itemizedlist>
-<para>et de nombreuses autres.
-</para>
-</listitem></varlistentry><varlistentry><term><literal>\fontseries{série}</literal>
+<indexterm role="cp"><primary>famille de polices</primary></indexterm>
+<indexterm role="cp"><primary>polices, catalogue</primary></indexterm>
+<para>Sélectionne la famille de polices. La page web
+<ulink url="https://www.tug.dk/FontCatalogue/">https://www.tug.dk/FontCatalogue/</ulink> donne un moyen de naviguer
+facilement à travers un grand nombre des polices utilisées avec
+&latex;. Voici des exemples de quelques-unes des familles les plus
+usuelles :
+</para>
+<informaltable><tgroup cols="2"><colspec colwidth="4*"></colspec><colspec colwidth="31*"></colspec><tbody><row><entry><para><literal>pag</literal>
+</para></entry><entry><para>Avant Garde
+</para></entry></row><row><entry><para><literal>fvs</literal>
+</para></entry><entry><para>Bitstream Vera Sans
+</para></entry></row><row><entry><para><literal>pbk</literal>
+</para></entry><entry><para>Bookman
+</para></entry></row><row><entry><para><literal>bch</literal>
+</para></entry><entry><para>Charter
+</para></entry></row><row><entry><para><literal>ccr</literal>
+</para></entry><entry><para>Computer Concrete
+</para></entry></row><row><entry><para><literal>cmr</literal>
+</para></entry><entry><para>Computer Modern
+</para></entry></row><row><entry><para><literal>cmss</literal>
+</para></entry><entry><para>Computer Modern Sans Serif
+</para></entry></row><row><entry><para><literal>cmtt</literal>
+</para></entry><entry><para>Computer Modern Typewriter
+</para></entry></row><row><entry><para><literal>pcr</literal>
+</para></entry><entry><para>Courier
+</para></entry></row><row><entry><para><literal>phv</literal>
+</para></entry><entry><para>Helvetica
+</para></entry></row><row><entry><para><literal>fi4</literal>
+</para></entry><entry><para>Inconsolata
+</para></entry></row><row><entry><para><literal>lmr</literal>
+</para></entry><entry><para>Latin Modern
+</para></entry></row><row><entry><para><literal>lmss</literal>
+</para></entry><entry><para>Latin Modern Sans
+</para></entry></row><row><entry><para><literal>lmtt</literal>
+</para></entry><entry><para>Latin Modern Typewriter
+</para></entry></row><row><entry><para><literal>pnc</literal>
+</para></entry><entry><para>New Century Schoolbook
+</para></entry></row><row><entry><para><literal>ppl</literal>
+</para></entry><entry><para>Palatino
+</para></entry></row><row><entry><para><literal>ptm</literal>
+</para></entry><entry><para>Times
+</para></entry></row><row><entry><para><literal>uncl</literal>
+</para></entry><entry><para>Uncial
+</para></entry></row><row><entry><para><literal>put</literal>
+</para></entry><entry><para>Utopia
+</para></entry></row><row><entry><para><literal>pzc</literal>
+</para></entry><entry><para>Zapf Chancery
+</para></entry></row></tbody></tgroup></informaltable>
+</listitem></varlistentry><varlistentry><term><literal>\fontseries{<replaceable>série</replaceable>}</literal>
</term><listitem><indexterm role="fn"><primary>\fontseries</primary></indexterm>
-<para>Sélectionnez série de police. Les séries valides sont :
-</para>
-<itemizedlist><listitem><para><literal>m</literal> Moyen (normal)
-</para></listitem><listitem><para><literal>b</literal> Gras
-</para></listitem><listitem><para><literal>c</literal> condensé
-</para></listitem><listitem><para><literal>bc</literal> condensé Gras
-</para></listitem><listitem><para><literal>bx</literal> Gras étendu
-</para></listitem></itemizedlist>
-<para>et diverses autres combinaisons.
+<indexterm role="cp"><primary>séries de polices</primary></indexterm>
+<para>Sélectionne une série de police. Une <firstterm>série</firstterm> combine une
+<firstterm>graisse</firstterm> et une <firstterm>largeur</firstterm>. Typiquement, une police prend en
+charge seulement quelques-unes des combinaisons possibles. Les
+combinaisons de valeurs de séries comprennent notamment :
+</para>
+<informaltable><tgroup cols="2"><colspec colwidth="2*"></colspec><colspec colwidth="16*"></colspec><tbody><row><entry><para><literal>m</literal>
+</para></entry><entry><para>Moyen (normal)
+</para></entry></row><row><entry><para><literal>b</literal>
+</para></entry><entry><para>Gras
+</para></entry></row><row><entry><para><literal>c</literal>
+</para></entry><entry><para>Condensé
+</para></entry></row><row><entry><para><literal>bc</literal>
+</para></entry><entry><para>Condensé Gras
+</para></entry></row><row><entry><para><literal>bx</literal>
+</para></entry><entry><para>Gras étendu
+</para></entry></row></tbody></tgroup></informaltable>
+
+<indexterm role="cp"><primary>graisses de police</primary></indexterm>
+<para>Les valeurs possibles de graisses, considérées individuellement, sont :
+</para>
+<informaltable><tgroup cols="2"><colspec colwidth="2*"></colspec><colspec colwidth="28*"></colspec><tbody><row><entry><para><literal>ul</literal>
+</para></entry><entry><para>Ultra maigre
+</para></entry></row><row><entry><para><literal>el</literal>
+</para></entry><entry><para>Extra maigre
+</para></entry></row><row><entry><para><literal>l</literal>
+</para></entry><entry><para>Maigre (<emphasis role="bold">L</emphasis>ight)
+</para></entry></row><row><entry><para><literal>sl</literal>
+</para></entry><entry><para>Semi maigre
+</para></entry></row><row><entry><para><literal>m</literal>
+</para></entry><entry><para>Demi-gras (<emphasis role="bold">M</emphasis>edium, normal)
+</para></entry></row><row><entry><para><literal>sb</literal>
+</para></entry><entry><para>Semi gras
+</para></entry></row><row><entry><para><literal>b</literal>
+</para></entry><entry><para>Gras (<emphasis role="bold">B</emphasis>old)
+</para></entry></row><row><entry><para><literal>eb</literal>
+</para></entry><entry><para>Extra gras
+</para></entry></row><row><entry><para><literal>ub</literal>
+</para></entry><entry><para>Ultra gras
+</para></entry></row></tbody></tgroup></informaltable>
+
+<indexterm role="cp"><primary>Largeurs de police</primary></indexterm>
+<para>La valeurs possibles de largeur, considérées individuellement sont :
+</para>
+<informaltable><tgroup cols="2"><colspec colwidth="2*"></colspec><colspec colwidth="16*"></colspec><tbody><row><entry><para><literal>uc</literal>
+</para></entry><entry><para>Ultra condensé
+</para></entry></row><row><entry><para><literal>ec</literal>
+</para></entry><entry><para>Extra condensé
+</para></entry></row><row><entry><para><literal>c</literal>
+</para></entry><entry><para>Condensé
+</para></entry></row><row><entry><para><literal>sc</literal>
+</para></entry><entry><para>Semi condensé
+</para></entry></row><row><entry><para><literal>m</literal>
+</para></entry><entry><para>Moyen
+</para></entry></row><row><entry><para><literal>sx</literal>
+</para></entry><entry><para>Semi étendu
+</para></entry></row><row><entry><para><literal>x</literal>
+</para></entry><entry><para>étendu
+</para></entry></row><row><entry><para><literal>ex</literal>
+</para></entry><entry><para>Extra étendu
+</para></entry></row><row><entry><para><literal>ux</literal>
+</para></entry><entry><para>Ultra étendu
+</para></entry></row></tbody></tgroup></informaltable>
+<para>Quand Lorsqu&#8217;on forme la chaîne de caractères <replaceable>série</replaceable> à partir de la
+graisse et de la largeur, on laisse tomber le <literal>m</literal> qui signifie
+medium concernant la graisse ou la largeur, auquel cas on en utilise
+juste un (&#8216;<literal><literal>m</literal></literal>&#8217;).
</para>
-</listitem></varlistentry><varlistentry><term><literal>\fontshape{forme}</literal>
+</listitem></varlistentry><varlistentry><term><literal>\fontshape{<replaceable>allure</replaceable>}</literal>
</term><listitem><indexterm role="fn"><primary>\fontshape</primary></indexterm>
-<para>Sélectionnez l&#8217;allure de police. Les allures valides sont :
-</para>
-<itemizedlist><listitem><para><literal>n</literal> Droit (normal)
-</para></listitem><listitem><para><literal>it</literal> Italique
-</para></listitem><listitem><para><literal>sl</literal> Incliné (oblique)
-</para></listitem><listitem><para><literal>sc</literal> Petites capitales
-</para></listitem><listitem><para><literal>ui</literal> Italique droit
-</para></listitem><listitem><para><literal>ol</literal> Plan
-</para></listitem></itemizedlist>
+<indexterm role="cp"><primary>allure de police</primary></indexterm>
+<para>Sélectionne l&#8217;allure de police. Les allures valides sont :
+</para>
+<informaltable><tgroup cols="2"><colspec colwidth="2*"></colspec><colspec colwidth="19*"></colspec><tbody><row><entry><para><literal>n</literal>
+</para></entry><entry><para>Droit (normal)
+</para></entry></row><row><entry><para><literal>it</literal>
+</para></entry><entry><para>Italique
+</para></entry></row><row><entry><para><literal>sl</literal>
+</para></entry><entry><para>Incliné (oblique)
+</para></entry></row><row><entry><para><literal>sc</literal>
+</para></entry><entry><para>Petites capitales
+</para></entry></row><row><entry><para><literal>ui</literal>
+</para></entry><entry><para>Italique droit
+</para></entry></row><row><entry><para><literal>ol</literal>
+</para></entry><entry><para>Plan
+</para></entry></row></tbody></tgroup></informaltable>
<para>Les deux dernières allures ne sont pas disponibles pour la plupart des
-familles de polices.
+familles de polices, et les petites capitales sont aussi souvent
+absentes.
</para>
-</listitem></varlistentry><varlistentry><term><literal>\fontsize{taille}{interligne}</literal>
+</listitem></varlistentry><varlistentry><term><literal>\fontsize{<replaceable>taille</replaceable>}{<replaceable>interligne</replaceable>}</literal>
</term><listitem><indexterm role="fn"><primary>\fontsize</primary></indexterm>
<indexterm role="fn"><primary>\baselineskip</primary></indexterm>
-<para>Réglage de la taille de police. Le premier paramètre est la taille de la
-police pour basculer et le deuxième est l&#8217;espacement d&#8217;interligne ; ceci
-est stocké dans un paramètre nommé <literal>\baselineskip</literal>. L&#8217;unité des
-deux paramètres est par défaut le <literal>pt</literal>. La valeur par défaut de
-<literal>\baselineskip</literal> pour la police Computer Modern est 1,2 fois le
-<literal>\fontsize</literal>.
-</para>
-<indexterm role="fn"><primary>\baselinestretch</primary></indexterm>
+<para>Réglage de la taille de police et de l&#8217;espacement d&#8217;interligne. L&#8217;unité
+des deux paramètres est par défaut le point (<literal>pt</literal>). L&#8217;espaceement
+d&#8217;interligne est l&#8217;espace vertiical nominal entre ligne, de ligne de
+base à ligne de base. Il est stocké dans le paramètre
+<literal>\baselineskip</literal>. La valeur par défaut de <literal>\baselineskip</literal> pour
+la police Computer Modern est 1,2 fois le <literal>\fontsize</literal>. Changer
+directement <literal>\baselineskip</literal> est déconseillé dans la mesuure où sa
+valeur est réinitialisée à chaque fois qu&#8217;un changement de taille se
+produit ; voir ensuite <literal>\baselinestretch</literal>.
+</para>
+</listitem></varlistentry><varlistentry><term><literal>\baselinestretch</literal>
+</term><listitem><indexterm role="fn"><primary>\baselinestretch</primary></indexterm>
+<para>L&#8217;espacement des lignes est également multiplié par la valeur du
+paramètre <literal>\baselinestretch</literal> ; la valeur par défaut est 1. Tout
+changement prend effet losque <literal>\selectfont</literal> (voir plus bas) est
+appelé. Vous pouvez modifier l&#8217;interligne pour tout le document en
+faisant, par ex. pour le doubler,
+<literal>\renewcommand{\baselinestretch}{2.0}</literal> dans le préambule,
+</para>
<indexterm role="fn"><primary>paquetage <literal>setspace</literal></primary></indexterm>
<indexterm role="fn"><primary><literal>setspace</literal>, paquetage</primary></indexterm>
-<indexterm role="cp"><primary>interligne double</primary></indexterm>
-<para>L&#8217;espacement des lignes est également multiplié par la valeur du
-paramètre <literal>\baselinestretch</literal> en cas de changement de taille de
-type ;<!-- vincentb1: Je ne comprends pas when the type size changes -->
-la valeur défaut est 1. Cependant, la meilleure façon de mettre
-un document en &#8220;espacement double&#8221;, si vous avez la malchance d&#8217;avoir
-à produire une telle chose, est d&#8217;utiliser le paquetage
-<literal>setspace</literal> ; voir
-<ulink url="http://www.tex.ac.uk/cgi-bin/texfaq2html?label=linespace">http://www.tex.ac.uk/cgi-bin/texfaq2html?label=linespace</ulink>.
-</para>
-<indexterm role="fn"><primary>\linespread</primary></indexterm>
+<indexterm role="cp"><primary>interligne double</primary></indexterm>
+<para>Cependant, la meilleure façon de mettre un document en « espacement
+double » est d&#8217;utiliser le paquetage <literal>setspace</literal>. En plus de
+proposer une pluralité d&#8217;options d&#8217;espacement, ce paquetage conserve un
+interligne simple là où c&#8217;est typiquement désirable, comme dans les
+notes de bas de page et dans les légendes de figure. Voir la
+documentation du paquetage.
+</para>
</listitem></varlistentry><varlistentry><term><literal>\linespread{<replaceable>facteur</replaceable>}</literal>
-</term><listitem><para>Est équivalent à
+</term><listitem><indexterm role="fn"><primary>\linespread</primary></indexterm>
+<para>Est équivalent à
<literal>\renewcommand{\baselinestretch}{<replaceable>facteur</replaceable>}</literal>, et doit donc
être suivie par <literal>\selectfont</literal> pour avoir un effet. Il vaut mieux
que ce soit dans le préambule, ou utiliser le paquetage <literal>setspace</literal>,
-comme décrit juste au-dessus.
+comme on vient de le décrire.
</para>
-<indexterm role="fn"><primary>\selectfont</primary></indexterm>
+</listitem></varlistentry><varlistentry><term><literal>\selectfont</literal>
+</term><listitem><indexterm role="fn"><primary>\selectfont</primary></indexterm>
<para>Les modifications apportées en appelant les commandes de polices
décrites ci-dessus n&#8217;entrent en vigueur qu&#8217;après que <literal>\selectfont</literal>
-est appelé.
+est appelé, comme dans
+<literal>\fontfamily{<replaceable>nomfamille</replaceable>}\selectfont</literal>. La plupart du temps
+il est plus pratique de mettre cela dans une macro :
+<literal>\newcommand*{\mapolice}{\fontfamily{<replaceable>nomfamille</replaceable>}\selectfont}</literal>
+
+(see <link linkend="_005cnewcommand-_0026-_005crenewcommand">\newcommand &amp; \renewcommand</link>).
</para>
-</listitem></varlistentry><varlistentry><term><literal>\usefont{codage}{famille}{série}{forme}</literal>
+
+</listitem></varlistentry><varlistentry><term><literal>\usefont{<replaceable>codage</replaceable>}{<replaceable>famille</replaceable>}{<replaceable>série</replaceable>}{<replaceable>allure</replaceable>}</literal>
</term><listitem><indexterm role="fn"><primary>\usefont</primary></indexterm>
<para>Revient à la même chose que d&#8217;invoquer <literal>\fontencoding</literal>,
<literal>\fontfamily</literal>, <literal>\fontseries</literal> et <literal>\fontshape</literal> avec les
-paramètres donnés, suivi par <literal>\selectfont</literal>.
+paramètres donnés, suivi par <literal>\selectfont</literal>. Par exemple :
</para>
+<screen>\usefont{ot1}{cmr}{m}{n}
+</screen>
</listitem></varlistentry></variablelist>
</sect1>
@@ -1969,7 +1889,7 @@ paramètres donnés, suivi par <literal>\selectfont</literal>.
<title>Mise en page</title>
<indexterm role="cp"><primary>commandes de mise en page</primary></indexterm>
-<para>Diverses commandes pour contrôler la disposition générale de la page.
+<para>Commandes pour contrôler la disposition générale de la page.
</para>
@@ -2049,7 +1969,7 @@ même hauteur, en ajoutant de k&#8217;espace vertical supplémentaire si
nécessaire pour remplir le page.
</para>
<para>C&#8217;est la valeur par défaut si le mode <literal>twocolumn</literal> est sélectionné
-(voir <link linkend="Document-class-options">Document class options</link>).
+(see <link linkend="Document-class-options">Document class options</link>).
</para>
</sect1>
<sect1 label="5.4" id="_005craggedbottom">
@@ -2091,9 +2011,9 @@ classe <literal>book</literal> où elle varie avec la taille de la police.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\linewidth</primary></indexterm><literal>\linewidth</literal>
</term><listitem><para>Largeur de la ligne actuelle, diminuée pour chaque <literal>list</literal> imbriquée
-(voir <link linkend="list">list</link>). Plus précisément, elle est inférieure à
+(see <link linkend="list">list</link>). Plus précisément, elle est inférieure à
<literal>\textwidth</literal> par la somme de <literal>\leftmargin</literal> et
-<literal>\rightmargin</literal> (voir <link linkend="itemize">itemize</link>). La valeur par défaut varie en
+<literal>\rightmargin</literal> (see <link linkend="itemize">itemize</link>). La valeur par défaut varie en
fonction de la taille de la police, la largeur du papier, le mode à deux
colonnes, etc. Pour un document de classe <literal>article</literal> en taille de
police &#8216;<literal>10pt</literal>&#8217;, elle vaut &#8216;<literal>345pt</literal>&#8217; ; dans le mode à deux
@@ -2112,13 +2032,13 @@ une classe <literal>book</literal>, elle vaut &#8216;<literal>41\baselineskip</l
</term><listitem><para>La hauteur du papier, à ne pas confondre avec la hauteur de la zone
d&#8217;impression. Elle est normalement réglée avec une option de classe de
document, comme dans <literal>\documentclass[a4paper]{article}</literal>
-(voir <link linkend="Document-class-options">Options de classe de document</link>).
+(see <link linkend="Document-class-options">Options de classe de document</link>).
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\paperwidth</primary></indexterm><literal>\paperwidth</literal>
</term><listitem><para>La largeur du papier, à ne pas confondre avec la largeur de la zone
d&#8217;impression. Elle est normalement réglée avec une option de classe de
document, comme dans <literal>\documentclass[a4paper]{article}</literal>
-(voir <link linkend="Document-class-options">Options de classe de document</link>).
+(see <link linkend="Document-class-options">Options de classe de document</link>).
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\textwidth</primary></indexterm><literal>\textwidth</literal>
</term><listitem><para>La largeur horizontale totale de l&#8217;ensemble du corps de la page; la
@@ -2130,15 +2050,15 @@ taille de police, &#8216;<literal>360pt</literal>&#8217; à &#8216;<literal>11pt
</para>
<para>En sortie multi-colonne, <literal>\textwidth</literal> reste de la largeur de tout
le corps de la page, tandis que <literal>\columnwidth</literal> est la largeur d&#8217;une
-colonne (voir <link linkend="_005ctwocolumn">\twocolumn</link>).
+colonne (see <link linkend="_005ctwocolumn">\twocolumn</link>).
</para>
-<para>Dans les listes (voir <link linkend="list">list</link>), <literal>\textwidth</literal> est le reste la
+<para>Dans les listes (see <link linkend="list">list</link>), <literal>\textwidth</literal> est le reste la
largeur du corps corps de la page entière (et <literal>\columnwidth</literal> est la
largeur d&#8217;une colonne entière), alors que <literal>\linewidth</literal> peut
diminuer au sein de listes imbriquées.
</para>
-<para>À l&#8217;intérieur d&#8217;une minipage (voir <link linkend="minipage">minipage</link> ) ou <literal>\parbox</literal>
-(voir <link linkend="_005cparbox">\parbox</link>), tous les paramètres liés à la largeur sont mis à la
+<para>À l&#8217;intérieur d&#8217;une minipage (see <link linkend="minipage">minipage</link> ) ou <literal>\parbox</literal>
+(see <link linkend="_005cparbox">\parbox</link>), tous les paramètres liés à la largeur sont mis à la
largeur spécifiée, et de reviennent à leurs valeurs normales à la fin du
<literal>minipage</literal> ou <literal>\parbox</literal>.
</para>
@@ -2170,8 +2090,8 @@ composés en dehors du flux normal du texte, par exemple flottant au
sommet d&#8217;une page ultérieure
</para>
<para>&latex; sait gérer plusieurs classes de matériel flottant. Il y a deux
-classes définies par défaut, <literal>figure</literal> (voir <link linkend="figure">figure</link>) et
-<literal>table</literal> (voir <link linkend="table">table</link>), mais vous pouvez créer une nouvelle
+classes définies par défaut, <literal>figure</literal> (see <link linkend="figure">figure</link>) et
+<literal>table</literal> (see <link linkend="table">table</link>), mais vous pouvez créer une nouvelle
classes avec le paquetage <filename>float</filename>.
</para>
<para>Au sein d&#8217;une même classe flottante &latex; respecte l&#8217;ordre, de sorte
@@ -2221,6 +2141,7 @@ autorisé en soi-même ; <literal>t</literal> est ajouté automatiquement.
<indexterm role="cp"><primary>ici, placer les flottants</primary></indexterm>
<indexterm role="fn"><primary>paquetage <literal>float</literal></primary></indexterm>
<indexterm role="fn"><primary><literal>float</literal>, paquetage</primary></indexterm>
+
<para>Pour forcer à tout prix un flottant à apparaître « ici », vous pouvez
charger le paquetage <filename>float</filename> et le spécificateur <literal>H</literal> qui y est
défini. Pour plus ample discussion, voir l&#8217;entrée de FAQ à
@@ -2260,6 +2181,7 @@ non placés.
</para>
<indexterm role="fn"><primary>paquetage <literal>flafter</literal></primary></indexterm>
<indexterm role="fn"><primary><literal>flafter</literal>, paquetage</primary></indexterm>
+
<para>&latex; peut composer un flottant avant l&#8217;endroit où il apparaît dans
le code source (quoique sur la même page de sortie) s&#8217;il y a un
spécificateur <literal>t</literal> au sein du paramètre <replaceable>placement</replaceable>. Si ceci
@@ -2344,111 +2266,1037 @@ infuence the position of float environments like figure and table in
</sect1>
</chapter>
<chapter label="6" id="Sectioning">
-<title>Des rubriques</title>
+<title>Rubricage</title>
+
+<indexterm role="cp"><primary>rubricage, commandes</primary></indexterm>
+<indexterm role="cp"><primary>commandes de rubricage,</primary></indexterm>
+<indexterm role="cp"><primary><literal>part</literal></primary></indexterm>
+<indexterm role="cp"><primary>partie</primary></indexterm>
+<indexterm role="cp"><primary><literal>chapter</literal></primary></indexterm>
+<indexterm role="cp"><primary>chapitre</primary></indexterm>
+<indexterm role="cp"><primary>section</primary></indexterm>
+<indexterm role="cp"><primary><literal>subsection</literal></primary></indexterm>
+<indexterm role="cp"><primary>sous-section</primary></indexterm>
+<indexterm role="cp"><primary><literal>subsubsection</literal></primary></indexterm>
+<indexterm role="cp"><primary>sous-sous-section</primary></indexterm>
+<indexterm role="cp"><primary><literal>paragraph</literal></primary></indexterm>
+<indexterm role="cp"><primary>paragraphe</primary></indexterm>
+<indexterm role="cp"><primary><literal>subparagraph</literal></primary></indexterm>
+<indexterm role="cp"><primary>sous-paragraphe</primary></indexterm>
+<indexterm role="fn"><primary>\part</primary></indexterm>
+<indexterm role="fn"><primary>\chapter</primary></indexterm>
+<indexterm role="fn"><primary>\section</primary></indexterm>
+<indexterm role="fn"><primary>\subsection</primary></indexterm>
+<indexterm role="fn"><primary>\subsubsection</primary></indexterm>
+<indexterm role="fn"><primary>\paragraph</primary></indexterm>
+<indexterm role="fn"><primary>\subparagraph</primary></indexterm>
+
+<para>Structure votre texte en rubriques : parties, chapitres, sections,
+etc. Toutes les commandes de rubricage ont la même forme, l&#8217;une parmi :
+</para>
+<screen><replaceable>cmd-de-rubricage</replaceable>{<replaceable>titre</replaceable>}
+<replaceable>cmd-de-rubricage</replaceable>*{<replaceable>titre</replaceable>}
+<replaceable>cmd-de-rubricage</replaceable>[<replaceable>titre-tdm</replaceable>]{<replaceable>titre</replaceable>}
+</screen>
+<para>Par exemple, déclarez le début d&#8217;une sous-section comme dans
+<literal>\subsection{Motivation}</literal>.
+</para>
+<para>Le tableau suivant comprend chacune des commandes <replaceable>cmd-de-rubricage</replaceable>
+de &latex;. Toutes sont disponibles dans toutes les classes de
+document standardes de &latex; <literal>book</literal>, <literal>report</literal>,
+et <literal>article</literal>, à ceci près que <literal>\chapter</literal> n&#8217;est pas disponible
+dans <literal>article</literal>.
+</para>
+<informaltable><tgroup cols="3"><colspec colwidth="25*"></colspec><colspec colwidth="25*"></colspec><colspec colwidth="40*"></colspec><thead><row><entry><para>Type de rubrique </para></entry><entry><para>Commande </para></entry><entry><para>Niveau
+</para></entry></row></thead><tbody><row><entry><para>Part
+</para></entry><entry><para><literal>\part</literal> </para></entry><entry><para>-1 (<literal>book</literal>, <literal>report</literal>), 0 (<literal>article</literal>)
+</para></entry></row><row><entry><para>Chapter
+</para></entry><entry><para><literal>\chapter</literal> </para></entry><entry><para>0
+</para></entry></row><row><entry><para>Section
+</para></entry><entry><para><literal>\section</literal> </para></entry><entry><para>1
+</para></entry></row><row><entry><para>Subsection
+</para></entry><entry><para><literal>\subsection</literal> </para></entry><entry><para>2
+</para></entry></row><row><entry><para>Subsubsection
+</para></entry><entry><para><literal>\subsubsection</literal> </para></entry><entry><para>3
+</para></entry></row><row><entry><para>Paragraph
+</para></entry><entry><para><literal>\paragraph</literal> </para></entry><entry><para>4
+</para></entry></row><row><entry><para>Subparagraph
+</para></entry><entry><para><literal>\subparagraph</literal> </para></entry><entry><para>5
+</para></entry></row></tbody></tgroup></informaltable>
+
+<indexterm role="cp"><primary><literal>*</literal>, forme en <literal>*</literal> des commandes de rubricage</primary></indexterm>
+<indexterm role="cp"><primary>étoilée, forme des commandes de rubricage</primary></indexterm>
+<indexterm role="cp"><primary>forme étoilée de commandes de rubricage</primary></indexterm>
+<indexterm role="cp"><primary>forme en * de commandes de rubricage</primary></indexterm>
+<para>Toutes ces commandes ont une forme en <literal>*</literal>, aussi appelée étoilée,
+qui imprime <replaceable>titre</replaceable> comme d&#8217;habitude mais sans le numéroter et sans
+fabriquer une entrée dans la table des matières. Un exemple
+d&#8217;utilisation est pour un appendice dans un <literal>article</literal>. Entrer le
+code <literal>\appendix\section{Appendice}</literal> donne en sortie &#8216;<literal>A
+Appendix</literal>&#8217; (see <link linkend="_005cappendix">\appendix</link>). Vous pouvez ôter le numéro &#8216;<literal>A</literal>&#8217; en
+entrant à la place <literal>\section*{Appendice}</literal> (les articles omettent
+couramment d&#8217;avoir une table des matières et ont des en-têtes de pages
+simples alors les autres différences de la commande <literal>\section</literal>
+peuvent être négligées).
+</para>
+<para>Le titre <replaceable>titre</replaceable> fournit la rubrique en tant que titre dans le texte
+principal, mais il peut également apparaître dans la table des matières
+et le haut et le bas de bage (see <link linkend="Page-styles">Page styles</link>). Vous pourriez
+désirer un texte différent à ces endroits que dans le texte principal.
+Toute ces commandes ont un argument optionnel <replaceable>tdm-titre</replaceable> destiné à
+ces autres endroits.
+</para>
+<para>Le numéro dans la colonne &#171;Niveau&#187; de la
+table ci-dessus détermine quelles rubriques sont numérotées, et
+lesquelles apparaissent dans la table des matières. Si le <replaceable>niveau</replaceable>
+de la commande de rubricage est inférieur ou égal à la valeur du
+compteur <literal>secnumdepth</literal> alors les rubriques correspondant à ces
+commandes de rubricage sont numérotées (see <link linkend="Sectioning_002fsecnumdepth">Sectioning/secnumdepth</link>).
+Et, si <replaceable>niveau</replaceable> est inférieur ou égal à la valeur du compteur
+<literal>tocdepth</literal> alors la table des matières comprend une entrée pour
+cette rubrique (see <link linkend="Sectioning_002ftocdepth">Sectioning/tocdepth</link>).
+</para>
+<para>&latex; s&#8217;attend que avant d&#8217;avoir une <literal>\subsection</literal> vous ayez une
+ <literal>\section</literal> et, dans un document de classe <literal>book</literal>, qu&#8217;avant
+ une <literal>\section</literal> vous ayez un <literal>\chapter</literal>. Autrement vous
+ pourriez obtenir quelque-chose comme une sous-sesction numérotée
+ &#8216;<literal>3.0.1</literal>&#8217;.
+</para>
+<indexterm role="fn"><primary>paquetage <literal>titlesec</literal></primary></indexterm>
+<indexterm role="fn"><primary><literal>titlesec</literal>, paquetage</primary></indexterm>
+
+<para>&latex; vous permet de changer l&#8217;apparence des rubriques. Un exemple
+simple de ceci est que vous pouvez mettre le numéro de rubrique de type
+section en lettres majuscules avec
+<literal>\renewcommand\thesection{\Alph{section}}</literal> dans le préambule
+(see <link linkend="_005calph-_005cAlph-_005carabic-_005croman-_005cRoman-_005cfnsymbol">\alph \Alph \arabic \roman \Roman \fnsymbol</link>). Le CTAN a
+beaucoup de paquetages rendant ce genre d&#8217;ajustement plus facile,
+notamment <filename>titlesec</filename>.
+</para>
+<para>Deux compteurs sont en relation avec l&#8217;apparence des rubriques fabriquées
+par les commandes de rubricage.
+</para>
+<variablelist><varlistentry><term><indexterm role="fn"><primary>secnumdepth</primary></indexterm><literal>secnumdepth</literal>
+</term><listitem><indexterm role="fn"><primary>secnumdepth compteur</primary></indexterm>
+<indexterm role="cp"><primary>numéros de rubrique, composition</primary></indexterm>
+<anchor id="sectioning-secnumdepth"/><anchor id="Sectioning_002fsecnumdepth"/><para>Le compteur <literal>secnumdepth</literal> contrôle quels titres de rubriques sont
+numérotés. Régler le compteur avec
+<literal>\setcounter{secnumdepth}{<replaceable>niveau</replaceable>}</literal> supprime la
+numérotation des rubriques à toute profondeur supérieure à <replaceable>niveau</replaceable>
+(See <link linkend="_005csetcounter">\setcounter</link>). Voir la table plus haut pour la valeur des
+niveaux. Par exemple, si le <literal>secnumdepth</literal> vaut 1 dans un
+<literal>article</literal> alors la commande <literal>\section{Introduction}</literal> produit
+en sortie quelque-chose comme &#8216;<literal>1 Introduction</literal>&#8217; alors que
+<literal>\subsection{Discussion}</literal> produit quelque-chose comme
+&#8216;<literal>Discussion</literal>&#8217;, sans numéro. La valeur par défaut de &latex; pour
+<literal>secnumdepth</literal> vaut 3 dans la classe <filename>article</filename> et 2 dans les
+classes <filename>book</filename> et <filename>report</filename>.
+</para>
+</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>tocdepth</primary></indexterm><literal>tocdepth</literal>
+</term><listitem><indexterm role="fn"><primary>tocdepth counter</primary></indexterm>
+<indexterm role="cp"><primary>table des matières, impression des numéros de rubrique</primary></indexterm>
+<anchor id="sectioning-tocdepth"/><anchor id="Sectioning_002ftocdepth"/><para>Contrôle quelles rubriques sont listées dans la table des matières.
+Régler <literal>\setcounter{tocdepth}{<replaceable>niveau</replaceable>}</literal> a pour effet que
+les rubriques au niveau <replaceable>niveau</replaceable> sont celles de plus petit niveau à
+être listées (see <link linkend="_005csetcounter">\setcounter</link>). Voir la table ci-dessus pour les
+numéros de niveau. Par exemple, if <literal>tocdepth</literal> vaut 1 alors la table
+des matières contiendra les rubriques issues de <literal>\section</literal>, mais pas
+celles de <literal>\subsection</literal>. La valeur par défaut de &latex; pour
+<literal>tocdepth</literal> vaut 3 dans la classe <filename>article</filename> et 2 dans les
+classes <filename>book</filename> et <filename>report</filename>.
+</para></listitem></varlistentry></variablelist>
+
-<indexterm role="cp"><primary>rubricage</primary></indexterm>
-<para>Les commandes de rubricage fournissent les moyens de structurer
-votre texte en unités sectionnelles, ou rubriques :
+<sect1 label="6.1" id="_005cpart">
+<title><literal>\part</literal></title>
+
+<indexterm role="fn"><primary>\part</primary></indexterm>
+<indexterm role="cp"><primary>part</primary></indexterm>
+<indexterm role="cp"><primary>rubricage, part</primary></indexterm>
+
+<para>Synopsis, l&#8217;un parmi :
</para>
-<variablelist><varlistentry><term><indexterm role="fn"><primary>\part</primary></indexterm><literal>\part</literal>
-</term></varlistentry><varlistentry><term><indexterm role="fn"><primary>\chapter (seulement pour classes <literal>report</literal> et <literal>book</literal>)</primary></indexterm><literal>\chapter (seulement pour classes <literal>report</literal> et <literal>book</literal>)</literal>
-</term></varlistentry><varlistentry><term><indexterm role="fn"><primary>\section</primary></indexterm><literal>\section</literal>
-</term></varlistentry><varlistentry><term><indexterm role="fn"><primary>\paragraph</primary></indexterm><literal>\paragraph</literal>
-</term></varlistentry><varlistentry><term><indexterm role="fn"><primary>\subsubsection</primary></indexterm><literal>\subsubsection</literal>
-</term></varlistentry><varlistentry><term><indexterm role="fn"><primary>\paragraph</primary></indexterm><literal>\paragraph</literal>
-</term></varlistentry><varlistentry><term><indexterm role="fn"><primary>\alinea</primary></indexterm><literal>\alinea</literal>
-</term></varlistentry></variablelist>
-<para>Toutes les commandes ont la même forme générale, par exemple,
+<screen>\part{<replaceable>titre</replaceable>}
+\part*{<replaceable>titre</replaceable>}
+\part[<replaceable>tdm-titre</replaceable>]{<replaceable>titre</replaceable>}
+</screen>
+<para>Début une partie de document. Les classes standarde &latex;
+<literal>book</literal>, <literal>report</literal>, et <literal>article</literal> offrent toutes cette
+commande.
</para>
-<screen>\chapter[<replaceable>titretdm</replaceable>]{<replaceable>titre</replaceable>}
+<para>L&#8217;exemple suivant produit une partie de document dans un livre :
+</para>
+<!-- xxx à traduire -->
+<screen>\part{VOLUME I \\
+ PERSONAL MEMOIRS OF U.\ S.\ GRANT}
+\chapter{ANCESTRY--BIRTH--BOYHOOD.}
+My family is American, and has been for generations,
+in all its branches, direct and collateral.
</screen>
-<para>En plus de fournir le titre de rubrique <replaceable>titre</replaceable> dans le texte
-principal, le titre peut apparaître dans deux autres endroits :
+<para>Dans chaque classe standarde la commande <literal>\part</literal> produit en sortie
+un numéro de partie tel que &#8216;<literal>Première partie</literal>&#8217;, seul sur sa ligne,
+en caractère gras, et en gros caractères. Ensuite &latex; produit en
+sortie <replaceable>titre</replaceable>, également seule sur sa ligne, en caractère gras et
+en caractères encore plus gros.
+Dans la classe <literal>book</literal>, le comportement par défaut de &latex; est
+de mettre chaque titre de partie seule sur sa propre page. Si le livre
+est en recto-verso alors &latex; saute une page si nécessaire pour que
+la nouvelle partie commence sur une page à numéro impair. Dans un
+<literal>report</literal> il est également seul sur une page, mais &latex; ne force
+pas qu&#8217;elle soit de numéro impair. Dans un <literal>article</literal> &latex; ne
+le place pas sur une nouvelle page, mais au lieu de cela produit en
+sortie le numéro de partie et le titre de partie sur la même page que le
+document principal.
</para>
-<orderedlist numeration="arabic"><listitem><para>La table des matières.
-</para></listitem><listitem><para>L&#8217;en-tête en cours de traitement en haut de la page.
-</para></listitem></orderedlist>
-<para>Vous ne voudrez peut-être pas le même texte dans ces endroits que dans
-le texte principal. Pour gérer cela, les commandes de rubricage ont
-un argument optionnel <replaceable>titretdm</replaceable> qui, lorsqu&#8217;il est fourni, précise
-le texte de ces autres endroits.
+<para>La forme en <literal>*</literal> imprime <replaceable>titre</replaceable> mais n&#8217;imprime pas le numéro de
+partie, et n&#8217;incrémente pas le compteur <literal>part</literal>, et ne produit
+aucune entrée dans la table des matières.
</para>
-<indexterm role="cp"><primary>forme étoilée de commandes de rubricage</primary></indexterm>
-<indexterm role="cp"><primary>forme en * de commandes de rubricage</primary></indexterm>
-<para>En outre, toutes les commandes de rubricage ont des formes en
-<literal>*</literal>, aussi appelée étoilée, qui compose <replaceable>titre</replaceable> comme
-d&#8217;habitude, mais ne comprennent pas de numéro et ne produisent pas
-d&#8217;entrée dans la table des matières. Par exemple :
+<para>L&#8217;argument optionnel <replaceable>tdm-titre</replaceable> apparaît comme le titre de la
+partie dans la table des matières (see <link linkend="Table-of-contents-etc_002e">Table of contents etc.</link>) et
+dans les hauts de pages (see <link linkend="Page-styles">Page styles</link>). S&#8217;il n&#8217;est pas présent
+alors <replaceable>titre</replaceable> est utilisé à sa place. Dans l&#8217;exemple suivante on met
+un saut de ligne dans <replaceable>titre</replaceable> mais on l&#8217;enlève dans la table des
+matière.
+</para>
+<screen>\part[Up from the bottom; my life]{Up from the bottom\\ my life}
+</screen>
+<para>Pour déterminer quelles rubrique sont numéroté et lesquelles
+apparaissent dans la table des matières, le numéro de niveau d&#8217;une
+partie vaut -1 (see <link linkend="Sectioning_002fsecnumdepth">Sectioning/secnumdepth</link> et
+see <link linkend="Sectioning_002ftocdepth">Sectioning/tocdepth</link>).
+</para>
+<indexterm role="fn"><primary>paquetage <literal>indentfirst</literal></primary></indexterm>
+<indexterm role="fn"><primary><literal>indentfirst</literal>, paquetage</primary></indexterm>
+
+
+<para>Dans la classe <literal>article</literal>, si un paragraphe suit immédiatement le
+titre de partie alors il n&#8217;est pas renfoncé. Pour obtenir un
+renfoncement vous pouvez utiliser le paquetage <filename>indentfirst</filename>.
+</para>
+<indexterm role="fn"><primary>paquetage <literal>titlesec</literal></primary></indexterm>
+<indexterm role="fn"><primary><literal>titlesec</literal>, paquetage</primary></indexterm>
+
+<para>Un paquetage pour changer le comportement de <literal>\part</literal> est
+<filename>titlesec</filename>. Voir sa documentation sur le CTAN.
+</para>
+
+</sect1>
+<sect1 label="6.2" id="_005cchapter">
+<title><literal>\chapter</literal></title>
+
+<indexterm role="fn"><primary>\chapter</primary></indexterm>
+<indexterm role="cp"><primary>chapitre</primary></indexterm>
+
+<para>Synopsis, l&#8217;un parmi :
+</para>
+<screen>\chapter{<replaceable>titre</replaceable>}
+\chapter*{<replaceable>titre</replaceable>}
+\chapter[<replaceable>tdm-titre</replaceable>]{<replaceable>titre</replaceable>}
+</screen>
+<para>Commence un chapitre. Les classes standardes &latex; <literal>book</literal> et
+<literal>report</literal> ont cette commande, mais <literal>article</literal> non.
+</para>
+<para>L&#8217;exemple suivant produit un chapitre.
+</para>
+<screen>\chapter{Mirages}
+Appelez moi Ismaël.
+Voici quelques années --- peu importe combien --- le porte-monnaie vide
+ou presque, rien ne me retenant à terre, je songeai à naviguer un peu et
+à voir l'étendue liquide du globe.
+</screen>
+<para>Le comportement par défaut de &latex; est de commence chaque chapitre
+sur une page neuve, une page à numéro impair si le document est en
+recto-verso. Il produit un numéro de chapitre tel que &#8216;<literal>Chapitre 1</literal>&#8217;
+en gros caractère gras (la taille est <literal>\huge</literal>). Ensuite il place le
+<replaceable>titre</replaceable> sur une nouvelle ligne, en caractère gras encore plus gros
+(taille <literal>\Huge</literal>). Il incrémente également le compteur
+<literal>chapter</literal>, ajoute une entrée à la table des matières (see <link linkend="Table-of-contents-etc_002e">Table
+of contents etc.</link>), et règle l&#8217;information de haut de page (see <link linkend="Page-styles">Page
+styles</link>).
+</para>
+<para>La forme étoilée, ou forme en <literal>*</literal>, affiche <replaceable>titre</replaceable> sur une
+nouvelle ligne, en caractère gras. Mais elle n&#8217;affiche pas le numéro de
+chapitre, ni n&#8217;incrément le compteur <literal>chapter</literal>, et ne produit
+aucune entrée dans la table des matières, et n&#8217;affecte pas le haut de
+page. (Si vous utilise le style de page <literal>headings</literal> dans un
+document recto-version alors le haut de page sera dérivé du chapitre
+précédent). Voici un exemple illustrant cela :
+</para>
+<screen>\chapter*{Préambule}
+</screen>
+<para>L&#8217;argument optionnel <replaceable>tdm-titre</replaceable> apparaît comme titre de chapitre
+dans la tabvle des matières (see <link linkend="Table-of-contents-etc_002e">Table of contents etc.</link>) et dans les
+hauts de page (see <link linkend="Page-styles">Page styles</link>). Si il n&#8217;est pas présent alors
+<replaceable>titre</replaceable> sera à la place. L&#8217;exemple suivant montre le nom complet
+dans le titre de chapitre,
+</para>
+<screen>\chapter[Weyl]{Hermann Klaus Hugo (Peter) Weyl (1885--1955)}
+</screen>
+<para>mais seulement &#8216;<literal>Weyl</literal>&#8217; sur la page de table des matières. L&#8217;exemple
+suivant place un saut de ligne dans le titre, mais ceci ne fonctionne
+pas bien avec les haut de page, alors il omet le saut dans la table des
+matières
+</para>
+<screen>\chapter[J'ai tout donné ; mon histoire]{J'ai tout donné\\ mon histoire}
+</screen>
+<para>Pour déterminer quelles rubriques sont numérotées et lesquelles
+apparaissent dans la table des matières, le numéro de niveau d&#8217;un
+chapitre est 0 (see <link linkend="Sectioning_002fsecnumdepth">Sectioning/secnumdepth</link> et
+see <link linkend="Sectioning_002ftocdepth">Sectioning/tocdepth</link>).
+</para>
+<indexterm role="fn"><primary>paquetage <literal>indentfirst</literal></primary></indexterm>
+<indexterm role="fn"><primary><literal>indentfirst</literal>, paquetage</primary></indexterm>
+
+<!-- French version only -->
+<para>Lorsque chargez un paquetage d&#8217;internationalisation tel que
+<filename>babel</filename>, <filename>mlp</filename> ou <filename>polyglossia</filename>, et que la langue
+sélectionnée est le français, alors le premier paragraphe après le titre
+est normalement renfoncé, comme c&#8217;est la convention en typographie
+française. Par contre, si vous restez en langue par défaut,
+c-à-d. en anglo-américain,
+<!-- End French version only -->
+le paragraphe qui suit le titre de chapitre n&#8217;est pas renfoncé, étant donné que c&#8217;est
+<!-- French version only -->
+pour l&#8217;anglo-américain
+<!-- End French version only -->
+une pratique typographique standarde. Pour obtenir un renfoncement
+<!-- French version only -->
+dans ce cas
+<!-- End French version only -->
+utilisez le paquetage <filename>indentfirst</filename>.
+</para>
+<para>Vous pouvez changer ce qui est affiché pour le numéro de chapitre. Pour
+le changer en quelque-chose du genre de &#8216;<literal>Cours 1</literal>&#8217;, placez dans le
+préambule soit <literal>\renewcommand{\chaptername}{Cours}</literal>, soit
+cela (see <link linkend="_005cmakeatletter-_0026-_005cmakeatother">\makeatletter &amp; \makeatother</link>) :
</para>
-<screen>\section*{Préambule}
+<screen>\makeatletter
+\renewcommand{\@chapapp}{Cours}
+\makeatother
</screen>
+<indexterm role="fn"><primary>paquetage <literal>babel</literal></primary></indexterm>
+<indexterm role="fn"><primary><literal>babel</literal>, paquetage</primary></indexterm>
+
+<para>Pour que cela soit fonction de la langue principale du document, voir le paquetage <filename>babel</filename>.
+</para>
+<para>Dans un document recto-verso &latex; commence les chapitres sur des
+pages de numéro impair, en laissant si nécessaire une page de numéro
+pair blanche à l&#8217;exception d&#8217;un éventuel haut de page. Pour que cette
+page soit complètement blanche, voir <link linkend="_005cclearpage-_0026-_005ccleardoublepage">\clearpage &amp;
+\cleardoublepage</link>.
+</para>
+<indexterm role="fn"><primary>paquetage <literal>titlesec</literal></primary></indexterm>
+<indexterm role="fn"><primary><literal>titlesec</literal>, paquetage</primary></indexterm>
+
+<para>Pour changer le comportement de la commande <literal>\chapter</literal>, vous pouvez
+copier sa définition depuis le fichier de format &latex; et faire des
+ajustements. Mais il y a aussi beaucoup de paquetage sur le CTAN qui
+traitent de cela. L&#8217;un d&#8217;eux est <filename>titlesec</filename>. Voir sa
+documentation, mais l&#8217;exemple ci-dessous donne un aperçu de ce qu&#8217;il
+peut faire.
+</para>
+<screen>\usepackage{titlesec} % dans le préambule
+\titleformat{\chapter}
+ {\Huge\bfseries} % format du titre
+ {} % étiquette, tel que 1.2 pour une sous-section
+ {0pt} % longueur de séparation entre l'étiquette et le titre
+ {} % code crochet exécuté avant
+</screen>
+<para>Ceci omet le numéro de chapitre &#8216;<literal>Chapitre 1</literal>&#8217; de la page, mais
+contrairement à <literal>\chapter*</literal> cela conserve le chapitre dans la table
+des matière et dans les hauts de page.
+</para>
+
+</sect1>
+<sect1 label="6.3" id="_005csection">
+<title><literal>\section</literal></title>
+
+<indexterm role="fn"><primary>\section</primary></indexterm>
+<indexterm role="cp"><primary>section</primary></indexterm>
+
+<para>Synopsis, l&#8217;un parmi :
+</para>
+<screen>\section{<replaceable>titre</replaceable>}
+\section*{<replaceable>titre</replaceable>}
+\section[<replaceable>tdm-titre</replaceable>]{<replaceable>titre</replaceable>}
+</screen>
+<para>Commence une section. Les classes &latex; standardes <literal>article</literal>,
+<literal>book</literal>, et <literal>report</literal> ont toutes cette commande.
+</para>
+<para>L&#8217;exemple suivant produit une section :
+</para>
+<screen>Dans cette partie nous nous intéressons plutôt à la fonction, au
+comportement d'entrée-sortie, qu'aux détails de la réalisation de ce
+comportement.
+
+\section{Machines de Turing}
+En dépit de ce désir de rester évasif sur l'implémentation, nous suivons
+l'approche d'A.~Turing selon laquelle la première étape pour définir
+l'ensemble des fonctions calculables est de réflechir au détails de ce
+que des mécanismes peuvent faire.
+</screen>
+<para>Pour les classes standardes &latex; <literal>book</literal> et <literal>report</literal> la
+sortie par défaut est du genre de &#8216;<literal>1.2 <replaceable>titre</replaceable></literal>&#8217; (pour
+chapitre 1, section 2), seul sur sa ligne et fer à gauche, en caractères
+gras et plus gros (la taille de police est <literal>\Large</literal>). La même
+chose vaut pour <literal>article</literal> à ceci près qu&#8217;il n&#8217;y a pas de chapitre
+dans cette classe, et donc cela ressemble à &#8216;<literal>2 <replaceable>titre</replaceable></literal>&#8217;.
+</para>
+<para>La forme en <literal>*</literal> affiche <replaceable>titre</replaceable>. Mais elle n&#8217;affiche pas le
+numéro de section, ni n&#8217;incrémente le compteur <literal>section</literal>, ne
+produit aucune entrée dans la table des matière, et n&#8217;affecte pas le
+haut de page. (Si vous utilisez le style de page <literal>headings</literal> dans
+un document recto-verso, alors le titre de haut de page sera celui de la
+rubrique précédente).
+</para>
+<para>L&#8217;argument optionnel <replaceable>tdm-titre</replaceable> apparaît comme titre de section
+dans la table des matières (see <link linkend="Table-of-contents-etc_002e">Table of contents etc.</link>) et dans les
+titres de haut de page (see <link linkend="Page-styles">Page styles</link>). S&#8217;il n&#8217;est pas présent
+alors <replaceable>titre</replaceable> est à la place. L&#8217;exemple suivant montre le nom
+complet dans le titre de la section,
+</para>
+<screen>\section[Elisabeth~II]{Elisabeth deux,
+ Reine par la grâce de Dieu du Royaume Uni,
+ du Canada et de ses autres Royaumes et Territoires,
+ Chef du Commonwealth, Défenseur de la Foi.}
+</screen>
+<para>mais seulement &#8216;<literal>Elisabeth II</literal>&#8217; dans la table de matière et sur les
+hauts de page. Dans l&#8217;exemple suivant il y a un saut de ligne dans
+<replaceable>titre</replaceable> mais ça ne fonctionne pas pour la table des matières alors
+il est omis de la table des matières et des titres de hauts de page.
+</para>
+<screen>\section[La vérité c'est que j'ai menti ; histoire de ma vie]{La vérité
+c'est que j'ai menti\\ histoire de ma vie}
+</screen>
+<para>Pour déterminer quelles rubriques sont numérotées et lesquelles
+apparaissent dans la table des matières, le numéro de niveau d&#8217;une
+section est 1 (see <link linkend="Sectioning_002fsecnumdepth">Sectioning/secnumdepth</link> et
+see <link linkend="Sectioning_002ftocdepth">Sectioning/tocdepth</link>).
+</para>
+<indexterm role="fn"><primary>paquetage <literal>indentfirst</literal></primary></indexterm>
+<indexterm role="fn"><primary><literal>indentfirst</literal>, paquetage</primary></indexterm>
+
+<!-- French version only -->
+<para>Lorsque chargez un paquetage d&#8217;internationalisation tel que
+<filename>babel</filename>, <filename>mlp</filename> ou <filename>polyglossia</filename>, et que la langue
+sélectionnée est le français, alors le premier paragraphe après le titre
+est normalement renfoncé, comme c&#8217;est la convention en typographie
+française. Par contre, si vous restez en langue par défaut,
+c-à-d. en anglo-américain,
+<!-- End French version only -->
+le paragraphe qui suit le titre de section n&#8217;est pas renfoncé, étant donné que c&#8217;est
+<!-- French version only -->
+pour l&#8217;anglo-américain
+<!-- End French version only -->
+une pratique typographique standarde. Pour obtenir un renfoncement
+<!-- French version only -->
+dans ce cas
+<!-- End French version only -->
+utilisez le paquetage <filename>indentfirst</filename>.
+</para>
+<indexterm role="fn"><primary>paquetage <literal>titlesec</literal></primary></indexterm>
+<indexterm role="fn"><primary><literal>titlesec</literal>, paquetage</primary></indexterm>
+
+<para>En général, pour changer le comportement de la commande <literal>\section</literal>,
+il y a diverses options. L&#8217;une d&#8217;elles et la commande
+<literal>\@startsection</literal> (see <link linkend="_005c_0040startsection">\@startsection</link>). Il y a aussi un grand
+nombre de paquetages sur le CTAN traitant de cela, dont
+<filename>titlesec</filename>. Voir sa
+documentation, mais l&#8217;exemple ci-dessous donne un aperçu de ce qu&#8217;il
+peut faire.
+</para>
+<!-- credit: egreg https://groups.google.com/forum/#!topic/comp.text.tex/tvc8oM5P4y4 -->
+<screen>\usepackage{titlesec} % dans le préambule
+\titleformat{\section}
+ {\normalfont\Large\bfseries} % format du titre
+ {\makebox[1pc][r]{\thesection\hspace{1pc}}} % étiquette
+ {0pt} % longueur de séparation entre l'étiquette et le titre
+ {} % code crochet exécuté avant
+\titlespacing*{\section}
+ {-1pc}{18pt}{10pt}[10pc]
+</screen>
+<para>Cela met le numéro de section dans la marge.
+</para>
+
+</sect1>
+<sect1 label="6.4" id="_005csubsection">
+<title><literal>\subsection</literal></title>
+
+<indexterm role="fn"><primary>\subsection</primary></indexterm>
+<indexterm role="cp"><primary>subsection</primary></indexterm>
+
+<para>Synopsis, l&#8217;un parmi :
+</para>
+<screen>\subsection{<replaceable>titre</replaceable>}
+\subsection*{<replaceable>titre</replaceable>}
+\subsection[<replaceable>tdm-titre</replaceable>]{<replaceable>titre</replaceable>}
+</screen>
+<para>Commence une sous-section. Les classes &latex; standardes <literal>article</literal>,
+<literal>book</literal>, et <literal>report</literal> ont toutes cette commande.
+</para>
+<para>L&#8217;exemple suivant produit une sous-section :
+</para>
+<screen>Nous allons montrer qu'il y a plus de fonction que de machines de Turing
+et donc que certaines fonctions n'ont pas de machine associée.
+
+\subsection{Cardinal} Nous allons commencer par deux paradoxes qui
+mettent en scène le défi que pose à notre intuition la comparaison des
+tailles d'ensembles infinis.
+</screen>
+<para>Pour les classes &latex; standardes <literal>book</literal> et <literal>report</literal> la
+sortie par défaut est du genre de &#8216;<literal>1.2.3 <replaceable>titre</replaceable></literal>&#8217; (pour
+chapitre 1, section 2, sous-section 3), seul sur sa ligne et fer à
+gauche, en caractère gras et un peu plus gros (la taille de police est
+<literal>\large</literal>). La même chose vaut dans <literal>article</literal> à ceci près
+qu&#8217;il n&#8217;y a pas de chapitre dans cette classe, alors cela ressemble à
+&#8216;<literal>2.3 <replaceable>titre</replaceable></literal>&#8217;.
+</para>
+<para>La forme en <literal>*</literal> affiche <replaceable>titre</replaceable>. Mais elle n&#8217;affiche pas le
+numéro de sous-section, ni n&#8217;incrémente le compteur <literal>subsection</literal>,
+et ne produit aucune entrée dans la table des matières.
+</para>
+<!-- continuer la trad. -->
+<para>L&#8217;argument optionnel <replaceable>tdm-titre</replaceable> apparaît comme le titre de
+sous-section dans la table des matières (see <link linkend="Table-of-contents-etc_002e">Table of contents
+etc.</link>). S&#8217;il n&#8217;est pas présent alors <replaceable>titre</replaceable> est à la place.
+L&#8217;exemple suivant montre le texte complet dans le titre de sous-section,
+</para>
+<screen>\subsection[$\alpha,\beta,\gamma$ paper]{\textit{The Origin of
+ Chemical Elements} by R.A.~Alpher, H.~Bethe, and G.~Gamow}
+</screen>
+<para>mais seulement &#8216;<literal>03B1,03B2,03B3
+paper</literal>&#8217; dans la table des matières.
+</para>
+<para>Pour déterminer quelles rubriques sont numérotées et lesquelles
+apparaissent dans la table des matières, le numéro de niveau d&#8217;une
+sous-section est 2 (see <link linkend="Sectioning_002fsecnumdepth">Sectioning/secnumdepth</link> et
+see <link linkend="Sectioning_002ftocdepth">Sectioning/tocdepth</link>).
+</para>
+<indexterm role="fn"><primary>paquetage <literal>indentfirst</literal></primary></indexterm>
+<indexterm role="fn"><primary><literal>indentfirst</literal>, paquetage</primary></indexterm>
+
+<!-- French version only -->
+<para>Lorsque chargez un paquetage d&#8217;internationalisation tel que
+<filename>babel</filename>, <filename>mlp</filename> ou <filename>polyglossia</filename>, et que la langue
+sélectionnée est le français, alors le premier paragraphe après le titre
+est normalement renfoncé, comme c&#8217;est la convention en typographie
+française. Par contre, si vous restez en langue par défaut,
+c-à-d. en anglo-américain,
+<!-- End French version only -->
+le paragraphe qui suit le titre de sous-section n&#8217;est pas renfoncé, étant donné que c&#8217;est
+<!-- French version only -->
+pour l&#8217;anglo-américain
+<!-- End French version only -->
+une pratique typographique standarde. Pour obtenir un renfoncement
+<!-- French version only -->
+dans ce cas
+<!-- End French version only -->
+utilisez le paquetage <filename>indentfirst</filename>.
+</para>
+<indexterm role="fn"><primary>paquetage <literal>titlesec</literal></primary></indexterm>
+<indexterm role="fn"><primary><literal>titlesec</literal>, paquetage</primary></indexterm>
+
+<!-- -->
+<para>Il y a diverses façon de changer le comportement de la commande
+<literal>\subsection</literal>. L&#8217;une d&#8217;elles et la commande <literal>\@startsection</literal>
+(see <link linkend="_005c_0040startsection">\@startsection</link>). Il y a aussi divers paquetages sur le CTAN
+traitant de cela, dont <filename>titlesec</filename>. Voir sa documentation, mais
+l&#8217;exemple ci-dessous donne un aperçu de ce qu&#8217;il peut faire.
+</para>
+<screen>\usepackage{titlesec} % dans le préambule
+\titleformat{\subsection}[runin]
+ {\normalfont\normalsize\bfseries} % format du titre
+ {\thesubsection} % étiquette
+ {0.6em} % espacement entre l'étiquette et le titre
+ {} % code crochet exécuté avant
+</screen>
+<para>Cela place le numéro de sous-section et <replaceable>titre</replaceable> sur la première
+ligne de texte.
+</para>
+
+</sect1>
+<sect1 label="6.5" id="_005csubsubsection-_0026-_005cparagraph-_0026-_005csubparagraph">
+<title><literal>\subsubsection</literal>, <literal>\paragraph</literal>, <literal>\subparagraph</literal></title>
+
+<indexterm role="fn"><primary>\subsubsection</primary></indexterm>
+<indexterm role="cp"><primary>subsubsection</primary></indexterm>
+<indexterm role="fn"><primary>\paragraph</primary></indexterm>
+<indexterm role="cp"><primary>paragraph</primary></indexterm>
+<indexterm role="fn"><primary>\subparagraph</primary></indexterm>
+<indexterm role="cp"><primary>subparagraph</primary></indexterm>
+
+<para>Synopsis, l&#8217;un parmi les suivant :
+</para>
+<screen>\subsubsection{<replaceable>titre</replaceable>}
+\subsubsection*{<replaceable>titre</replaceable>}
+\subsubsection[<replaceable>titre-tdm</replaceable>]{<replaceable>titre</replaceable>}
+</screen>
+<para>ou l&#8217;un parmi :
+</para>
+<screen>\paragraph{<replaceable>titre</replaceable>}
+\paragraph*{<replaceable>titre</replaceable>}
+\paragraph[<replaceable>titre-tdm</replaceable>]{<replaceable>titre</replaceable>}
+</screen>
+<para>ou l&#8217;un parmi :
+</para>
+<screen>\subparagraph{<replaceable>titre</replaceable>}
+\subparagraph*{<replaceable>titre</replaceable>}
+\subparagraph[<replaceable>titre-tdm</replaceable>]{<replaceable>titre</replaceable>}
+</screen>
+<para>Débute une rubrique de type sous-sous-section, paragraphe, ou
+sous-paragraphe. Les classes &latex; standardes <literal>article</literal>,
+<literal>book</literal>, et <literal>report</literal> disposent toutes de ces commandes, bien
+que leur utilisation n&#8217;est pas courante.
+</para>
+<para>L&#8217;exemple suivant produit une sous-sous-section :
+</para>
+<!-- xxx À traduire -->
+<screen>\subsubsection{Piston ring compressors: structural performance}
+Provide exterior/interior wall cladding assemblies
+capable of withstanding the effects of load and stresses from
+consumer-grade gasoline engine piston rings.
+</screen>
+<para>La sortie produite par défaut de chacune de ces trois commande est la
+même pour les classes &latex; standarde <literal>article</literal>, <literal>book</literal>, et
+<literal>report</literal>. Pour <literal>\subsubsection</literal> le <replaceable>titre</replaceable> est seul sur
+sa ligne, en caractères gras avec la taille normale de police. Pour
+<literal>\paragraph</literal> le <replaceable>titre</replaceable> est sur la même ligne que le texte qui
+suit, sans renfoncement, en caractères gras avec la taille normale de
+police. Pour <literal>\subparagraph</literal> le <replaceable>titre</replaceable> est sur la même ligne
+que la texte qui suit, avec un renfoncement de paragraphe, en caractère
+gras et avec la taille normale de police (comme les documents de classe
+<literal>article</literal> n&#8217;ont pas de chapitre, leurs sous-sous-sections sont
+numérotées et donc cela ressemble à &#8216;<literal>1.2.3 <replaceable>titre</replaceable></literal>&#8217;, pour
+section 1, sous-section 2, et sous-sous-section 3. Les deux autres
+subdivisions ne sont pas numérotées).
+</para>
+<para>La forme en <literal>*</literal> affiche <replaceable>titre</replaceable>. Mais elle n&#8217;incrémente pas le
+compteur associé et ne produit pas d&#8217;entrée dans la table des matières
+(et le titre produit pas <literal>\subsubsection</literal> n&#8217;a pas de numéro).
+</para>
+<para>L&#8217;argument optionnel <replaceable>titre-tdm</replaceable> apparaît comme le titre de la
+rubrique dans la table des matières (see <link linkend="Table-of-contents-etc_002e">Table of contents etc.</link>).
+S&#8217;il est omis, alors <replaceable>titre</replaceable> est utilisé à la place.
+</para>
+<para>Pour déterminer quelles rubriques sont numérotées et lesquelles
+apparaissent dans la table des matières, le numéro de nuveau d&#8217;une
+sous-sous-section est 3, celui d&#8217;un paragraphe est 4, et celui d&#8217;un
+sous-paragraphe est 5 (see <link linkend="Sectioning_002fsecnumdepth">Sectioning/secnumdepth</link> et
+see <link linkend="Sectioning_002ftocdepth">Sectioning/tocdepth</link>).
+</para>
+<indexterm role="fn"><primary>paquetage <literal>indentfirst</literal></primary></indexterm>
+<indexterm role="fn"><primary><literal>indentfirst</literal>, paquetage</primary></indexterm>
+
+<!-- French version only -->
+<para>Lorsque chargez un paquetage d&#8217;internationalisation tel que
+<filename>babel</filename>, <filename>mlp</filename> ou <filename>polyglossia</filename>, et que la langue
+sélectionnée est le français, alors le premier paragraphe après le titre
+est normalement renfoncé, comme c&#8217;est la convention en typographie
+française. Par contre, si vous restez en langue par défaut,
+c-à-d. en anglo-américain,
+<!-- End French version only -->
+le paragraphe qui suit le titre de chapitre n&#8217;est pas renfoncé, étant donné que c&#8217;est
+<!-- French version only -->
+pour l&#8217;anglo-américain
+<!-- End French version only -->
+une pratique typographique standarde. Une façon d&#8217;obtenir un renfoncement
+<!-- French version only -->
+dans ce cas
+<!-- End French version only -->
+est d&#8217;utiliser le paquetage <filename>indentfirst</filename>.
+</para>
+<indexterm role="fn"><primary>paquetage <literal>titlesec</literal></primary></indexterm>
+<indexterm role="fn"><primary><literal>titlesec</literal>, paquetage</primary></indexterm>
+
+<para>Il y a de nombreuses manières de changer le comportement de ces
+commandes. L&#8217;une est la commande <literal>\@startsection</literal>
+(see <link linkend="_005c_0040startsection">\@startsection</link>). Il y a aussi un grand nombre de paquetages
+sur le CTAN traitant de cela, dont <filename>titlesec</filename>. Voir sa
+documentation sur le CTAN.
+</para>
+</sect1>
+
+<sect1 label="6.6" id="_005cappendix">
+<title><literal>\appendix</literal></title>
+
<indexterm role="fn"><primary>\appendix</primary></indexterm>
-<indexterm role="cp"><primary>annexe, création</primary></indexterm>
-<para>La commande <literal>\appendix</literal> modifie la façon dont les unités
-sectionnelles suivantes sont numérotées. La commande <literal>\appendix</literal>
-elle-même ne génère aucun texte et n&#8217;affecte pas la numérotation des
-parties. L&#8217;utilisation normale de cette commande est quelque chose comme
-cela :
-</para>
-<screen>\chapter{Un chapitre}
-&#8230;
+<indexterm role="cp"><primary>appendix</primary></indexterm>
+<indexterm role="cp"><primary>appendices</primary></indexterm>
+
+<para>Synopsis :
+</para>
+<screen>\appendix
+</screen>
+<para>Ne produit pas directement quelque chose en sortie. Mais dans un
+document <literal>book</literal> ou <literal>report</literal> cela déclare que toute commande
+<literal>\chapter</literal> qui suit commence une annexe. Pour les documents
+<literal>article</literal> cela fait la même chose mais avec les commandes
+<literal>\section</literal>. Remet également à zéro les compteurs <literal>chapter</literal> et
+<literal>section</literal> dans un document <literal>book</literal> ou <literal>report</literal>, et dans un
+<literal>article</literal> les compteurs <literal>section</literal> et <literal>subsection</literal>.
+</para>
+<para>Dans ce document de classe <literal>book</literal> :
+</para>
+<screen>\chapter{Un} ...
+\chapter{Deux} ...
+ ...
\appendix
-\chapter{La première annexe }
+\chapter{Trois} ...
+\chapter{Quatre} ...
+</screen>
+<para>les deux premières commandes produisent en sortie &#8216;<literal>Chapitre 1</literal>&#8217; and
+&#8216;<literal>Chapitre 2</literal>&#8217;. Après la commande <literal>\appendix</literal> la numérotation devient
+&#8216;<literal>Annexe A</literal>&#8217; et &#8216;<literal>Annexe B</literal>&#8217;. See <link linkend="Larger-book-template">Larger book template</link>
+pour un autre exemple.
+</para>
+<indexterm role="fn"><primary>paquetage <literal>appendix</literal></primary></indexterm>
+<indexterm role="fn"><primary><literal>appendix</literal>, paquetage</primary></indexterm>
+
+<para>Le paquetage <filename>appendix</filename> ajoute la commande <literal>\appendixpage</literal>
+pour créer une page de titre de partie intitulée &#8216;<literal>Appendices</literal>&#8217; dans
+le corps du document avant la première annexe, ainsi que la
+commande <literal>\addappheadtotoc</literal> pour créer l&#8217;entrée correspondante dans
+la table des matières. On peut régler le nom &#8216;<literal>Appendices</literal>&#8217; avec une
+commande comme <literal>\renewcommand{\appendixname}{Annexes}</literal>, et il y
+a plusieurs autres fonctions. Voir la documentation sur le CTAN.
+</para>
+</sect1>
+<sect1 label="6.7" id="_005cfrontmatter-_0026-_005cmainmatter-_0026-_005cbackmatter">
+<title><literal>\frontmatter</literal>, <literal>\mainmatter</literal>, <literal>\backmatter</literal></title>
+
+<indexterm role="fn"><primary>\frontmatter</primary></indexterm>
+<indexterm role="cp"><primary>book, pièces préliminaires</primary></indexterm>
+<indexterm role="cp"><primary>livre, pièces préliminaires</primary></indexterm>
+<indexterm role="fn"><primary>\mainmatter</primary></indexterm>
+<indexterm role="cp"><primary>book, pièces principales</primary></indexterm>
+<indexterm role="cp"><primary>livre, pièces principales</primary></indexterm>
+<indexterm role="fn"><primary>\backmatter</primary></indexterm>
+<indexterm role="cp"><primary>book, pièces postliminaires</primary></indexterm>
+<indexterm role="cp"><primary>book, annexes</primary></indexterm>
+<indexterm role="cp"><primary>livre, pièces postliminaires</primary></indexterm>
+<indexterm role="cp"><primary>livre, annexes</primary></indexterm>
+
+<para>Synopsis, l&#8217;un parmi :
+</para>
+<screen>\frontmatter
+\mainmatter
+\backmatter
+</screen>
+<para>Formate un document de classe <literal>book</literal> différemment selon la partie
+du document en cours de production. Les trois commandes sont toutes
+optionnelles.
+</para>
+<para>Traditionnellement, les pièces préliminaires (<literal>\frontmatter</literal>) d&#8217;un
+livre comprennent des choses telles que la page de titre, un abrégé, une
+table des matières, une préface, une liste des notations, une liste des
+figures et une liste des tableaux. (Certaines des pages des pièces
+préliminaires, telles que la page de titres, traditionnellement ne sont
+pas numérotée). Les pièces postliminaires (<literal>\backmatter</literal>) peuvent
+contenir des choses telles qu&#8217;un glossaire, une bibliographie, et un
+index.
+</para>
+<para>La déclaration <literal>\frontmatter</literal> rend les numéros de page en chiffres
+romains bas de casse, et rend les chapitres non numérotés, bien que les
+titres de chaque chapitre apparaissent dans la table des matières ; si
+vous utilisez là aussi d&#8217;autres commandes de rubricage, alors utilisez
+la version en <literal>*</literal> (see <link linkend="Sectioning">Sectioning</link>). La commande
+<literal>\mainmatter</literal> permet de revenir au comportement attendu, et
+réinitialise le numéro de page. La commande <literal>\backmatter</literal>
+n&#8217;affecte pas la numérotation des pages, mais commute de nouveau les
+chapitres en mode sans numéros. See <link linkend="Larger-book-template">Larger book template</link> pour un
+exemple d&#8217;usage des trois commandes.
+</para>
+
+</sect1>
+<sect1 label="6.8" id="_005c_0040startsection">
+<title><literal>\@startsection</literal>, composer les rubriques.</title>
+
+<indexterm role="fn"><primary>\@startsection</primary></indexterm>
+<indexterm role="cp"><primary>section, redéfinir</primary></indexterm>
+
+<para>Synopsis :
+</para>
+<screen>\@startsection{<replaceable>nom</replaceable>}{<replaceable>niveau</replaceable>}{<replaceable>retrait</replaceable>}{<replaceable>avant</replaceable>}{<replaceable>après</replaceable>}{<replaceable>style</replaceable>}
</screen>
-<indexterm role="fn"><primary>secnumdepth counter</primary></indexterm>
-<indexterm role="cp"><primary>numéros de rubrique, composition</primary></indexterm>
-<anchor id="Sectioning_002fsecnumdepth"/><para>Le compteur <literal>secnumdepth</literal> contrôle la composition des numéros de
-rubrique. le paramètre
+<para>Utilisé pour aider à redéfinir le comportement des commandes de
+rubricage telles que <literal>\section</literal> ou <literal>\subsection</literal>.
</para>
-<screen>\setcounter{secnumdepth}{<replaceable>niveau</replaceable>}
+<para>Notez que le paquetage <filename>titlesec</filename> rend la manipulation du rubricage
+plus facile. De plus, bien que la plupart des exigences concernant les
+commandes de rubricage peuvent être remplies avec
+<literal>\@startsection</literal>, ce n&#8217;est pas le cas de certaines d&#8217;entre elles. Par exemple,
+dans les classes &latex; standardes <literal>book</literal> et <literal>report</literal>, les
+commandes <literal>\chapter</literal> et <literal>\report</literal> ne sont pas construites de
+cette manière. Pour fabriquer une telle commande, il est possible
+d&#8217;utiliser la commande <literal>\secdef</literal>.
+<!-- xx define, and make a cross reference to, secdef. -->
+</para>
+<para>Techniquement, cette commande a la forme suivante :
+</para><screen>\@startsection{<replaceable>nom</replaceable>}
+ {<replaceable>niveau</replaceable>}
+ {<replaceable>retrait</replaceable>}
+ {<replaceable>avant</replaceable>}
+ {<replaceable>après</replaceable>}
+ {<replaceable>style</replaceable>}*[<replaceable>titretdm</replaceable>]{<replaceable>titre</replaceable>}
+</screen><para>de sorte que faire :
+</para><screen>\renewcommand{\section}{\@startsection{<replaceable>nom</replaceable>}
+ {<replaceable>niveau</replaceable>}
+ {<replaceable>retrait</replaceable>}
+ {<replaceable>avant</replaceable>}
+ {<replaceable>après</replaceable>}
+ {<replaceable>style</replaceable>}}
+</screen><para>redéfinit <literal>\section</literal> en gardant sa forme standarde d&#8217;appel
+<literal>\section*[<replaceable>titretdm</replaceable>]{<replaceable>titre</replaceable>}</literal> (dans laquelle on
+rappelle que l&#8217;étoile <literal>*</literal> est optionnelle).
+See <link linkend="Sectioning">Sectioning</link>. Ceci implique que quand vous écrivez une commande
+comme <literal>\renewcommand{\section}{...}</literal>, le
+<literal>\@startsection{...}</literal> doit venir en dernier dans la définition.
+Voir les exemples ci-dessous.
+</para>
+<variablelist>
+<varlistentry><term><replaceable>nom</replaceable>
+</term><listitem><anchor id="startsection-name"/><anchor id="_005c_0040startsection_002fname"/><para>Nom du compteur utilisé pour numéroter les titres de rubrique. Ce
+compteur doit être défini séparément. Ceux qui sont utilisés le plus
+communément sont <literal>section</literal>, <literal>subsection</literal>, ou
+<literal>paragraph</literal>. Bien que dans ces cas-là le nom du compteur soit
+identique à celui de la commande elle-même, utiliser le même nom n&#8217;est
+pas obligatoire.
+</para>
+<para>Alors <literal>\the</literal><replaceable>name</replaceable> affiche le numéro de titre, et
+<literal>\</literal><replaceable>name</replaceable><literal>mark</literal> sert aux en-têtes de page. Voir le
+troisième exemple plus bas.
+</para>
+</listitem></varlistentry><varlistentry><term><replaceable>niveau</replaceable>
+</term><listitem><anchor id="startsection-level"/><anchor id="_005c_0040startsection_002flevel"/><para>Entier donnant la profondeur de la commande de
+rubricage. See <link linkend="Sectioning">Sectioning</link> pour une liste des numéros standards de
+niveaux.
+</para>
+<para>Si <replaceable>niveau</replaceable> est inférieur ou égal à la valeur du compteur
+<literal>secnumdepth</literal>, alors les titres pour cette commande de rubricage
+sont numérotés (see <link linkend="Sectioning_002fsecnumdepth">Sectioning/secnumdepth</link>). Par exemple : dans un
+<literal>article</literal>, si <literal>secnumdepth</literal> vaut 1, alors une commande
+<literal>\section{Introduction}</literal> produira en sortie une chaîne du type
+« <literal>1 Introduction</literal> », alors que <literal>\subsection{Historique}</literal>
+produira en sortie une chaîne sans numéro de préfixe :
+« <literal>Historique</literal> ».
+</para>
+<para>Si <replaceable>niveau</replaceable> est inférieur ou égal à la valeur du compteur
+<literal>tocdepth</literal>, alors la table des matières aura un article pour cette
+rubrique. Par exemple, dans un <literal>article</literal>, si <literal>tocdepth</literal> vaut
+1, la table des matières listera les <literal>section</literal>s, mais pas les
+<literal>subsection</literal>s.
+</para>
+</listitem></varlistentry><varlistentry><term><replaceable>retrait</replaceable>
+</term><listitem><anchor id="startsection-indent"/><anchor id="_005c_0040startsection_002findent"/>
+<para>Une longueur donnant le renfoncement de toutes les lignes du titre par
+rapport à la marge de gauche. Pour un renfoncement nul, utilisez <literal>0pt</literal>.
+<!-- xx à insérer : -->
+<!-- vous pouvez utiliser la macro @code{\z@@} définie à @code{0pt} pour -->
+<!-- que le code soit plus efficace -->
+Une valeur négative telle que <literal>-1em</literal> cause un débord du titre dans
+la marge de gauche.
+</para>
+</listitem></varlistentry><varlistentry><term><replaceable>avant</replaceable>
+</term><listitem><anchor id="startsection-beforeskip"/><anchor id="_005c_0040startsection_002fbeforeskip"/><para>Longueur dont la valeur absolue est la longueur de l&#8217;espace vertical
+inséré avant le titre de la rubrique. Cet espacement est ignoré si la
+rubrique commence au début d&#8217;une page. Si ce nombre est négatif, alors
+le premier paragraphe suivant le titre n&#8217;est pas renfoncé, s&#8217;il est
+positif ou nul il l&#8217;est. (Notez que l&#8217;opposé de <literal>1pt plus 2pt minus
+3pt</literal> est <literal>-1pt plus -2pt minus -3pt</literal>).
+</para>
+<para>Par exemple si <replaceable>avant</replaceable> vaut <literal>-3.5ex plus -1ex minus -0.2ex</literal>
+alors pour commencer la nouvelle rubrique, &latex; ajoute environ 3,5
+fois la hauteur d&#8217;une lettre x en espace vertical, et le premier
+paragraphe de la rubrique n&#8217;est pas renfoncé. Utiliser une longueur
+élastique, c.-à-d. comprenant <literal>plus</literal> et <literal>minus</literal>, est une
+bonne pratique ici car cela donne à &latex; plus de latitude lors de la
+fabrication de la page (see <link linkend="Lengths">Lengths</link>).
+</para>
+<para>La quantité totale d&#8217;espace vertical entre la ligne de base de la ligne
+précédant cette rubrique et la ligne de base du titre de la rubrique est
+la somme du <literal>\parskip</literal> dans la police du corps de texte, du
+<literal>\baselineskip</literal> de la police du titre, et de la valeur absolue de
+l&#8217;argument <replaceable>avant</replaceable>. Cet espace est typiquement élastique de sorte à
+pouvoir se dilater ou se contracter. (Si la rubrique commence en début
+d&#8217;une page de sorte que cet espace soit ignoré, alors la ligne de base
+du titre correspond à la ligne de base qu&#8217;aurait la première ligne de
+texte sur cette page si celle-ci commençait par du texte).
+</para>
+</listitem></varlistentry><varlistentry><term><replaceable>après</replaceable>
+</term><listitem><anchor id="startsection-afterskip"/><anchor id="_005c_0040startsection_002fafterskip"/><para>Longueur. Lorsque <replaceable>après</replaceable> est positif ou nul, il s&#8217;agit de l&#8217;espace
+vertical à insérer après le titre de la rubrique. Lorsque elle est
+négative, alors le titre fait corps avec le paragraphe le suivant
+immédiatement. Dans ce cas la valeur absolue de la longueur donne
+l&#8217;espace horizontal entre la fin du titre et le début du paragraphe
+suivant. (Notez que l&#8217;opposé de <literal>1pt plus 2pt minus 3pt</literal> est
+<literal>-1pt plus -2pt minus -3pt</literal>).
+</para>
+<para>Comme c&#8217;est le cas avec <replaceable>avant</replaceable>, utiliser une longueur élastique
+avec des composantes <literal>plus</literal> et <literal>minus</literal> est une bonne pratique
+ici puisque elle donne à &latex; plus de latitude pour assembler la
+page.
+</para>
+<para>Si <replaceable>après</replaceable> est positif ou nul, la quantité totale d&#8217;espace vertical
+entre la ligne de base du titre de la rubrique et la ligne de base de la
+première ligne du paragraphe suivant est la somme du <literal>\parskip</literal> de
+la police du titre, de <literal>\baselineskip</literal> de la police du corps de
+texte, et de la valeur de <replaceable>après</replaceable>. Cet espace est typiquement
+élastique de sorte qu&#8217;il puisse se dilater ou se contracter. (Notez que,
+du fait que le signe d&#8217;<replaceable>après</replaceable> contrôle que le titre soit
+indépendant du texte qui le suit ou faisant corps avec lui, vous ne
+pouvez pas utiliser un <replaceable>après</replaceable> négatif pour annuler une partie du
+<literal>\parskip</literal>).
+</para>
+</listitem></varlistentry><varlistentry><term><replaceable>style</replaceable>
+</term><listitem><anchor id="startsection-style"/><anchor id="_005c_0040startsection_002fstyle"/><para>Contrôle le style du titre : voir les exemples plus bas. Les commandes
+typiquement utilisées ici sont <literal>\centering</literal>, <literal>\raggedright</literal>,
+<literal>\normalfont</literal>, <literal>\hrule</literal>, ou <literal>\newpage</literal>. La dernière
+commande au sein de <replaceable>style</replaceable> peut être une commande prenant un
+argument, telle que <literal>\MakeUppercase</literal> ou <literal>\fbox</literal>. Le titre de
+la rubrique est passé en argument à cette commande. Par exemple régler
+<replaceable>style</replaceable> à <literal>\bfseries\MakeUppercase</literal> a pour effet de produire
+des titres gras et en capitales.
+</para></listitem></varlistentry></variablelist>
+<para>Voici les réglages par défaut de &latex; pour les trois premiers
+niveaux de rubricage qui sont définis par <literal>\@startsection</literal>, pour
+les classes <filename>article</filename>, <filename>book</filename>, et <filename>report</filename>.
+</para><itemizedlist><listitem><para>Pour section, le <replaceable>niveau</replaceable> vaut 1, le <replaceable>retrait</replaceable> vaut 0pt,
+le <replaceable>avant</replaceable> vaut <literal>-3.5ex plus -1ex minus -0.2ex</literal>, le <replaceable>après</replaceable>
+vaut <literal>2.3ex plus 0.2ex</literal>, et le <replaceable>style</replaceable> vaut
+<literal>\normalfont\Large\bfseries</literal>.
+</para></listitem><listitem><para>Pour subsection, le <replaceable>niveau</replaceable>
+vaut 2, le <replaceable>retrait</replaceable> vaut 0pt, le <replaceable>avant</replaceable> vaut
+<literal>-3.25ex plus -1ex minus -0.2ex</literal>, le <replaceable>après</replaceable> vaut <literal>1.5ex
+plus 0.2ex</literal>, et le <replaceable>style</replaceable> vaut <literal>\normalfont\large\bfseries</literal>.
+</para></listitem><listitem><para>Pour subsubsection, le <replaceable>niveau</replaceable> vaut 3, le <replaceable>retrait</replaceable> vaut
+0pt, le <replaceable>avant</replaceable> vaut <literal>-3.25ex plus -1ex minus -0.2ex</literal>, le
+<replaceable>après</replaceable> vaut <literal>1.5ex plus 0.2ex</literal>, et le <replaceable>style</replaceable> vaut
+<literal>\normalfont\normalsize\bfseries</literal>.
+</para></listitem></itemizedlist>
+
+<para>Voici des exemples. Pour les utiliser, mettez-les soit au sein d&#8217;un
+fichier de paquetage ou de classe, soit dans le préambule d&#8217;un document
+&latex;. Si vous les mettez dans le préambule, elle doivent être entre
+une commande <literal>\makeatletter</literal> et une commande <literal>\makeatother</literal>.
+(Le message d&#8217;erreur <literal>You can't use `\spacefactor' in vertical
+mode.</literal> est le plus probable lorsque on oublie de faire
+cela). See <link linkend="_005cmakeatletter-_0026-_005cmakeatother">\makeatletter &amp; \makeatother</link>.
+</para>
+<para>L&#8217;exemple ci-dessous centre les titres de section et les met en gros
+caractères gras. Il le fait avec <literal>\renewcommand</literal> parce que les
+classes standardes de &latex; ont déjà une commande <literal>\section</literal> de
+définie. Pour la même raison il ne définit ni un compteur
+<literal>section</literal>, ni les commandes <literal>\thesection</literal> et
+<literal>\l@section</literal>.
+</para>
+<screen>\renewcommand\section{%
+ \@startsection{section}% <link linkend="_005c_0040startsection_002fname"><replaceable>nom</replaceable></link>.
+ {1}% <link linkend="_005c_0040startsection_002flevel"><replaceable>niveau</replaceable></link>.
+ {0pt}% <link linkend="_005c_0040startsection_002findent"><replaceable>retrait</replaceable></link>.
+ {-3.5ex plus -1ex minus -.2ex}% <link linkend="_005c_0040startsection_002fbeforeskip"><replaceable>avant</replaceable></link>.
+ {2.3ex plus.2ex}% <link linkend="_005c_0040startsection_002fafterskip"><replaceable>après</replaceable></link>.
+ {\centering\normalfont\Large\bfseries}}% <link linkend="_005c_0040startsection_002fstyle"><replaceable>style</replaceable></link>.
</screen>
-<para>supprime le numéros de rubrique à n&#8217;importe quelle profondeur <inlineequation><mathphrase>&gt; <replaceable>niveau</replaceable></mathphrase></inlineequation>, où
-<literal>chapter</literal> est le niveau zéro. (Voir <link linkend="_005csetcounter">\setcounter</link>.)
+
+<para>L&#8217;exemple ci-dessous met les titres de <literal>subsection</literal> en petites
+capitales, et leur fait faire corps avec le paragraphe suivant.
+</para>
+<screen>\renewcommand\subsection{%
+ \@startsection{subsection}% <link linkend="_005c_0040startsection_002fname"><replaceable>nom</replaceable></link>.
+ {2}% <link linkend="_005c_0040startsection_002flevel"><replaceable>niveau</replaceable></link>.
+ {0em}% <link linkend="_005c_0040startsection_002findent"><replaceable>retrait</replaceable></link>.
+ {-1ex plus 0.1ex minus -0.05ex}% <link linkend="_005c_0040startsection_002fbeforeskip"><replaceable>avant</replaceable></link>.
+ {-1em plus 0.2em}% <link linkend="_005c_0040startsection_002fafterskip"><replaceable>après</replaceable></link>.
+ {\scshape}% <link linkend="_005c_0040startsection_002fstyle"><replaceable>style</replaceable></link>.
+ }
+</screen>
+
+<para>Les exemples précédents redéfinissaient les commandes de titre de
+rubriques existantes. L&#8217;exemple suivant définit une nouvelle commande,
+illustrant la nécessité d&#8217;un compteur et de macros pour son affichage.
</para>
+<!-- From https://groups.google.com/forum/#!searchin/comp.text.tex/startsection%7Csort:relevance/comp.text.tex/sB-nTS-oL08/ZZeKYdG0llMJ -->
+<screen>\setcounter{secnumdepth}{6}% affiche les compteurs justqu'à ce niveau
+\newcounter{subsubparagraph}[subparagraph]% compteur pour la
+ % numérotation
+\renewcommand{\thesubsubparagraph}%
+ {\thesubparagraph.\@arabic\c@subsubparagraph}% comment afficher
+ % la numérotation
+\newcommand{\subsubparagraph}{\@startsection
+ {subsubparagraph}%
+ {6}%
+ {0em}%
+ {\baselineskip}%
+ {0.5\baselineskip}%
+ {\normalfont\normalsize}}
+\newcommand*\l@subsubparagraph%
+ {\@dottedtocline{6}{10em}{5em}}% pour la table des matières
+\newcommand{\subsubparagraphmark}[1]{}% pour les en-têtes de page
+</screen>
+</sect1>
</chapter>
<chapter label="7" id="Cross-references">
-<title>Des références croisées</title>
-<indexterm role="cp"><primary>références croisées</primary></indexterm>
+<title>Des renvois</title>
+<indexterm role="cp"><primary>renvois</primary></indexterm>
<para>Une des raisons pour numéroter des choses telles que les figures ou les
équations est d&#8217;indiquer au lecteur une référence vers elles, comme dans « Voir la
figure 3 pour plus de détails. »
</para>
<indexterm role="cp"><primary>étiquette</primary></indexterm>
-<para>Inclure le numéro de figure dans le code source est une mauvaise
-pratique puisque ce si ce noméro change avec l&#8217;évolution du document,
-alors on doit penser à mettre à jour cet référence manuellement. Au lieu
-de cela, &latex; vous fait écrire une <firstterm>étiquette</firstterm> du genre
-<literal>\label{eq:ThmGreens}</literal> et lui faire référence avec <literal>Voir
-l'équation~\ref{eq:ThmGreens}</literal>.
-</para>
-<para>&latex; écrit l&#8217;information provenant des étiquettes dans un fichier
-avec le même nom que le fichier conteant le <literal>\label{...}</literal> mais
-avec une extension <filename>.aux</filename>. (L&#8217;information a le format
-<literal>\newlabel{<replaceable>étiquette</replaceable>}{{<replaceable>étiquette-courante</replaceable>}{<replaceable>numéro-de-page</replaceable>}}</literal>
-où <replaceable>étiquette-courante</replaceable> est la valeur de la macro
-<literal>\@currentlabel</literal> qui est d&#8217;ordinaire mise à jour à chaque vous que
-that is vous appelez <literal>\refstepcounter{<replaceable>compteur</replaceable>}</literal>.)
+<para>Souvent on désire écrire quelque chose du genre de &#8216;<literal>Voir
+théorème~31</literal>&#8217;. Mais Inclure manuellement le numéro est une mauvaise
+pratique. Au lieu de cela, il vaut mieux écrire une <firstterm>étiquette</firstterm> du
+genre <literal>\label{eq:ThmGreens}</literal> puis lui <firstterm>faire référence</firstterm> avec
+<literal>Voir l'équation~\ref{eq:ThmGreens}</literal>. &latex; se charge de
+déterminer automatiquement le numéro, de le produire en sortie, et de le
+changer par la suite si besoin est.
+</para>
+<screen>Cela apparaîtra avec le théorème~\ref{th:ThmGreens}. % référence déclarée en aval
+...
+\begin{theorem} \label{th:ThmGreens}
+ ...
+\end{theorem}
+...
+Voir le théorème~\ref{th:ThmGreens} page~\pageref{th:ThmGreens}.
+</screen>
+
+<para>&latex; garde trace de l&#8217;information de renvoi dans un
+fichier avec le même nom de base que le fichier contenant le
+<literal>\label{...}</literal> mais avec une extension <filename>.aux</filename>. Ainsi si
+<literal>\label</literal> est dans <filename>calcul.tex</filename> alors cette information est
+dans <filename>calcul.aux</filename>. &latex; met cette information dans ce fichier à
+chaque fois qu&#8217;il rencontre un <literal>\label</literal>.
</para>
+
<indexterm role="cp"><primary>référence déclarée en aval</primary></indexterm>
<indexterm role="cp"><primary>aval, référence déclarée en</primary></indexterm>
<indexterm role="cp"><primary>déclaration en aval de référence</primary></indexterm>
<para>L&#8217;effet secondaire le plus courant du paragraphe précédent se produit
lorsque votre document a une <firstterm>référence déclarée en aval</firstterm>, c.-à-d.
-un <literal>\ref{<replaceable>clef</replaceable>}</literal> qui apparaît avant le
-<literal>\label{<replaceable>clef</replaceable>}</literal> associé ; voir l&#8217;exemple dans la description
-de <literal>\pageref{...}</literal>. &latex; obtient les référence à partir du
-fichier <filename>.aux</filename>. Si c&#8217;est la première fois que vous compilez le
-document alors vous obtiendrez un message <literal>LaTeX Warning: Label(s)
-may have changed. Rerun to get cross references right.</literal> et dans la
-sortie la référence apparaîtra comme deux points
-d&#8217;interrogration &#8216;<literal>??</literal>&#8217; en caractères gras. Ou, si vous modifiez le
-document de telle façon que les références changent alors vous
-obtiendrez le même avertissement et la sortie contiendra l&#8217;information
-de référence de la fois précédente. La solution dans les deux cas est
-juste de re-compiler le document encore une fois.
+un <literal>\ref</literal> qui apparaît avant le <literal>\label</literal> associé. Si c&#8217;est la
+première fois que vous compilez le document alors vous obtiendrez un
+message <literal>LaTeX Warning: Label(s) may have changed. Rerun to get
+cross references right.</literal> et dans la sortie la référence apparaîtra comme
+deux points d&#8217;interrogration &#8216;<literal>??</literal>&#8217; en caractères gras. Ou, si vous
+modifiez le document de telle façon que les références changent alors
+vous obtiendrez le même avertissement et la sortie contiendra
+l&#8217;information de référence de la fois précédente. La solution dans les
+deux cas est juste de re-compiler le document encore une fois.
</para>
+<indexterm role="fn"><primary>paquetage <literal>cleveref</literal></primary></indexterm>
+<indexterm role="fn"><primary><literal>cleveref</literal>, paquetage</primary></indexterm>
+
+
+<para>Le paquetage <literal>cleveref</literal> élargit les possibilités de faire des
+renvois de &latex;. Vous pouvez faire en sorte que si vous saisissez
+<literal>\begin{thm}\label{th:Nerode}...\end{thm}</literal> alors
+<literal>\cref{th:Nerode}</literal> produit en sortie &#8216;<literal>théorème 3.21</literal>&#8217;, sans
+que vous ayez à saisir le mot « théorème ».
+</para>
+
<sect1 label="7.1" id="_005clabel">
@@ -2465,7 +3313,7 @@ de la rubrique courante. Au sein d&#8217;un environnement numéroté, tel que
l&#8217;environnement <literal>table</literal> ou <literal>theorem</literal>,
<literal>\label{<replaceable>clef</replaceable>}</literal> attribue le numéro de cet environnement à
<replaceable>clef</replaceable>. On retire le numéro attribué avec la commande
-<literal>\ref{<replaceable>clef</replaceable>}</literal> (voir <link linkend="_005cref">\ref</link>).
+<literal>\ref{<replaceable>clef</replaceable>}</literal> (see <link linkend="_005cref">\ref</link>).
</para>
<para>Le nom <replaceable>clef</replaceable> peut se composer de n&#8217;importe quelle séquence de
lettres, chiffres, ou caractères de ponctuation ordinaires. Il est
@@ -2510,8 +3358,8 @@ Voir Figure~\ref{fig:test}.
<sect1 label="7.2" id="_005cpageref">
<title><literal>\pageref{<replaceable>clef</replaceable>}</literal></title>
<indexterm role="fn"><primary>\pageref</primary></indexterm>
-<indexterm role="cp"><primary>référence croisée avec numéro de page</primary></indexterm>
-<indexterm role="cp"><primary>numéro de page, référence croisée</primary></indexterm>
+<indexterm role="cp"><primary>renvoi avec numéro de page</primary></indexterm>
+<indexterm role="cp"><primary>numéro de page, renvoi</primary></indexterm>
<para>Synopsis :
</para>
@@ -2536,18 +3384,18 @@ page~\pageref{eq:principale}.
<sect1 label="7.3" id="_005cref">
<title><literal>\ref{<replaceable>clef</replaceable>}</literal></title>
<indexterm role="fn"><primary>\ref</primary></indexterm>
-<indexterm role="cp"><primary>référence croisée, symbolique</primary></indexterm>
-<indexterm role="cp"><primary>numéro de rubrique, référence croisée</primary></indexterm>
-<indexterm role="cp"><primary>numéro d&#8217;équation, référence croisée</primary></indexterm>
-<indexterm role="cp"><primary>numéro de figure, référence croisée</primary></indexterm>
-<indexterm role="cp"><primary>numéro de note en bas de page, référence croisée</primary></indexterm>
+<indexterm role="cp"><primary>renvoi, symbolique</primary></indexterm>
+<indexterm role="cp"><primary>numéro de rubrique, renvoi</primary></indexterm>
+<indexterm role="cp"><primary>numéro d&#8217;équation, renvoi</primary></indexterm>
+<indexterm role="cp"><primary>numéro de figure, renvoi</primary></indexterm>
+<indexterm role="cp"><primary>numéro de note en bas de page, renvoi</primary></indexterm>
<para>Synopsis :
</para>
<screen>\ref{<replaceable>clef</replaceable>}
</screen>
<para>Produit le numéro de la rubrique, équation, note en bas de page, figure,
-&#8230;, de la commande correspondante <literal>\label</literal> (voir <link linkend="_005clabel">\label</link>).
+&#8230;, de la commande correspondante <literal>\label</literal> (see <link linkend="_005clabel">\label</link>).
Elle ne produit aucun texte, tel que le mot &#8216;<literal>Section</literal>&#8217; ou
&#8216;<literal>Figure</literal>&#8217;, juste le numéro lui-même sans plus.
</para>
@@ -2572,7 +3420,7 @@ que ceci est une référence déclarée en aval puisque elle est faite avant
<indexterm role="fn"><primary>\begin</primary></indexterm>
<indexterm role="fn"><primary>\end</primary></indexterm>
-<para>&latex; fournit beacoup d&#8217;environnements pour baliser un certain texte.
+<para>&latex; fournit beaucoup d&#8217;environnements pour baliser un certain texte.
Chaque environnement commence et se termine de la même manière :
</para>
<screen>\begin{<replaceable>nomenv</replaceable>}
@@ -2586,6 +3434,7 @@ Chaque environnement commence et se termine de la même manière :
<indexterm role="fn"><primary>environnement <literal>abstract</literal></primary></indexterm>
<indexterm role="fn"><primary><literal>abstract</literal>, environnement</primary></indexterm>
+
<indexterm role="cp"><primary>résumé</primary></indexterm>
<para>Synopsis :
@@ -2595,12 +3444,12 @@ Chaque environnement commence et se termine de la même manière :
</screen>
<para>Produit un résumé, potentiellement contenant plusieurs paragraphes. Cet
environnement n&#8217;est défini que dans les classes de document
-<literal>article</literal> et <literal>report</literal> (voir <link linkend="Document-classes">Document classes</link>).
+<literal>article</literal> et <literal>report</literal> (see <link linkend="Document-classes">Document classes</link>).
</para>
<para>Utiliser l&#8217;exemple ci-dessous au sein de la classe <literal>article</literal>
produit un paragraphe détaché. L&#8217;option <literal>titlepage</literal> de la classe de
document a pour effet que le résumé soit sur une page séparée
-(voir <link linkend="Document-class-options">Document class options</link>) ; ceci est le comportement par défaut
+(see <link linkend="Document-class-options">Document class options</link>) ; ceci est le comportement par défaut
selement dans la classe <literal>report</literal>.
</para>
<screen>\begin{abstract}
@@ -2641,6 +3490,7 @@ en deux-colonne (pour plus solution plus flexible, utilisez le paquetage
<title><literal>array</literal></title>
<indexterm role="fn"><primary>environnement <literal>array</literal></primary></indexterm>
<indexterm role="fn"><primary><literal>array</literal>, environnement</primary></indexterm>
+
<indexterm role="cp"><primary>tableaux mathématiques</primary></indexterm>
<para>Synopsis :
@@ -2659,9 +3509,9 @@ en deux-colonne (pour plus solution plus flexible, utilisez le paquetage
</screen>
<para>Les tableaux mathématiques sont produits avec l&#8217;environnement
<literal>array</literal>, normalement au sein d&#8217;un environnement <literal>equation</literal>
-(voir <link linkend="equation">equation</link>). Les entrées dans chaque colonne sont séparées avec
+(see <link linkend="equation">equation</link>). Les entrées dans chaque colonne sont séparées avec
une esperluette (<literal>&amp;</literal>). Les lignes sont terminées par une double
-contr&#8217;oblique (voir <link linkend="_005c_005c">\\</link>).
+contr&#8217;oblique (see <link linkend="_005c_005c">\\</link>).
</para>
<para>L&#8217;argument obligatoire <replaceable>patron</replaceable> décrit le nombre de colonnes,
l&#8217;alignement en leur sein, et le formatage des régions
@@ -2684,6 +3534,7 @@ colonnes. La valeur par défaut est &#8216;<literal>5pt</literal>&#8217;.
</para>
<indexterm role="fn"><primary>paquetage <literal>amsmath</literal></primary></indexterm>
<indexterm role="fn"><primary><literal>amsmath</literal>, paquetage</primary></indexterm>
+
<para>Pour otenir des tableaux entre accolades la méthode standarde est
d&#8217;utiliser le paquetage <literal>amsmath</literal>. Il comprend les environnements
<literal>pmatrix</literal> pour un tableau entre parenthèses <literal>(...)</literal>,
@@ -2760,6 +3611,7 @@ preambule :
<indexterm role="fn"><primary>environnement <literal>center</literal></primary></indexterm>
<indexterm role="fn"><primary><literal>center</literal>, environnement</primary></indexterm>
+
<indexterm role="cp"><primary>centrer du texte, environnement pour</primary></indexterm>
<para>Synopsis :
@@ -2813,44 +3665,71 @@ second line \\
<indexterm role="fn"><primary>environnement <literal>description</literal></primary></indexterm>
<indexterm role="fn"><primary><literal>description</literal>, environnement</primary></indexterm>
+
<indexterm role="cp"><primary>lists étiquetée, créer</primary></indexterm>
<indexterm role="cp"><primary>listes de description, créer</primary></indexterm>
<para>Synopsis :
</para>
<screen>\begin{description}
-\item [<replaceable>étiquette1</replaceable>] <replaceable>article1</replaceable>
-\item [<replaceable>étiquette2</replaceable>] <replaceable>article2</replaceable>
+\item [<replaceable>étiquette du 1er article</replaceable>] <replaceable>texte du 1er article</replaceable>
+\item [<replaceable>étiquette du 2e article</replaceable>] <replaceable>texte du 2e article</replaceable>
...
\end{description}
</screen>
<indexterm role="fn"><primary>\item</primary></indexterm>
<para>L&#8217;environnement <literal>description</literal> est utilisé pour fabriquer des listes
d&#8217;articles étiquetés. Chaque <replaceable>étiquette</replaceable> d&#8217;article est composée en
-gras, alignée à gauche. Bien que les étiquettes sur les articles sont
-optionnelles il n&#8217;y a pas de valeur par défaut sensée, c&#8217;est pourquoi
-tous les articles devraient avoir une étiquette.
+gras, alignée à gauche de sorte que les étiquettes longues continuent
+sur la première lgne du texte de l&#8217;article. Il doit y avoir au moins un
+article ; sans cela provoque l&#8217;erreur &latex; &#8216;<literal>Something's
+wrong--perhaps a missing \item</literal>&#8217;.
+</para>
+<para>Cet exemple montre l&#8217;environnement utilisé pour une séquence de
+définitions. Les étiquettes &#8216;<literal>lama</literal>&#8217; et &#8216;<literal>llama</literal>&#8217; ressortent en
+gras avec leur bords gauches alignés sur la marge de gauche.
</para>
+<screen>\begin{definition}
+ \item[lama] Un prêtre.
+ \item[lame] Une pièce coupante.
+</screen>
<indexterm role="fn"><primary>\item</primary></indexterm>
-<para>La liste consiste en au moins un article ; voir <link linkend="_005citem">\item</link> (l&#8217;absence
-d&#8217;article cause l&#8217;erreur &latex; &#8216;<literal>Something's wrong--perhaps a
-missing \item</literal>&#8217;). Chaque article est produit avec une commande
-<literal>\item</literal>.
+<para>Faites démarrer la liste d&#8217;articles avec la commande <literal>\item</literal>
+(see <link linkend="_005citem">\item</link>). Utilisez l&#8217;étiquette optionnelle, comme dans
+<literal>\item[Point principal]</literal>, en effet il n&#8217;y a pas de valeur par
+défaut sensée. Après le <literal>\item</literal> se trouve du texte optionnel
+pouvant contenir plusieurs paragraphes.
</para>
-<!-- où ça va ?=> Le texte @var{article} peut contenir plusieurs paragraphes. -->
-
+<indexterm role="cp"><primary>gras machine à écrire, éviter</primary></indexterm>
<indexterm role="cp"><primary>gras tapuscrit, éviter</primary></indexterm>
+<indexterm role="cp"><primary>étiquette machine à écrire dans les listes</primary></indexterm>
<indexterm role="cp"><primary>étiquette tapuscrite dans les listes</primary></indexterm>
-<para>Une autre variation : puisque le style gras est appliqué aux étiquettes,
-si vous composez une étiquette en style tapuscrit avec <literal>\texttt</literal>,
-vous obtiendrez du gras tapuscrit : <literal>\item[\texttt{gras et
-tapuscrit}]</literal>. C&#8217;est peut-être trop gras, entre autres problèmes. Pour
-obtenir juste le style tapuscrit, utilisez <literal>\tt</literal>, ce qui
-reinitialise toutes les autres variations de style : <literal>\item[{\tt
-tapuscrit de base}]</literal>.
+<para>Comme les étiquettes sont en gras, si le texte de l&#8217;étiquette appelle un
+changement de police effectué dans la forme à argument (voir <link linkend="Font-styles">styles des polices</link>) alors il ressortira en gras. Par exemple,
+si le texte de l&#8217;étiquette est en police machine à écrire comme dans
+<literal>\item[\texttt{texte étiquette}]</literal> alors il apparaîtra en
+tapuscrit gras, si cela est disponible. La méthode la plus simple pour
+obtenir la police tapuscrit non grasse est d&#8217;utiliser la forme
+déclarative : <literal>\item[{\tt texte étiquette}]</literal>. De la même façon,
+obtenez la police romaine standarde avec <literal>\item[{\rm texte
+étiquette}]</literal>.
+</para>
+<para>En ce qui concerne les autres principaux environnements de liste à
+étiquettes de &latex;, voir <link linkend="itemize">itemize</link> et <link linkend="enumerate">enumerate</link>.
+Contrairement à ces environnements, imbriquer les environnement
+<literal>description</literal> ne change pas l&#8217;étiquette par défaut ; elle est en
+gras et alignée à gauche à tous les niveaux.
</para>
-<para>Pour les détails concernant l&#8217;espacement des listes, voir <link linkend="itemize">itemize</link>.
+<para>Pour plus d&#8217;information sur les paramètres de disposition de liste, y
+compris les valeurs par défaut, et sur la personnalisation de la
+disposition de liste, voir <link linkend="list">list</link>. Le paquetage <filename>enumitem</filename> est
+utile pour personnaliser les listes.
</para>
+<para>Cet exemple met les étiquettes de description en petites capitales.
+</para>
+<screen>\renewcommand{\descriptionlabel}[1]{%
+ {\hspace{\labelsep}\textsc{#1}}}
+</screen>
</sect1>
<sect1 label="8.5" id="displaymath">
@@ -2860,6 +3739,7 @@ tapuscrit de base}]</literal>.
<indexterm role="fn"><primary>environnement <literal>displaymath</literal></primary></indexterm>
<indexterm role="fn"><primary><literal>displaymath</literal>, environnement</primary></indexterm>
+
<para>Synopsis :
</para>
<screen>\begin{displaymath}
@@ -2873,29 +3753,35 @@ justifie les équations à gauche ; voir <link linkend="Document-class-options"
</para>
<para>Aucun numéro d&#8217;équation n&#8217;est ajouté au texte de texte
<literal>displaymath</literal> ; pour obtenir un numéro d&#8217;équation, vous pouvez
-utiliser l&#8217;environnement <literal>equation</literal> (voir <link linkend="equation">equation</link>).
+utiliser l&#8217;environnement <literal>equation</literal> (see <link linkend="equation">equation</link>).
</para>
<para>&latex; ne fait pas de saut de ligne au sein de <replaceable>des maths</replaceable>.
</para>
<indexterm role="fn"><primary>paquetage <literal>amsmath</literal></primary></indexterm>
<indexterm role="fn"><primary><literal>amsmath</literal>, paquetage</primary></indexterm>
+
<para>Notez que le paquetage <filename>amsmath</filename> comprend des possibilités beaucoup
plus vastes en matière d&#8217;affichage d&#8217;équations. Par exemple, il offre
plusieurs altenatives pour effectuer des sauts de lignes au sein de
texte en mode mathématique.
</para>
-<para>La construction <literal>\[<replaceable>des maths</replaceable>\]</literal> est essentiellement un
-synonyme de <literal>\begin{displaymath}<replaceable>des
+<indexterm role="fn"><primary>\[...\] displaymath</primary></indexterm>
+<para>La construction <literal>\[<replaceable>des maths</replaceable>\]</literal> est un synonyme de
+l&#8217;environnement <literal>\begin{displaymath}<replaceable>des
maths</replaceable>\end{displaymath}</literal>, mais ce dernier est plus pratique à
-manipuler dans le code source ; par exemple la recherche d&#8217;un caractère
-crochet <literal>]</literal> peut donner des faux positifs, alors qu&#8217;il est plus
-probable que le mot <literal>displaymath</literal> soit unique. (La construction
-<literal>$$<replaceable>des maths</replaceable>$$</literal> tirée du language &tex; de base est souvent
-utilisée à tort comme un synonyme de <literal>displaymath</literal>. Ce n&#8217;en est
-pas un, parce que l&#8217;environnement <literal>displaymath</literal> vérifie qu&#8217;il ne
-commence pas en mode mathérmatique, parce qu&#8217;il gère l&#8217;espacement
-verticial environment différemment, et parce qu&#8217;il honore l&#8217;option
-<literal>fleqn</literal>.)
+manipuler dans le fichier source ; par exemple la recherche d&#8217;un
+caractère crochet <literal>]</literal> peut donner des faux positifs, alors qu&#8217;il
+est plus probable que le mot <literal>displaymath</literal> soit unique.
+</para>
+
+<indexterm role="fn"><primary>$$...$$ displaymath, forme approchée en &tex; de base</primary></indexterm>
+<para>(Digression : la construction <literal>$$<replaceable>des maths</replaceable>$$</literal> tirée du
+language &tex; de base est souvent utilisée à tort comme un synonyme
+de <literal>displaymath</literal>. Elle n&#8217;en est pas un, et n&#8217;est pas du tout
+officiellement prise en charge par &latex; ; <literal>$$</literal> ne prend pas en
+charge <literal>fleqn</literal> (see <link linkend="Document-class-options">Document class options</link>), gère l&#8217;espacement
+verticial environment différemment, et n&#8217;effectue pas de vérification de
+cohérence).
</para>
<para>Le texte composé par cet exemple est centré et seul sur sa ligne.
</para><screen>\begin{displaymath}
@@ -2911,8 +3797,9 @@ ligne <literal>\( \int_1^2 x^2\,dx=7/3 \)</literal> produit.
<indexterm role="fn"><primary>environnement <literal>document</literal></primary></indexterm>
<indexterm role="fn"><primary><literal>document</literal>, environnement</primary></indexterm>
+
<para>L&#8217;environnement <literal>document</literal> entoure le corps entier d&#8217;un document.
-Il est obligatoire dans tout document &latex;. Voir <link linkend="Starting-and-ending">Starting and
+Il est obligatoire dans tout document &latex;. See <link linkend="Starting-and-ending">Starting and
ending</link>.
</para>
@@ -2961,6 +3848,7 @@ successives sont exécutée dans l&#8217;ordre de passage à la commande.
<indexterm role="fn"><primary>environnement <literal>enumerate</literal></primary></indexterm>
<indexterm role="fn"><primary><literal>enumerate</literal>, environnement</primary></indexterm>
+
<indexterm role="cp"><primary>lists of items, numbered</primary></indexterm>
<para>Synopsis :
@@ -2991,8 +3879,8 @@ marathon olympique de 1908 :
<para>Les énumerations peuvent être imbriquées les unes dans les autres,
jusqu&#8217;à une profondeur de quatre niveaux. Elles peuvent aussi être
imbriquées au sein d&#8217;autres environnements fabriquant des paragraphes,
-tels que <literal>itemize</literal> (voir <link linkend="itemize">itemize</link>) et <literal>description</literal>
-(voir <link linkend="description">description</link>).
+tels que <literal>itemize</literal> (see <link linkend="itemize">itemize</link>) et <literal>description</literal>
+(see <link linkend="description">description</link>).
Le format de l&#8217;étiquette produite dépend du niveau d&#8217;imbrication de la
liste. Voici les valeurs par défaut de &latex; pour le format à chaque
niveau d&#8217;imbrication (où 1 est le niveau le plus externe) :
@@ -3008,9 +3896,9 @@ niveau d&#8217;imbrication (où 1 est le niveau le plus externe) :
<indexterm role="fn"><primary>\enumiii</primary></indexterm>
<indexterm role="fn"><primary>\enumiv</primary></indexterm>
<para>L&#8217;environnement <literal>enumerate</literal> utilise les compteurs <literal>\enumi</literal>,
-&#8230;, <literal>\enumiv</literal> (voir <link linkend="Counters">Counters</link>). Si vous utilisez l&#8217;argument
+&#8230;, <literal>\enumiv</literal> (see <link linkend="Counters">Counters</link>). Si vous utilisez l&#8217;argument
optionnel d&#8217;<literal>\item</literal> alors le compteur n&#8217;est pas incrementé pour cet
-article (voir <link linkend="_005citem">\item</link>).
+article (see <link linkend="_005citem">\item</link>).
</para>
<indexterm role="fn"><primary>\labelenumi</primary></indexterm>
<indexterm role="fn"><primary>\labelenumii</primary></indexterm>
@@ -3019,7 +3907,7 @@ article (voir <link linkend="_005citem">\item</link>).
<para>L&#8217;environnement <literal>enumerate</literal> utilise les commandes de
<literal>\labelenumi</literal> jusqu&#8217;à <literal>\labelenumiv</literal> pour produire l&#8217;étiquette
par défaut. Ainsi, vous pouvez utiliser <literal>\renewcommand</literal> pour
-chancher le format des étiquettes (voir <link linkend="_005cnewcommand-_0026-_005crenewcommand">\newcommand &amp;
+chancher le format des étiquettes (see <link linkend="_005cnewcommand-_0026-_005crenewcommand">\newcommand &amp;
\renewcommand</link>). Par exemple, cette liste de premier niveau va être
étiquettée avec des lettres capitales, en gras, non suivies point :
</para>
@@ -3047,6 +3935,7 @@ cela.
<indexterm role="fn"><primary>environnement <literal>eqnarray</literal></primary></indexterm>
<indexterm role="fn"><primary><literal>eqnarray</literal>, environnement</primary></indexterm>
+
<indexterm role="cp"><primary>équations, aligner</primary></indexterm>
<indexterm role="cp"><primary>aligner des équations</primary></indexterm>
@@ -3098,6 +3987,7 @@ et le justifie à gauche dans une boîte de largeur nulle.
<indexterm role="fn"><primary>environnement <literal>equation</literal></primary></indexterm>
<indexterm role="fn"><primary><literal>equation</literal>, environnement</primary></indexterm>
+
<indexterm role="cp"><primary>équations, environnement pour</primary></indexterm>
<indexterm role="cp"><primary>formules, environnement pour</primary></indexterm>
@@ -3108,7 +3998,7 @@ et le justifie à gauche dans une boîte de largeur nulle.
\end{equation}
</screen>
<para>L&#8217;environnement <literal>equation</literal> commence un environnement en
-<literal>displaymath</literal> (voir <link linkend="displaymath">displaymath</link>), par ex. en centrant le texte
+<literal>displaymath</literal> (see <link linkend="displaymath">displaymath</link>), par ex. en centrant le texte
<replaceable>math</replaceable> sur la page, et aussi en plaçant un numéro d&#8217;équation dans la
marge de droite.
</para>
@@ -3118,6 +4008,7 @@ marge de droite.
<title><literal>figure</literal></title>
<indexterm role="fn"><primary>environnement <literal>figure</literal></primary></indexterm>
<indexterm role="fn"><primary><literal>figure</literal>, environnement</primary></indexterm>
+
<indexterm role="cp"><primary>inserer des figures</primary></indexterm>
<indexterm role="cp"><primary>figures, insertion</primary></indexterm>
@@ -3135,9 +4026,9 @@ marge de droite.
<replaceable>corpsfigure</replaceable>
\caption[<replaceable>titreldf</replaceable>]{<replaceable>texte</replaceable>}
\label{<replaceable>étiquette}</replaceable>
-\end{figure}
+\end{figure*}
</screen>
-<para>Une classe de flottant (voir <link linkend="Floats">Floats</link>). Parce qu&#8217;elles ne peuvent pas
+<para>Une classe de flottant (see <link linkend="Floats">Floats</link>). Parce qu&#8217;elles ne peuvent pas
être coupées à cheval sur plusieurs pages, elles ne sont pas composées
en séquence avec le texte normal, mais au contraire sont &#8220;flottées&#8221;
vers un endroit convenable, tel que le sommet d&#8217;une page suivante.
@@ -3146,7 +4037,7 @@ vers un endroit convenable, tel que le sommet d&#8217;une page suivante.
l&#8217;algorithme de placement des flottants, voir <link linkend="Floats">Floats</link>.
</para>
<para>La version étoilée <literal>figure*</literal> est utilisée quand un document est en
-mode double-colonne (voir <link linkend="_005ctwocolumn">\twocolumn</link>). elle produit une figure qui
+mode double-colonne (see <link linkend="_005ctwocolumn">\twocolumn</link>). elle produit une figure qui
s&#8217;étend sur les deux colonnes, au sommet de la page. Pour ajouter la
possibiltié de la placer à un bas de page voir la discussion de
<replaceable>placement</replaceable> <literal>b</literal> dans <link linkend="Floats">Floats</link>.
@@ -3156,12 +4047,12 @@ possibiltié de la placer à un bas de page voir la discussion de
etc.
</para>
<para>L&#8217;étiquette est optionnelle ; elle est utilisée pour les double renvois
-(voir <link linkend="Cross-references">Cross references</link>).
+(see <link linkend="Cross-references">Cross references</link>).
<indexterm role="fn"><primary>\caption</primary></indexterm>
La commande <literal>\caption</literal> spécifie la légende <replaceable>texte</replaceable> pour la
figure. La légende est numérotée par défaut. Si <replaceable>titreldf</replaceable> est
présent, il est utilisé dans la liste des figures au lieu de <replaceable>texte</replaceable>
-(voir <link linkend="Tables-of-contents">Tables of contents</link>).
+(see <link linkend="Table-of-contents-etc_002e">Table of contents etc.</link>).
</para>
<para>Cet exemple fabrique une figure à partir d&#8217;un graphique. Il nécessite
l&#8217;un des paquetage <filename>graphics</filename> ou <filename>graphicx</filename>. Le graphique,
@@ -3180,42 +4071,68 @@ fin du document, sur une page de flottants.
<title><literal>filecontents</literal>: Écrire un fichier externe</title>
<indexterm role="fn"><primary>environnement <literal>filecontents</literal></primary></indexterm>
<indexterm role="fn"><primary><literal>filecontents</literal>, environnement</primary></indexterm>
+
<indexterm role="fn"><primary>environnement <literal>filecontents*</literal></primary></indexterm>
<indexterm role="fn"><primary><literal>filecontents*</literal>, environnement</primary></indexterm>
+
<indexterm role="cp"><primary>fichier externe, écrire</primary></indexterm>
<indexterm role="cp"><primary>écrire un fichier externe</primary></indexterm>
<para>Synopsis :
</para>
-<screen>\begin{filecontents}{<replaceable>nomfichier</replaceable>}
+<screen>\begin{filecontents}[<replaceable>option</replaceable>]{<replaceable>nomfichier</replaceable>}
<replaceable>texte</replaceable>
\end{filecontents}
</screen>
<para>ou
</para>
-<screen>\begin{filecontents*}{<replaceable>nomfichier</replaceable>}
+<screen>\begin{filecontents*}[<replaceable>option</replaceable>]{<replaceable>nomfichier</replaceable>}
<replaceable>texte</replaceable>
\end{filecontents*}
</screen>
-<para>Crée un fichier nommé <replaceable>nomfichier</replaceable> et le remplit de <replaceable>texte</replaceable>. La
-version non étoilée de l&#8217;environnement <literal>filecontent</literal> préfixe le
-contenu du ficher crée d&#8217;une en-tête ; voir l&#8217;exemple ci-dessous. La
-version étoilée <literal>filecontent*</literal> n&#8217;inclut par l&#8217;en-tête.
-</para>
-<para>Cet environnement peut être utilisé n&#8217;importe-où dans le préambule, bien
-qu&#8217;elle apparaisse en général avant la commande
-<literal>\documentclass</literal>. Elle est typiquement utilisée quand une fichier
-source a besoin d&#8217;un fichier non standard de style ou de
-classe. L&#8217;environnement permet d&#8217;écrire ce fichier dans le répertoire
-contenant ce fichier et ainsi de rendre le code source autonome. Une
-autre utilisation est d&#8217;inclure des référence au format <literal>bib</literal> dans
-le fichier source, de même pour le rendre autonome.
-</para>
-<para>L&#8217;environnement vérifie si un fichier de même nom existe déjà, et si
-oui, ne fait rien. Il y a un paquetage <filename>filecontents</filename> qui redéfinit
-l&#8217;environnement <literal>filecontents</literal> de sorte qu&#8217;au lieu de ne rien faire
-dans ce cas, il écrase le fichier existant.
+<para>Crée un fichier nommé <replaceable>nomfichier</replaceable> dans le répertoire courant (ou
+dans le répertoire de sortie s&#8217;il a été spécifié ; see <link linkend="output-directory">output
+directory</link>) et y écrit <replaceable>texte</replaceable>. Par défaut un fichier déjà existant
+n&#8217;est pas écrasé.
+</para>
+<para>La version non étoilée de l&#8217;environnement <literal>filecontent</literal> préfixe le
+contenu du ficher créé d&#8217;une en-tête de commentaires &tex; ; voir
+l&#8217;exemple ci-dessous. La version étoilée <literal>filecontent*</literal> n&#8217;inclut
+par l&#8217;en-tête.
</para>
+<para>Les options possibles sont :
+</para>
+<variablelist><varlistentry><term><literal>force</literal>
+</term><term><literal>overwrite</literal>
+</term><listitem><indexterm role="cp"><primary><literal>force</literal>, option de <literal>filecontents</literal></primary></indexterm>
+<indexterm role="cp"><primary><literal>overwrite</literal>, option de <literal>filecontents</literal></primary></indexterm>
+<para>Écrase le fichier s&#8217;il existe.
+</para>
+</listitem></varlistentry><varlistentry><term><literal>noheader</literal>
+</term><listitem><indexterm role="cp"><primary><literal>noheader</literal>, option de <literal>filecontents</literal></primary></indexterm>
+<para>Omet l&#8217;en-tête. Équivalent à utiliser <literal>filecontents*</literal>.
+</para>
+</listitem></varlistentry><varlistentry><term><literal>nosearch</literal>
+</term><listitem><indexterm role="cp"><primary><literal>nosearch</literal>, option de <literal>filecontents</literal></primary></indexterm>
+<para>Vérifie uniquement si un fichier existe dans le répertoire courant (et
+le répertoire de sortie, s&#8217;il a été spécifié), non dans le chemin
+complet de recherche.
+</para>
+
+</listitem></varlistentry></variablelist>
+<para>Ces options ont été ajoutées à la parution 2019 de &latex;.
+</para>
+<indexterm role="cp"><primary>sources autonomes</primary></indexterm>
+<indexterm role="cp"><primary>fichiers source, rendre autonomes</primary></indexterm>
+<para>Cet environnement peut être utilisé n&#8217;importe où dans le préambule, bien
+qu&#8217;il apparaisse souvent avant la commande <literal>\documentclass</literal>. Elle
+est classiquement utilisée pour créer un fichier <literal>.bib</literal> ou d&#8217;autre
+fichier de données similaire à partir du document source principale, de
+sorte à rendre le fichier source autonome. De même, il peut être utilisé
+pour créer un fichier personnalisé de style ou de classe, rendant ainsi
+encore le source autonome.
+</para>
+
<para>Par exemple, ce document :
</para>
<screen>\documentclass{article}
@@ -3227,7 +4144,7 @@ dans ce cas, il écrase le fichier existant.
Un article de \monnom.
\end{document}
</screen>
-<para>produit ce fichier <filename>JH.sty</filename>.
+<para>produit ce fichier <filename>JH.sty</filename> :
</para>
<screen>%% LaTeX2e file `JH.sty'
%% generated by the `filecontents' environment
@@ -3241,6 +4158,7 @@ Un article de \monnom.
<title><literal>flushleft</literal></title>
<indexterm role="fn"><primary>environnement <literal>flushleft</literal></primary></indexterm>
<indexterm role="fn"><primary><literal>flushleft</literal>, environnement</primary></indexterm>
+
<indexterm role="cp"><primary>jsutifier à gauche du texte, environnement pour</primary></indexterm>
<indexterm role="cp"><primary>texte fer à gauche, environnement pour</primary></indexterm>
<indexterm role="cp"><primary>texte ferré à gauche, environnement pour</primary></indexterm>
@@ -3289,6 +4207,7 @@ l&#8217;unité de paragraphe.
<title><literal>flushright</literal></title>
<indexterm role="fn"><primary>environnement <literal>flushright</literal></primary></indexterm>
<indexterm role="fn"><primary><literal>flushright</literal>, environnement</primary></indexterm>
+
<indexterm role="cp"><primary>texte drapeau gauche, environnement pour</primary></indexterm>
<indexterm role="cp"><primary>justifier à droite, environnement pour</primary></indexterm>
@@ -3332,6 +4251,7 @@ termine l&#8217;unité de paragraphe.
<title><literal>itemize</literal></title>
<indexterm role="fn"><primary>environnement <literal>itemize</literal></primary></indexterm>
<indexterm role="fn"><primary><literal>itemize</literal>, environnement</primary></indexterm>
+
<indexterm role="fn"><primary>\item</primary></indexterm>
<indexterm role="cp"><primary>listes d&#8217;articles</primary></indexterm>
<indexterm role="cp"><primary>listes non ordonnées</primary></indexterm>
@@ -3349,7 +4269,7 @@ termine l&#8217;unité de paragraphe.
puces ». Les environnement <literal>itemize</literal> peuvent être imbriqués l&#8217;un
dans l&#8217;autre, jusqu&#8217;à quatre niveaux de profondeur. Ils peuvent aussi
être imbriqués avec d&#8217;autre environnements fabriquant des paragraphes,
-comme <literal>enumerate</literal> (voir <link linkend="enumerate">enumerate</link>).
+comme <literal>enumerate</literal> (see <link linkend="enumerate">enumerate</link>).
</para>
<para>Chaque article d&#8217;une liste <literal>itemize</literal> commence avec une commande
<literal>\item</literal>. Il doit y avoir au moins une commande <literal>\item</literal> au
@@ -3387,19 +4307,30 @@ utilise des losanges :
<indexterm role="fn"><primary>\leftmarginiv</primary></indexterm>
<indexterm role="fn"><primary>\leftmarginv</primary></indexterm>
<indexterm role="fn"><primary>\leftmarginvi</primary></indexterm>
-
-<para>Les paramètres de <literal>\leftmargini</literal> jusqu&#8217;à <literal>\leftmarginvi</literal>
+<anchor id="itemize-leftmargin"/><anchor id="itemize-leftmargini"/><anchor id="itemize-leftmarginii"/><anchor id="itemize-leftmarginiii"/><anchor id="itemize-leftmarginiv"/><anchor id="itemize-leftmarginv"/><anchor id="itemize-leftmarginvi"/><para>Les paramètres de <literal>\leftmargini</literal> jusqu&#8217;à <literal>\leftmarginvi</literal>
définissent la distance entre la marge de gauche de l&#8217;environnement
-surjacent et la marge de gauche de la liste. Par convention,
-<literal>\leftmargin</literal> est réglée à la <literal>\leftmargin<replaceable>N</replaceable></literal> appropriée
-quand on entre dans un nouveau niveau d&#8217;imbrication.
+surjacent et la marge de gauche de la liste. (Notez la convention de
+nommage de la commande avec un nombre romain en bas de casse à la fin
+pour désigner le niveau d&#8217;imbrication). Les valeurs par défaut sont :
+<literal>2.5em</literal> pour le niveau 1 (<literal>2em</literal> en mode deux-colonnes),
+<literal>2.2em</literal> pour le niveau 2, <literal>1.87em</literal> pour le niveau 3 et
+<literal>1.7em</literal> pour le niveau 4, avec des valeurs plus petites pour les
+niveaux plus profondément imbriqués.
</para>
-<para>Les valeurs par défaut varient de &#8216;<literal>.5em</literal>&#8217; (pour les niveaux
-d&#8217;imbrication les plus élevés) jusqu&#8217;à &#8216;<literal>2.5em</literal>&#8217; (premier niveau), et
-sont légèrement réduits en mode deux-colonnes. Cet exemple réduit
-grandement l&#8217;espace de marge pour la liste la plus extérieure :
+<indexterm role="fn"><primary>paquetage <literal>enumitem</literal></primary></indexterm>
+<indexterm role="fn"><primary><literal>enumitem</literal>, paquetage</primary></indexterm>
+
+<para>Pour les autres environnements majeurs de listes à étiquettes de
+&latex;, voir <link linkend="description">description</link> et <link linkend="enumerate">enumerate</link>. Pour des
+informations concernant les paramètres de contrôle de la disposition des
+listes, y compris les valeurs par défaut, ainsi que la personalisaton de
+la disposition, voir <link linkend="list">list</link>. La paquetage <filename>enumitem</filename> est utile
+pour personaliser les listes.
</para>
-<screen>\setlength{\leftmargini}{1.25em} % par défaut 2.5em
+<para>Dans cet exemple on réduit grandement l&#8217;espace de marge pour la liste à
+puces la plus externe~:
+</para>
+<screen>\setlength{\leftmargini}{1.25em} % valeur par défaut 2.5em
</screen>
<!-- xx should be in its own generic section -->
<para>Quelques paramètres qui affectent le formatage des listes :
@@ -3463,7 +4394,7 @@ désirable d&#8217;élider l&#8217;espace entre les articles. Voici un exemple
définissant un environnement <literal>itemize*</literal> sans espacement
supplémentaire entre les articles, ni entre les paragraphes au sein d&#8217;un
seul article (<literal>\parskip</literal> n&#8217;est pas spécifique aux listes,
-voir <link linkend="_005cparskip">\parskip</link>):
+see <link linkend="_005cparindent-_0026-_005cparskip">\parindent &amp; \parskip</link>):
</para>
<screen>\newenvironment{itemize*}%
{\begin{itemize}%
@@ -3479,7 +4410,8 @@ voir <link linkend="_005cparskip">\parskip</link>):
<indexterm role="fn"><primary>environnement <literal>letter</literal></primary></indexterm>
<indexterm role="fn"><primary><literal>letter</literal>, environnement</primary></indexterm>
-<para>Cet environnement est utilisé pour créer des lettres. Voir <link linkend="Letters">Letters</link>.
+
+<para>Cet environnement est utilisé pour créer des lettres. See <link linkend="Letters">Letters</link>.
</para>
</sect1>
@@ -3487,35 +4419,333 @@ voir <link linkend="_005cparskip">\parskip</link>):
<title><literal>list</literal></title>
<indexterm role="fn"><primary>environnement <literal>list</literal></primary></indexterm>
<indexterm role="fn"><primary><literal>list</literal>, environnement</primary></indexterm>
+
<indexterm role="cp"><primary>listes d&#8217;articles, générique</primary></indexterm>
-<para>L&#8217;environnement <literal>list</literal> est un environnement générique qui est
-utilisé pour définir beaucoup des environnements plus spécifiques. Il
-est rarement utilisé dans des documents, mais souvant dans des macros.
+<para>Synopsis :
</para>
-<screen>\begin{list}{<replaceable>étiquettage</replaceable>}{<replaceable>espacement</replaceable>}
-\item <replaceable>item1</replaceable>
-\item <replaceable>item2</replaceable>
+<screen>\begin{list}{<replaceable>étiquetage</replaceable>}{<replaceable>espacement</replaceable>}
+\item[<replaceable>étiquette optionnelle du premier article</replaceable>] texte du premier article
+\item[<replaceable>étiquette optionnelle du deuxième article</replaceable>] texte du deuxième aticle
...
\end{list}
</screen>
-<para>L&#8217;argument obligatoire <replaceable>étiquettage</replaceable> spécifie comment les articles
-doivent être étiquetés (à moins que son argument optionnel soit fourni à
-<literal>\item</literal>). Cet argument est un morceau de texte qui est inséré dans
-une boîte pour former l&#8217;étiquette. Il peut contenir, et d&#8217;habitude c&#8217;est
-le cas, d&#8217;autres commandes &latex;.
+<para>L&#8217;environnement <literal>list</literal> est un environnement générique qui est
+utilisé pour construire des listes plus spécialisées. On l&#8217;utilise la
+plupart du temps pour créer des listes via les environnements
+<literal>description</literal>, <literal>enumerate</literal>, et <literal>itemize</literal>
+(see <link linkend="description">description</link>, <link linkend="enumerate">enumerate</link>, et <link linkend="itemize">itemize</link>). Par ailleurs,
+beaucoup d&#8217;environnements standards de &latex; qui visuellement ne sont
+pas des listes sont construits en utilisant <literal>list</literal>, ceci comprend
+<literal>quotation</literal>, <literal>quote</literal>, <literal>center</literal>, <literal>verbatim</literal>, et bien
+d&#8217;autres (see <link linkend="quotation-_0026-quote">quotation &amp; quote</link>, see <link linkend="center">center</link>,
+see <link linkend="flushright">flushright</link>).
+</para>
+<para>Ici, on décrit l&#8217;environnement <literal>list</literal> en définissant un
+nouvel environnement personnalisé.
+</para>
+<screen>\newcounter{compteurlistenommage} % numérotes les articles
+\newenvironment{nommage}
+ {\begin{list}
+ {Article~\Roman{compteurlistenommage}.} % argument d'étiquetage
+ {\usecounter{compteurlistenommage} % argument d'espacement
+ \setlength{\leftmargin}{3.5em}} % ...suite argument d'espacement
+ }
+ {\end{list}}
+
+\begin{nommage}
+ \item Apparaît comme « Article~I. »
+ \item[Étiquette spéciale.] Apparaît comme « Étiquette spéciale. »
+ \item Apparaît comme « Article~II. »
+\end{nommage}
+</screen>
+<para>L&#8217;argument obligatoire <replaceable>étiquetage</replaceable>, qui est le premier argument de
+l&#8217;environnement <literal>list</literal>, spécifie comment les articles doivent être
+étiquetés par défaut. Il peut contenir du texte et des commandes
+&latex;, comme dans l&#8217;exemple précédent où il contient à la fois
+&#8216;<literal>Article</literal>&#8217; et &#8216;<literal>\Roman{&#8230;}</literal>&#8217;. &latex; forme l&#8217;étiquette
+en mettant l&#8217;argument <replaceable>étiquetage</replaceable> dans une boîte de largeur
+<literal>\labeidth</literal>. Si l&#8217;étiquette est plus large que cela, le matériel
+supplémentaire s&#8217;étend sur la droite. Lorsque vous fabriquez une
+instance de <literal>list</literal> vous pouvez l&#8217;emporter sur l&#8217;étiquetage par
+défaut en donnant à <literal>\item</literal> un argument optionnel avec des crochets
+et le texte, comme dans l&#8217;exemple précédent <literal>\item[Étiquette
+spéciale.]</literal> ; see <link linkend="_005citem">\item</link>.
+</para>
+<para>Le second argument obligatoire <replaceable>espacement</replaceable> prend une liste de
+commandes. L&#8217;une de celle qu&#8217;on y retrouve est
+<literal>\usecounter{<replaceable>nomcompteur</replaceable>}</literal> (see <link linkend="_005cusecounter">\usecounter</link>). Utilisez
+la pour dire à &latex; de numéroter les article en utilisant le
+compteur fourni. Ce compteur est remis à zéro chaque fois que &latex;
+entre dans l&#8217;environnement, et le compteiur est incrémenté par un chaque
+fois que &latex; rencontre une commande <literal>\item</literal>.
+</para>
+<indexterm role="fn"><primary>\makelabel</primary></indexterm>
+<para>Une autre commande qu&#8217;on retrouve dans <replaceable>espacement</replaceable> est
+<literal>\makelabel</literal>, pour construire la boîte de l&#8217;étiquette. Par défaut
+elle positionne le contenu fer à droite. Elle prend un argument,
+l&#8217;étiquette. Elle compose sont contenu en mode LR. Un exemple de
+changement de sa définition consiste dans l&#8217;exemple précédent
+<literal>nommage</literal> à ajouter avant la définition de l&#8217;environnement
+<literal>\newcommand{\namedmakelabel}[1]{\textsc{#1}}</literal>, et entre la
+commande <literal>\setlength</literal> et la parenthèse cloturant l&#8217;argument
+<replaceable>espacmeent</replaceable> à ajouter aussi <literal>\let\makelabel\namedmakelabel</literal>.
+Ceci composera les étiquette en petites capitales. De même, en
+remplaçant cette seconde ligne de code par <literal>\let\makelabel\fbox</literal> on
+met les étiquettes dans une boîte encadrée. Ci-après voici un autre
+exemple de la commande <literal>\makelabel</literal>, dans la définition de
+l&#8217;énvironnement <literal>etiquetterouge</literal>.
+</para>
+<para>De même on trouve souvent au sein de <replaceable>espacement</replaceable> des commandes pour
+redéfinir l&#8217;espacement de la liste. Ci dessous on listes les paramètres
+d&#8217;espacement et leur valeurs par défaut. (Il se peut que les valeurs par
+défaut pour les environnements dérivés tels que <literal>itemize</literal> soient
+différentes des valeurs exposées ici). Voir aussi la figure qui suit la
+liste. Chaque paramètre est une longueur (see <link linkend="Lengths">Lengths</link>). Les espaces
+verticaux sont d&#8217;ordinaire des longueurs élastiques, avec une composante
+en <literal>plus</literal> ou en <literal>minus</literal>, pour donner à &tex; de la
+flexibilité dans le réglage de la page. On change chaque paramètre avec
+une commande du genre de as <literal>\setlength{itemsep}{2pt plus1pt
+minus1pt}</literal>. Pour obtenir certains effets, ces longueurs doivent être
+mise à zéro, ou à une valeur négative.
+</para>
+<variablelist><varlistentry><term><indexterm role="fn"><primary>\itemindent</primary></indexterm><literal>\itemindent</literal>
+</term><listitem><para>Espace supplémentaire horizontal de renfoncement, ajouté à de
+<literal>leftmargin</literal>, de la première ligne de chaque article. Sa valeur par
+défaut est <literal>0pt</literal>.
+</para>
+</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\itemsep</primary></indexterm><literal>\itemsep</literal>
+</term><listitem><para>Espace vertical entre les articles, ajouté à <literal>\parsep</literal>. Les
+valeurs par défaut pour les trois premiers niveaux dans les classes de
+&latex; &#8216;<literal>article</literal>&#8217;, &#8216;<literal>book</literal>&#8217;, et &#8216;<literal>report</literal>&#8217; à la taille de 10
+point sont : <literal>4pt plus2pt minus1pt</literal>, <literal>\parsep</literal> (c-à-d.
+<literal>2pt plus1pt minus1pt</literal>), et <literal>\topsep</literal> (c-à-d. <literal>2pt
+plus1pt minus1pt</literal>). Les valeurs par défaut à 11 points sont :
+<literal>4.5pt plus2pt minus1pt</literal>, <literal>\parsep</literal> (c-à-d. <literal>2pt
+plus1pt minus1pt</literal>), et <literal>\topsep</literal> (c-à-d. <literal>2pt plus1pt
+minus1pt</literal>). Les valeurs par défaut à 12 points sont : <literal>5pt
+plus2.5pt minus1pt</literal>, <literal>\parsep</literal> (c-à-d. <literal>2.5pt plus1pt
+minus1pt</literal>), et <literal>\topsep</literal> (c-à-d. <literal>2.5pt plus1pt minus1pt</literal>).
+</para>
+</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\labelsep</primary></indexterm><literal>\labelsep</literal>
+</term><listitem><para>Espace horizontal entre l&#8217;étiquette et le texte d&#8217;un article. La valeur
+par défaut pour les classes &latex; &#8216;<literal>article</literal>&#8217;, &#8216;<literal>book</literal>&#8217;, et
+&#8216;<literal>report</literal>&#8217; est de <literal>0.5em</literal>.
</para>
-<para>L&#8217;argument obligatoire <replaceable>espacement</replaceable> contient des commandes pour
-changer les paramètres d&#8217;espacement pour la liste. Cet argument est le
-plus souvent vide, c.-à-d. <literal>{}</literal>, ce qui laisse l&#8217;espacement
-par défaut.
+</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\labelwidth</primary></indexterm><literal>\labelwidth</literal>
+</term><listitem><para>Largueur horizontale. La boîte contenant l&#8217;étiquette est nominalement de
+cette largeur. Si <literal>\makelabel</literal> renvoie un texte qui est plus larget
+que cela, alors le renfoncement de la première ligne de l&#8217;article sera
+augmenté pour créer l&#8217;espace nécessaire à ce matériel supplémentaire.
+Si <literal>\makelabel</literal> renvoie un texte de largeur inférieur ou égale à
+<literal>\labelwidth</literal> alors le comportement par défaut de &latex; est que
+l&#8217;étiquette est composé fer à droite dans une boîte de cette largeur.
+</para>
+<para>Le bord de gauche de la boîte de l&#8217;étiquette est à
+<literal>\leftmargin</literal>+<literal>\itemindent</literal>-<literal>\labelsep</literal>-<literal>\labelwidth</literal>
+de la marge de gauche de l&#8217;environnement enveloppant.
+</para>
+<para>La valeur par défaut pour les classe &latex; &#8216;<literal>article</literal>&#8217;,
+&#8216;<literal>book</literal>&#8217;, et &#8216;<literal>report</literal>&#8217; pour les liste de premier niveau vaut
+<literal>\leftmargini</literal>-<literal>\labelsep</literal>, (c-à-d. <literal>2em</literal> en mode à une
+colonne et <literal>1.5em</literal> en mode à deux colonnes). Au deuxième niveau,
+c&#8217;est <literal>\leftmarginii</literal>-<literal>\labelsep</literal>, et au troisième niveau
+<literal>\leftmarginiii</literal>-<literal>\labelsep</literal>. Ces définitions ont pour effet
+que le bord de gauche de l&#8217;étiquette coïncide avec la marge dee gauche
+de l&#8217;environnement enveloppant.
+</para>
+<para>r</para></listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\leftmargin</primary></indexterm><literal>\leftmargin</literal>
+</term><listitem><para>Espace horizontal entre la marge de gauche de l&#8217;environnement envelopant
+(ou la marge de gauche de la page pour une liste de premier niveau), et
+la marge de gauche de cette liste. Doit être positif ou nul.
+</para>
+<para>Dans les classes de document &latex; standardes, ce paramètre est réglé
+à la valeur <literal>\leftmargini</literal> pour une liste de premier niveau, alors
+que pour une liste de deuxième niveau, c&#8217;est à dire imbriquée dans une
+liste de premier niveau, il est réglé à <literal>\leftmarginii</literal>. Pour les
+listes aux niveaux d&#8217;imbrication suivants les valeurs de
+<literal>\leftmarginiii</literal> à <literal>\leftmarginvi</literal> sont utilisées. (Imbriquer
+des liste au delà de cinq niveaux produit le message d&#8217;erreur &#8216;<literal>Too
+deeply nested</literal>&#8217;).
+</para>
+<para>Les valeurs par défaut des trois premiers niveaux dans les classes
+&latex; &#8216;<literal>article</literal>&#8217;, &#8216;<literal>book</literal>&#8217;, et &#8216;<literal>report</literal>&#8217; sont les
+suivantes : <literal>\leftmargini</literal> vaut <literal>2.5em</literal> (ou <literal>2em</literal> en mode
+à deux colonnes), <literal>\leftmarginii</literal> vaut <literal>2.2em</literal>, et
+<literal>\leftmarginiii</literal> vaut <literal>1.87em</literal>.
+</para>
+</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\listparindent</primary></indexterm><literal>\listparindent</literal>
+</term><listitem><para>Espace horizontal de renfoncement supplémentaire, en plus de
+<literal>\leftmargin</literal>, pour le deuxième paragraphes et les suivants au sein
+d&#8217;un article de liste. A negative value makes this an &#8220;outdent&#8221;. Its
+default value is <literal>0pt</literal>.
+</para>
+</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\parsep</primary></indexterm><literal>\parsep</literal>
+</term><listitem><anchor id="list-parsep"/><para>Espace vertical entre les paragraphe d&#8217;un article.
+Les valeurs par défaut pour les trois premierss niveaux dans les classes
+&latex; &#8216;<literal>article</literal>&#8217;, &#8216;<literal>book</literal>&#8217; et &#8216;<literal>report</literal>&#8217; à la taille de 10
+point sont : <literal>4pt plus2pt minus1pt</literal>, <literal>2pt plus1pt minus1pt</literal>,
+and <literal>0pt</literal>. La valeurs par défaut à la taille de 11 point sont :
+<literal>4.5pt plus2pt minus1pt</literal>, <literal>2pt plus1pt minus1pt</literal>, et
+<literal>0pt</literal>. La valeurs par défaut à la taille de 12 point sont :
+<literal>5pt plus2.5pt minus1pt</literal>, <literal>2.5pt plus1pt minus1pt</literal>, and
+<literal>0pt</literal>.
+</para>
+</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\partopsep</primary></indexterm><literal>\partopsep</literal>
+</term><listitem><anchor id="list-partopsep"/><para>Espace vertical ajouté, en plus de
+<literal>\topsep</literal>+<literal>\parskip</literal>, en haut et en bas de l&#8217;environnement
+tout entier lorsque la liste considérée est précédée d&#8217;une ligne à
+blanc. (Une ligne à blanc dans le source &latex; avant la liste change
+l&#8217;espacement à la fois en haut et en bas de la liste ; que la ligne
+suivant la liste soit à blanc est sans importance).
+</para>
+<para>Les valeurs par défaut pour les trois premiers niveaux dans les classes
+&latex; &#8216;<literal>article</literal>&#8217;, &#8216;<literal>book</literal>&#8217;, anet &#8216;<literal>report</literal>&#8217; à la taille de
+point sont : <literal>2pt plus1 minus1pt</literal>, <literal>2pt plus1pt minus1pt</literal>, et
+<literal>1pt plus0pt minus1pt</literal>. Les valeurs par défaut à la taille de 11
+point sont : <literal>3pt plus1pt minus1pt</literal>, <literal>3pt plus1pt minus1pt</literal>,
+et <literal>1pt plus0pt minus1pt</literal>). Les valeurs par défaut à la taille de
+12 point sont : <literal>3pt plus2pt minus3pt</literal>, <literal>3pt plus2pt
+minus2pt</literal>, et <literal>1pt plus0pt minus1pt</literal>.
+</para>
+</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\rightmargin</primary></indexterm><literal>\rightmargin</literal>
+</term><listitem><anchor id="list-rightmargin"/>
+<para>Espace horizontal entre la marge de droite de la liste et la marge de
+droite de l&#8217;environnement l&#8217;englobant. Horizontal space between the right margin of the list
+and the right margin of the enclosing environment. Its default value is
+<literal>0pt</literal>. It must be non-negative.
</para>
-<para>L&#8217;argument utilisé pour composer les articles de la liste est spécifiée
-par <literal>\linewidth</literal> (voir <link linkend="Page-layout-parameters">Page layout parameters</link>).
+</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\topsep</primary></indexterm><literal>\topsep</literal>
+</term><listitem><anchor id="list-topsep"/><para>Espace vertical ajouté aussi bien au haut qu&#8217;au bas
+de la lise, en plus de <literal>\parskip</literal> (see <link linkend="_005cparindent-_0026-_005cparskip">\parindent &amp; \parskip</link>).
+Les valeurs par défaut pour les trois premiers niveaux dans les classes
+&latex; &#8216;<literal>book</literal>&#8217;, anet &#8216;<literal>report</literal>&#8217; à la taille de 10 point sont :
+<literal>8pt plus2pt minus4pt</literal>, <literal>4pt plus2pt minus1pt</literal>, and <literal>2pt
+plus1pt minus1pt</literal>. Les valeurs par défaut à la taille de 11 point
+sont : <literal>9pt plus3pt minus5pt</literal>, <literal>4.5pt plus2pt minus1pt</literal>, and
+<literal>2pt plus1pt minus1pt</literal>. Les valeurs par défaut à la taille de 12
+point sont : <literal>10pt plus4pt minus6pt</literal>, <literal>5pt plus2.5pt
+minus1pt</literal>, and <literal>2.5pt plus1pt minus1pt</literal>.
+</para>
+</listitem></varlistentry></variablelist>
+<para>La figure suivante illustre les distances horizontales et verticales.
+</para>
+<informalfigure><mediaobject><imageobject><imagedata fileref="latex2e-figures/list.eps" format="EPS"></imagedata></imageobject><imageobject><imagedata fileref="latex2e-figures/list.pdf" format="PDF"></imagedata></imageobject><imageobject><imagedata fileref="latex2e-figures/list.png" format="PNG"></imagedata></imageobject><textobject><literallayout>.......................................................................
+..............Surrounding environment, preceding material.............. -
+ | v0
+ |---h0--|-h1-| |
+ ..Label.. .....First item..................................... -
+ ............................................................
+ ............................................................ -
+ | v1
+ ........First item, second paragraph .................. -
+ |-h2-| | v2
+ |
+ ..Label.. .....Second item.................................... -
+ ............................................................
+ ............................................................ -
+|-h3--|-h4-| |-h5-| |v3
+ |
+..............Surrounding environment, following material.............. -
+.......................................................................</literallayout></textobject></mediaobject></informalfigure>
+
+<para>Les longueurs illustrées sont listées ci-dessous. La relation clef est
+que le bord droit du crochet pour <replaceable>h1</replaceable> est à la même position
+horizontale que le bord droit du crochet pour <replaceable>h4</replaceable>, de sorte que le
+bord de gauche de la boîte de l&#8217;étiquette est à
+<replaceable>h3</replaceable>+<replaceable>h4</replaceable>-(<replaceable>h0</replaceable>+<replaceable>h1</replaceable>).
+</para>
+<variablelist><varlistentry><term><replaceable>v0</replaceable>
+</term><listitem><para>vaut <inlineequation><mathphrase><literal>\topsep</literal> + <literal>\parskip</literal></mathphrase></inlineequation> si l&#8217;environnement
+<literal>list</literal> ne commence pas un nouveau paragraphe, et
+<literal>\topsep</literal>+<literal>\parskip</literal>+<literal>\partopsep</literal> sinon
+</para>
+</listitem></varlistentry><varlistentry><term><replaceable>v1</replaceable>
+</term><listitem><para><literal>\parsep</literal>
+</para>
+</listitem></varlistentry><varlistentry><term><replaceable>v2</replaceable>
+</term><listitem><para><literal>\itemsep</literal>+<literal>\parsep</literal>
+</para>
+</listitem></varlistentry><varlistentry><term><replaceable>v3</replaceable>
+</term><listitem><para>Même valeur que <replaceable>v0</replaceable>. (Cet espace est affecté selon qu&#8217;une ligne à
+blanc apparaît dans le source au dessus de l&#8217;environnemnt ; la présence
+d&#8217;une ligne à blanc au dessous de l&#8217;environnement est sans effet.)
+</para>
+</listitem></varlistentry><varlistentry><term><replaceable>h0</replaceable>
+</term><listitem><para><literal>\labelwidth</literal>
+</para>
+</listitem></varlistentry><varlistentry><term><replaceable>h1</replaceable>
+</term><listitem><para><literal>\labelsep</literal>
+</para>
+</listitem></varlistentry><varlistentry><term><replaceable>h2</replaceable>
+</term><listitem><para><literal>\listparindent</literal>
+</para>
+</listitem></varlistentry><varlistentry><term><replaceable>h3</replaceable>
+</term><listitem><para><literal>\leftmargin</literal>
+</para>
+</listitem></varlistentry><varlistentry><term><replaceable>h4</replaceable>
+</term><listitem><para><literal>\itemindent</literal>
+</para>
+</listitem></varlistentry><varlistentry><term><replaceable>h5</replaceable>
+</term><listitem><para><literal>\rightmargin</literal>
+</para>
+</listitem></varlistentry></variablelist>
+<para>The list&#8217;s left and right margins, shown above as <replaceable>h3</replaceable> and <replaceable>h5</replaceable>,
+are with respect to the ones provided by the surrounding environment, or
+with respect to the page margins for a top-level list. The line width
+used for typesetting the list items is <literal>\linewidth</literal> (see <link linkend="Page-layout-parameters">Page
+layout parameters</link>). For instance, set the list&#8217;s left margin to be one
+quarter of the distance between the left and right margins of the
+enclosing environment with
+<literal>\setlength{\leftmargin}{0.25\linewidth}</literal>.
+</para>
+<para>Page breaking in a list structure is controlled by the three
+parameters below. For each, the &latex; default is
+<literal>-\@lowpenalty</literal>, that is, <literal>-51</literal>. Because it is negative,
+it somewhat encourages a page break at each spot. Change it with,
+e.g., <literal>\@beginparpenalty=9999</literal>; a value of 10000 prohibits a
+page break.
+</para>
+<variablelist><varlistentry><term><indexterm role="fn"><primary>\@beginparpenalty</primary></indexterm><literal>\@beginparpenalty</literal>
+</term><listitem><para>The page breaking penalty for breaking before the list (default <literal>-51</literal>).
+</para>
+</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\@itempenalty</primary></indexterm><literal>\@itempenalty</literal>
+</term><listitem><para>The page breaking penalty for breaking before a list item (default <literal>-51</literal>).
+</para>
+</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\@endparpenalty</primary></indexterm><literal>\@endparpenalty</literal>
+</term><listitem><para>The page breaking penalty for breaking after a list (default <literal>-51</literal>).
</para>
+</listitem></varlistentry></variablelist>
+<indexterm role="fn"><primary>paquetage <literal>enumitem</literal></primary></indexterm>
+<indexterm role="fn"><primary><literal>enumitem</literal>, paquetage</primary></indexterm>
+
+<para>Le paquetage <literal>enumitem</literal> est utile pour personaliser les
+listes.
+</para>
+<para>Dans l&#8217;exemple suivant les étiquettes sont en rouge. Elles sont
+numérotées, et le bord gauche des étiquettes est aligné avalt le bord
+gauche du texte des articles. See <link linkend="_005cusecounter">\usecounter</link>.
+</para>
+<screen>\usepackage{color}
+\newcounter{cnt}
+\newcommand{\makeredlabel}[1]{\textcolor{red}{#1.}}
+\newenvironment{redlabel}
+ {\begin{list}
+ {\arabic{cnt}}
+ {\usecounter{cnt}
+ \setlength{\labelwidth}{0em}
+ \setlength{\labelsep}{0.5em}
+ \setlength{\leftmargin}{1.5em}
+ \setlength{\itemindent}{0.5em} % equals \labelwidth+\labelsep
+ \let\makelabel=\makeredlabel
+ }
+ }
+{\end{list} }
+</screen>
-<anchor id="_005citem"/>
+<sect2 label="8.16.1" id="_005citem">
+<title><literal>\item</literal>: Une entrée dans une liste</title>
<para>Synopsis :
</para>
@@ -3532,7 +4762,7 @@ de crochets (<literal>[</literal> et <literal>]</literal>), pour utiliser des c
sein de l&#8217;argument optionnel vous devez les cacher entre accolades, comme
dans <literal>\item[Crochet fermant, {]}]</literal>. De même, pour utiliser un
crochet ouvrant comme premier caractère du texte d&#8217;un article, cachez le
-aussi au sein d&#8217;accolade. Voir <link linkend="LaTeX-command-syntax">&latex; command syntax</link>.
+aussi au sein d&#8217;accolade. See <link linkend="LaTeX-command-syntax">&latex; command syntax</link>.
</para>
<para>Dans cet exemple la liste <literal>enumerate</literal> a deux articles qui utilise
l&#8217;étiquette par défaut et une qui utilise l&#8217;étiquette optionnelle.
@@ -3548,11 +4778,55 @@ l&#8217;étiquette par défaut et une qui utilise l&#8217;étiquette optionnelle
&#8216;<literal>2.</literal>&#8217; (notez que, à cause de l&#8217;étiquette optionnelle dans le second
article, le troisième article ne reçoit pas l&#8217;étiquette &#8216;<literal>3.</literal>&#8217;).
</para>
+</sect2>
+<sect2 label="8.16.2" id="trivlist">
+<title><literal>trivlist</literal>: Une forme restreinte de <literal>list</literal></title>
+
+<para>Synopsis :
+</para>
+<screen>\begin{trivlist}
+ ...
+\end{trivlist}
+</screen>
+<para>Une version restreinte de l&#8217;environnement <literal>list</literal> dans laquelle les
+marges sont sans renfoncement et <literal>\item</literal> sans l&#8217;argument optionnel
+ne produit pas de texte. Elle est utilisée le plus souvent au sein de
+macros, de sorte à définir un environnement où la commande <literal>\item</literal>
+fait partie de la définition de l&#8217;environnement. Par exemple,
+l&#8217;environnement <literal>center</literal> est défini pour l&#8217;essentiel comme ceci :
+</para>
+<screen>\newenvironment{center}
+ {\begin{trivlist}\centering\item\relax}
+ {\end{trivlist}}
+</screen>
+<para>Utiliser <literal>trivlist</literal> de la sorte permet à la macro d&#8217;hériter du code
+mutualisé : combiner l&#8217;espace vertical provenant de deux environnement
+adjacent ; détecter si le texte suivant l&#8217;environement doit être
+considéré comme un nouveau paragraphe ou la suite du paragraphe
+précédent ; ajuster les marges de gauche et de droit pour d&#8217;éventuels
+environnements de liste imbriqués.
+</para>
+<para>En particulier, <literal>trivlist</literal> utilise les valeurs courantes des
+paramètres de liste (see <link linkend="list">list</link>), à ceci près que <literal>\parsep</literal> est
+réglé à la valeur de <literal>\parskip</literal>, et que <literal>\leftmargin</literal>,
+<literal>\labelwidth</literal>, et <literal>\itemindent</literal> sont réglés à zéro.
+</para>
+<para>Cet exemple produit les articles comme deux paragraphes, à ceci près que
+(par défaut) ils n&#8217;ont pas de renfoncement de paragraphe et sont séparés
+verticalement.
+</para>
+<screen>\begin{trivlist}
+\item C'est un fameux trois-mâts, fin comme un oiseau
+\item Hisse et ho, Santiano.
+\end{trivlist}
+</screen>
+</sect2>
</sect1>
<sect1 label="8.17" id="math">
<title><literal>math</literal></title>
<indexterm role="fn"><primary>environnement <literal>math</literal></primary></indexterm>
<indexterm role="fn"><primary><literal>math</literal>, environnement</primary></indexterm>
+
<indexterm role="cp"><primary>formules en ligne</primary></indexterm>
<para>Synopsis :
@@ -3561,69 +4835,228 @@ article, le troisième article ne reçoit pas l&#8217;étiquette &#8216;<literal
<replaceable>maths</replaceable>
\end{math}
</screen>
+<indexterm role="fn"><primary>$ en ligne, math</primary></indexterm>
+<indexterm role="fn"><primary>\(...\) en ligne, math</primary></indexterm>
<para>L&#8217;environnement <literal>math</literal> insert les <replaceable>maths</replaceable> donnés au sein du
texte en cours. <literal>\(...\))</literal> et <literal>$...$</literal> sont des synonymes.
-Voir <link linkend="Math-formulas">Math formulas</link>.
+See <link linkend="Math-formulas">Math formulas</link>.
</para>
</sect1>
<sect1 label="8.18" id="minipage">
<title><literal>minipage</literal></title>
<indexterm role="fn"><primary>environnement <literal>minipage</literal></primary></indexterm>
<indexterm role="fn"><primary><literal>minipage</literal>, environnement</primary></indexterm>
+
<indexterm role="cp"><primary>minipage, créer une</primary></indexterm>
+<para>Synopsis :
+</para>
+<screen>\begin{minipage}{<replaceable>largeur</replaceable>}
+ <replaceable>matière</replaceable>
+\end{minipage}
+</screen>
+<para>ou
+</para>
<screen>\begin{minipage}[<replaceable>position</replaceable>][<replaceable>hauteur</replaceable>][<replaceable>pos-interne</replaceable>]{<replaceable>largeur</replaceable>}
-<replaceable>texte</replaceable>
+<replaceable>matière</replaceable>
\end{minipage}
</screen>
-<para>L&#8217;environnement <literal>minipage</literal> compose son corps <replaceable>texte</replaceable> dans un
-bloc qui ne peut pas être coupé sur plusieurs pages. C&#8217;est similaire à
-la commande <literal>\parbox</literal> (voir <link linkend="_005cparbox">\parbox</link>), mais contrairement à
-<literal>\parbox</literal>, d&#8217;autres environnements de production de paragraphe
-peuvent être utilisés au sein d&#8217;une minipage.
+<para>Place <replaceable>matière</replaceable> dans une boîte qui est <replaceable>largeur</replaceable> de large. C&#8217;est
+comme une version réduite d&#8217;une page ; elle peut contenir ses propres
+notes en bas de page, listes à puces, etc. (Il y a quelques
+restrictions, notamment qu&#8217;elle ne peut pas avoir de flottants). Cette
+boîte ne peut pas être coupé sur plusieurs pages. Ainsi <literal>minipage</literal>
+est similaire à la commande <literal>\parbox</literal> (see <link linkend="_005cparbox">\parbox</link>), mais
+contrairement à <literal>\parbox</literal>, d&#8217;autres environnements de production de
+paragraphe peuvent être utilisés au sein d&#8217;une minipage. This example
+will be 3&#160;inches wide, and has two paragraphs.
+</para>
+<screen>\begin{minipage}{3in}
+ Stephen Kleene fut un fondateur de la théorie de la récursivité.
+
+ Il fut l'élève de Church, l'auteur de trois textes qui firent autorité,
+ et le président de l'Association for Symbolic Logic, et il fut
+ récompensé par la National Medal of Science.
+ \end{minipage}
+</screen>
+<para>Voir plus bas pour une discussion sur le renfoncement de paragraphe au
+sein d&#8217;une <literal>minipage</literal>.
+</para>
+<para>L&#8217;argument obligatoire <replaceable>largeur</replaceable> est une longueur rigide (see <link linkend="Lengths">Lengths</link>).
+Il donne la largeur de la boîte dans laquelle <replaceable>matière</replaceable> est composée.
</para>
-<!-- (xxref positions) -->
-<para>Les arguments sont les mêmes que pour <literal>\parbox</literal> (voir <link linkend="_005cparbox">\parbox</link>).
+<para>Il y a trois arguments optionnels, <replaceable>position</replaceable>, <replaceable>hauteur</replaceable>, et
+<replaceable>pos-interne</replaceable>. Il n&#8217;est pas nécessaire de fournir les trois à la
+fois. Par exemple, obtenez les valeur par défaut pour <replaceable>position</replaceable> et
+réglez <replaceable>hauteur</replaceable> avec <literal>\begin{minipage}[c][2.54cm]
+<replaceable>matière</replaceable> \end{minipage}</literal>. (Obtenez la hauteur naturelle avec un
+argument vide, <literal>[]</literal>).
+</para>
+<para>L&#8217;argument optionnel <replaceable>position</replaceable> gouverne la façon dont la
+<literal>minipage</literal> s&#8217;aligne verticalement avec la matière l&#8217;entourant.
+</para>
+<variablelist><varlistentry><term><literal>c</literal>
+</term><listitem><!-- xx Clarify what it means when adjacent text lines do not have aligned -->
+<!-- vertical center with each other -->
+<para>(Synonyme <literal>m</literal>) Valeur par défaut. Positionne la <literal>minipage</literal> de
+sorte que son centre vertical soit aligné avec le centre des lignes de
+texte adjacentes.
+</para>
+</listitem></varlistentry><varlistentry><term><literal>t</literal>
+</term><listitem><indexterm role="fn"><primary>\vtop &tex; de base</primary></indexterm>
+<para>Aligne la ligne du haut de la <literal>minipage</literal> sur la ligne de base du
+texte l&#8217;entourant (comme <literal>\vtop</literal> en &tex; de base).
+</para>
+</listitem></varlistentry><varlistentry><term><literal>b</literal>
+</term><listitem><indexterm role="fn"><primary>\vbox &tex; de base</primary></indexterm>
+<para>Aligne la ligne du bas de <literal>minipage</literal> avec la ligne de base du texte
+l&#8217;entourant (comme <literal>\vbox</literal> en &tex; de base).
+</para></listitem></varlistentry></variablelist>
+<para>Pour voir l&#8217;effet de ces options, comparez le résultat de la compilation de
+</para>
+<screen>---\begin{minipage}[c]{0.25in}
+ first\\ second\\ third
+\end{minipage}
+</screen>
+<para>avec ce qui se passe en remplaçant <literal>c</literal> par <literal>b</literal> ou <literal>t</literal>.
+</para>
+<para>L&#8217;argument optionnel <replaceable>hauteur</replaceable> est une longueur rigide
+(see <link linkend="Lengths">Lengths</link>). Il règle la hauteur de la <literal>minipage</literal>. Vous
+pouvez donner n&#8217;importe quelle valeur supérieure, égale ou inférieure à
+la hauteur naturelle de la <literal>minipage</literal> sans que &latex; ne produise
+une erreur ou un avertissement. Vous pouvez aussi la régler à une
+hauteur de valeur nulle ou négative.
+</para>
+<para>L&#8217;argument optionnel final <replaceable>pos-interne</replaceable> contrôle la disposition de
+<replaceable>matière</replaceable> au sein de la boîte. Voici les valeurs possibles (la
+valeur par défaut est la valeur de l&#8217;argument <replaceable>position</replaceable>).
+</para>
+<variablelist><varlistentry><term><literal>t</literal>
+</term><listitem><para>Place <replaceable>matière</replaceable> en haut de la boîte.
+</para>
+</listitem></varlistentry><varlistentry><term><literal>c</literal>
+</term><listitem><para>Centre <replaceable>matière</replaceable> verticalement.
+</para>
+</listitem></varlistentry><varlistentry><term><literal>b</literal>
+</term><listitem><para>Place <replaceable>matière</replaceable> en bas de la boîte.
</para>
-<indexterm role="cp"><primary>Renfoncement des paragraphes, au sein d&#8217;une minipage</primary></indexterm>
+</listitem></varlistentry><varlistentry><term><literal>s</literal>
+</term><listitem><para>Dilate <replaceable>matière</replaceable> verticalement ; elle doit contenir de l&#8217;espace
+dilatable verticalement.
+</para>
+</listitem></varlistentry></variablelist>
+<para>L&#8217;argument <replaceable>pos-interne</replaceable> a un sens quand l&#8217;option <replaceable>hauteur</replaceable> est
+réglée à une valeur supérieure à la hauteur naturelle de la
+<literal>minipage</literal>. Pour voir l&#8217;effet des options, exécutez l&#8217;exemple
+suivant avec les différents choix possibles au lieu de <literal>b</literal>.
+</para>
+<screen>Texte avant
+\begin{center}
+ ---\begin{minipage}[c][8cm][b]{0.25\textwidth}
+ premier\\ deuxième\\ troisième
+ \end{minipage}
+\end{center}
+Texte après
+</screen>
+<indexterm role="cp"><primary>renfoncement des paragraphes, au sein d&#8217;une minipage</primary></indexterm>
+<indexterm role="cp"><primary>paragraphes, renfoncement au sein d&#8217;une minipage</primary></indexterm>
<indexterm role="fn"><primary>\parindent</primary></indexterm>
<para>Par défaut, les paragraphes ne sont pas renfoncés au sein d&#8217;un
-environnement <literal>minipage</literal>. Vous pouvez restaurer le renfoncement avec
-une commande telle que <literal>\setlength{\parindent}{1pc}</literal>.
+environnement <literal>minipage</literal>. Vous pouvez restaurer le renfoncement
+avec une commande telle que <literal>\setlength{\parindent}{1pc}</literal> placé
+au début de <replaceable>matière</replaceable>.
</para>
<indexterm role="cp"><primary>notes en bas de page au sein des figures</primary></indexterm>
<indexterm role="cp"><primary>figures, notes en bas de page au sein des</primary></indexterm>
<para>Les notes en bas de page au sein d&#8217;un environnement <literal>minipage</literal> sont
-gérées d&#8217;une façon qui est particulièrement utiles pour mettre des notes
+gérées d&#8217;une façon qui est particulièrement utile pour mettre des notes
en bas de page dans des figures ou des tableaux. Une commande
-<literal>\footnote</literal> <literal>\footnotetext</literal> met la note en bas de page au bas
+<literal>\footnote</literal> ou <literal>\footnotetext</literal> met la note en bas de page au bas
de la minipage au lieu de la mettre au bas de la page, et elle utilise
le compteur <literal>\mpfootnote</literal> au lieu du compteur ordinaire
-<literal>footnote</literal> (voir <link linkend="Counters">Counters</link>).
+<literal>footnote</literal> (see <link linkend="Counters">Counters</link>).
+</para>
+<para>L&#8217;exemple ci-dessous place la note argument de <literal>\footnote</literal> en bas
+de la table, et non en bas de la page.
+</para>
+<screen>\begin{center} % centre la minipage sur la ligne
+\begin{minipage}{6.5cm}
+ \begin{center} % centre la table au sein de la minipage
+ \begin{tabular}{ll}
+ \textsc{Monarque} &amp;\textsc{Reigne} \\ \hline
+ Elizabeth II &amp;63 ans\footnote{à ce jour} \\
+ Victoria &amp;63 ans \\
+ George III &amp;59 ans
+ \end{tabular}
+ \end{center}
+\end{minipage}
+\end{center}
+</screen>
+<para>Si vous imbriquez des minipages, alors il y a une bizarrerie dans
+l&#8217;utilisation des note <literal>\footnote</literal>. Les notes apparaissement au bas
+du texte terminé par la prochaine <literal>\end{minipage}</literal> ce qui n&#8217;est
+peut-être pas leur place logique.
</para>
-<para>Cependant, ne mettez pas une minipage à l&#8217;intérieur d&#8217;une autre si vous
-utilisez les note en bas de page ; elles pourraient terminer en bas de
-la mauvaise minipage.
+<para>L&#8217;exemple suivant place un tableau de données côte à côte d&#8217;un
+graphique. Ils sont verticalement centrés.
</para>
+<indexterm role="fn"><primary>paquetage <literal>siunitx</literal></primary></indexterm>
+<indexterm role="fn"><primary><literal>siunitx</literal>, paquetage</primary></indexterm>
+
+<screen>% siunitx permet d'avoir le type de colonne S dans les tableaux, pour l'alignement
+% et le séparateur décimal
+\usepackage[output-decimal-marker={,}]{siunitx}
+\newcommand*{\vcenteredhbox}[1]{\begin{tabular}{@{}c@{}}#1\end{tabular}}
+ ...
+\begin{center}
+ \vcenteredhbox{\includegraphics[width=0.3\textwidth]{nyc.png}}
+ \hspace{0.1\textwidth}
+ \begin{minipage}{0.5\textwidth}
+ \begin{tabular}{r|S}
+ \multicolumn{1}{r}{Quartier} &amp;Pop. (million) \\ \hline
+ The Bronx &amp;1.5 \\
+ Brooklyn &amp;2.6 \\
+ Manhattan &amp;1.6 \\
+ Queens &amp;2.3 \\
+ Staten Island &amp;0.5
+ \end{tabular}
+ \end{minipage}
+\end{center}
+</screen>
</sect1>
<sect1 label="8.19" id="picture">
<title><literal>picture</literal></title>
<indexterm role="fn"><primary>environnement <literal>picture</literal></primary></indexterm>
<indexterm role="fn"><primary><literal>picture</literal>, environnement</primary></indexterm>
+
<indexterm role="cp"><primary>créer des images</primary></indexterm>
<indexterm role="cp"><primary>images, créer</primary></indexterm>
+<para>Synopsis :
+</para>
+<screen>\begin{picture}(<replaceable>largeur</replaceable>,<replaceable>hauteur</replaceable>)
+&#8230; <replaceable>commandes picture</replaceable> &#8230;
+\end{picture}
+</screen>
+<para>ou
+</para>
<screen>\begin{picture}(<replaceable>largeur</replaceable>,<replaceable>hauteur</replaceable>)(<replaceable>décalagex</replaceable>,<replaceable>décalagey</replaceable>)
&#8230; <replaceable>commandes picture</replaceable> &#8230;
\end{picture}
</screen>
<indexterm role="fn"><primary>\unitlength</primary></indexterm>
-<para>L&#8217;environnement <literal>picture</literal> vous permet de créer toute sorte de
-dessin dans lequel vous voulez du texte, des lignes, des flèches et des
-cercles. Vous dîtes à &latex; où mettre les chose dans le dessin en
-spécifiant leur coordonnées. Une coordonnée est un nombre qui peut avoir
-une séparateur décimal (point et non virgule) et un signe moins &#8212; un
+<para>L&#8217;environnement <literal>picture</literal> vous permet de créer des dessins simples
+contenant des lignes, des flèches, des boîtes, des cercles, et du texte.
+Cet environnement n&#8217;est pas obsolète, mais les nouveaux documents
+utilisent typiquelent des systèmes de création de graphiques bien plus
+puissants tels que TikZ, PStricks, MetaPost, ou Asymptote. Ceux-ci ne
+sont pas couverts dans ce documents ; voir le CTAN.
+</para>
+<!-- xxx Revoir la trad. -->
+<para>Vous dîtes à &latex; où mettre les chose dans le dessin en spécifiant
+leur coordonnées. Une coordonnée est un nombre qui peut avoir une
+séparateur décimal (point et non virgule) et un signe moins &#8212; un
nombre comme <literal>5</literal>, <literal>0.3</literal> ou <literal>-3.1416</literal>. Une coordonnées
spécifie une longueur en multiples de l&#8217;unité de longueur
<literal>\unitlength</literal>, ainsi si <literal>\unitlength</literal> a été réglée à
@@ -3636,6 +5069,7 @@ commande <literal>\setlength</literal>, en dehors d&#8217;un environnement
</para>
<indexterm role="fn"><primary>paquetage <literal>picture</literal></primary></indexterm>
<indexterm role="fn"><primary><literal>picture</literal>, paquetage</primary></indexterm>
+
<para>Le paquetage <literal>picture</literal> redéfinit l&#8217;environnement <literal>picture</literal> de
sorte qu&#8217;où que soit utilisé un nombre au sein de <replaceable>commandes picture</replaceable>
pour spécifier une coordonnée, on puisse alternativement utiliser une
@@ -3692,7 +5126,7 @@ référence des divers objets sont décrits plus bas.
</para>
<indexterm role="fn"><primary>lR box</primary></indexterm>
<para>La commande <literal>\put</literal> crée une <firstterm>LR box</firstterm>. Vous pouvez mettre tout
-ce qui peut aller dans une <literal>\mbox</literal> (voir <link linkend="_005cmbox">\mbox</link>) dans l&#8217;argument
+ce qui peut aller dans une <literal>\mbox</literal> (see <link linkend="_005cmbox">\mbox</link>) dans l&#8217;argument
texte de la commande <literal>\put</literal>. Quand vous faites cela, le point de
référence devient le coin inférieur gauche de la boîte .
</para>
@@ -3745,7 +5179,7 @@ spécificateurs parmi les suivants :
</term><listitem><para>Place l&#8217;article sur la droite.
</para>
</listitem></varlistentry></variablelist>
-<para>Voir <link linkend="_005cmakebox">\makebox</link>.
+<para>See <link linkend="_005cmakebox">\makebox</link>.
</para>
</sect2>
@@ -3810,18 +5244,70 @@ cadre. Aucun espace supplémentaire n&#8217;est mis entre le cadre et l&#8217;ob
<para>Synopsis :
</para>
-<screen>\line(<replaceable>xpente</replaceable>,<replaceable>ypente</replaceable>){<replaceable>longueur</replaceable>}
-</screen>
-<para>La commande <literal>\line</literal> dessine un ligne avec la <replaceable>longueur</replaceable> donnée
-et la pente <replaceable>xpente</replaceable>/<replaceable>ypente</replaceable>.
-</para>
-<para>De base &latex; peut seulement dessiner des ligne dont la
-<inlineequation><mathphrase><replaceable>pente</replaceable> = x/y</mathphrase></inlineequation>, où <inlineequation><mathphrase>x</mathphrase></inlineequation> et <inlineequation><mathphrase>y</mathphrase></inlineequation> prennent des valeurs
-entières de &#8722;6 jusqu&#8217;à 6. Pour des ligne de pente
-quelconque, sans parler d&#8217;autres formes, voir le paquetage
-<literal>curve2e</literal> et bien d&#8217;autres sur le CTAN.
+<screen>\line(<replaceable>xpente</replaceable>,<replaceable>ypente</replaceable>){<replaceable>excursion</replaceable>}
+</screen>
+<para>Dessine une ligne. Sa pente est telle que la ligne monte de <replaceable>ypente</replaceable>
+verticalement pour toute avancée horizontale de
+<replaceable>xpente</replaceable>. L&#8217;<replaceable>excursion</replaceable> est le déplacement horizontal total &#8212;
+ce n&#8217;est pas la longueur du vecteur, mais la variation en <inlineequation><mathphrase>x</mathphrase></inlineequation>. Da,s
+me cas spécial des ligne vertical, où (<replaceable>xpente</replaceable>,<replaceable>ypente</replaceable>)=(0,1),
+l&#8217;<replaceable>excursion</replaceable> donne le déplacement en <inlineequation><mathphrase>y</mathphrase></inlineequation>.
+</para>
+<para>L&#8217;exemple suivant dessine une ligne commençant aux coordonnées (1,3).
+</para>
+<screen>\put(1,3){\line(2,5){4}}
+</screen>
+<para>Pour toute avancée de 2 vers la droite, cette ligne monte de 5. Parce
+que <replaceable>excursion</replaceable> spécifie qu&#8217;elle avance de 4, elle monte en tout
+de 10. De sorte que son extrémité finale est
+<inlineequation><mathphrase>(1,3)+(4,10)=(5,13)</mathphrase></inlineequation>. En particulier, notez que
+<inlineequation><mathphrase><replaceable>excursion</replaceable>=4</mathphrase></inlineequation> n&#8217;est pas la longueur de la ligne, mais c&#8217;est
+son déplacement en <inlineequation><mathphrase>x</mathphrase></inlineequation>.
+</para>
+<para>Les arguments <replaceable>xpente</replaceable> et <replaceable>ypente</replaceable> sont des entiers qui peuvent
+être positifs, negatifs, ou nuls zero (si les deux valent 0, alors
+&latex; traite le second comme 1). Avec
+<literal>\put(<replaceable>x_init</replaceable>,<replaceable>y_init</replaceable>){\line(<replaceable>xpente</replaceable>,<replaceable>ypente</replaceable>){<replaceable>travel</replaceable>}}</literal>,
+si <replaceable>xpente</replaceable> est négatif alors l&#8217;extrémté finale d ela ligne a sa
+première coordonnée inférieure à <replaceable>x_init</replaceable>. Si <replaceable>ypente</replaceable> est
+negatif alors l&#8217;extrémité finale a sa seconde coordonnées inférieure à
+<replaceable>y_init</replaceable>.
+</para>
+<para>Si <replaceable>excursion</replaceable> est négatif alors vous obtenez <literal>LaTeX Error: Bad \line or
+\vector argument.</literal>
+</para>
+<indexterm role="cp"><primary><literal>pict2e</literal>, paquetage</primary></indexterm>
+<indexterm role="cp"><primary>graphiques, paquetages</primary></indexterm>
+<indexterm role="fn"><primary>paquetage <literal>pict2e</literal></primary></indexterm>
+<indexterm role="fn"><primary><literal>pict2e</literal>, paquetage</primary></indexterm>
+
+<indexterm role="fn"><primary>paquetage <literal>TikZ</literal></primary></indexterm>
+<indexterm role="fn"><primary><literal>TikZ</literal>, paquetage</primary></indexterm>
+
+<indexterm role="fn"><primary>paquetage <literal>PSTricks</literal></primary></indexterm>
+<indexterm role="fn"><primary><literal>PSTricks</literal>, paquetage</primary></indexterm>
+
+<indexterm role="fn"><primary>paquetage <literal>MetaPost</literal></primary></indexterm>
+<indexterm role="fn"><primary><literal>MetaPost</literal>, paquetage</primary></indexterm>
+
+<indexterm role="fn"><primary>paquetage <literal>Asymptote</literal></primary></indexterm>
+<indexterm role="fn"><primary><literal>Asymptote</literal>, paquetage</primary></indexterm>
+
+<para>De base &latex; peut seulement dessiner des lignes avec une plage
+limitées de pentes parce que ces lignes sont constituées par la
+juxtaposition de petits segments de droite issus de polices
+préfabriquées. Les deux nombres <replaceable>xpente</replaceable> et <replaceable>ypente</replaceable> prennent
+des valeurs entières de &#8722;6 jusqu&#8217;à 6. De plus ils doivent être
+premiers entre eux, de sorte que (<replaceable>xpente</replaceable>, <replaceable>ypente</replaceable>)=(2,1) est
+licite, mais pas (<replaceable>xpente</replaceable>, <replaceable>ypente</replaceable>)=(4,2) (is vous choisissez
+cette dernière forme alors au lieu de lignes vous obtiendrez des
+séquences de têtes de flèches ; la solution est de revenir à la première
+forme). Pour obtenir des lignes de pente arbitraire et plein d&#8217;autres
+formes dans un système tel que <literal>picture</literal>, voir le paquetage
+<filename>pict2e</filename> (<ulink url="https://ctan.org/pkg/pict2e">https://ctan.org/pkg/pict2e</ulink>). Une autre solution
+est d&#8217;utiliser un système graphique complet tel que TikZ, PSTricks,
+MetaPost, ou Asymptote.
</para>
-
</sect2>
<sect2 label="8.19.7" id="_005clinethickness">
<title><literal>\linethickness</literal></title>
@@ -3829,10 +5315,11 @@ quelconque, sans parler d&#8217;autres formes, voir le paquetage
<para>La commande <literal>\linethickness{<replaceable>dim</replaceable>}</literal> déclare que l&#8217;épaisseur des
lignes horizontales et verticales dans un environnement <literal>picture</literal>
-environnement vaut <replaceable>dim</replaceable>, qui doit être une longueur positive.
+vaut <replaceable>dim</replaceable>, ce qui doit être une longueur positive.
</para>
-<para><literal>\linethickness</literal> n&#8217;affecte pas l&#8217;épaisseur des lignes obliques,
-cercles, ou quarts de cercles dessinés par <literal>\oval</literal>.
+<para>Elle diffère de <literal>\thinlines</literal> et <literal>\thicklines</literal> en ce qu&#8217;elle
+n&#8217;affecte pas l&#8217;épaisseur des lignes obliques, cercles, ou quarts de
+cercles dessinés par <literal>\oval</literal>.
</para>
</sect2>
@@ -3949,16 +5436,18 @@ doivent être comprises entre &#8722;4 and +4 y compris.
</sect2>
</sect1>
-<sect1 label="8.20" id="quotation-and-quote">
+<sect1 label="8.20" id="quotation-_0026-quote">
<title><literal>quotation</literal> et <literal>quote</literal></title>
<indexterm role="fn"><primary>environnement <literal>quotation</literal></primary></indexterm>
<indexterm role="fn"><primary><literal>quotation</literal>, environnement</primary></indexterm>
+
<indexterm role="cp"><primary>citation</primary></indexterm>
<indexterm role="cp"><primary>texte cité avec renfoncement des paragraphes, affichage</primary></indexterm>
<indexterm role="cp"><primary>afficher du texte cité avec renfoncement de paragraphe</primary></indexterm>
<indexterm role="cp"><primary>renfoncement des paragraphes dans du texte cité</primary></indexterm>
<indexterm role="fn"><primary>environnement <literal>quote</literal></primary></indexterm>
<indexterm role="fn"><primary><literal>quote</literal>, environnement</primary></indexterm>
+
<indexterm role="cp"><primary>texte cité sans renfoncement des paragraphes, affichage</primary></indexterm>
<indexterm role="cp"><primary>afficher un texte cité sans renfoncement de paragraphe</primary></indexterm>
<indexterm role="cp"><primary>renfoncement des paragraphes dans un texte cité, omettre</primary></indexterm>
@@ -3977,20 +5466,20 @@ doivent être comprises entre &#8722;4 and +4 y compris.
</screen>
<para>Cite du texte.
</para>
-<para>Dans les deux environnement, les marges sont renfoncées à la fois sur la
+<para>Dans les deux environnements, les marges sont renfoncées à la fois sur la
gauche et la droite. Le texte est justifié des deux côtés sur la marge.
De même que dans le texte principal, laisser une ligne à blanc au sein
du texte produit un nouveau paragraphe.
</para>
<para>Pour comparer les deux : dans l&#8217;environnement <literal>quotation</literal>, les
paragraphes sont renfoncés de 1,5em et l&#8217;espace entre les
-paragraphe est petit, <literal>0pt plus 1pt</literal>. Dans l&#8217;environnement
-<literal>quote</literal>, les paragraphes ne sont pas renfoncés et il y a une espace
-verticale entre les paragraphes (c&#8217;est la longueur elastique
+paragraphes est petit, <literal>0pt plus 1pt</literal>. Dans l&#8217;environnement
+<literal>quote</literal>, les paragraphes ne sont pas renfoncés et il y a un espace
+vertical entre les paragraphes (c&#8217;est la longueur élastique
<literal>\parsep</literal>). Ainsi, l&#8217;environnement <literal>quotation</literal> convient mieux
-environm aux documents où les nouveaux paragraphes sont marqués par un
+aux documents où les nouveaux paragraphes sont marqués par un
renfoncement plutôt que par une séparation verticale. De plus,
-<literal>quote</literal> convient meieux pour des citations courtes ou une suite de
+<literal>quote</literal> convient mieux pour des citations courtes ou une suite de
citations courtes.
</para>
<screen>\begin{quotation}
@@ -4005,7 +5494,8 @@ citations courtes.
<indexterm role="fn"><primary>environnement <literal>tabbing</literal></primary></indexterm>
<indexterm role="fn"><primary><literal>tabbing</literal>, environnement</primary></indexterm>
-<indexterm role="cp"><primary>taquets des tabulation, utiliser</primary></indexterm>
+
+<indexterm role="cp"><primary>taquets de tabulation, utiliser</primary></indexterm>
<indexterm role="cp"><primary>aligner du texte en utilisant des taquets de tabulation</primary></indexterm>
<indexterm role="cp"><primary>alignement au moyen de tabbing</primary></indexterm>
@@ -4013,67 +5503,193 @@ citations courtes.
</para>
<screen>\begin{tabbing}
<replaceable>row1col1</replaceable> \= <replaceable>row1col2</replaceable> \= <replaceable>row1col3</replaceable> \= <replaceable>row1col4</replaceable> \\
-<replaceable>row2col1</replaceable> \&gt; \&gt; <replaceable>row2col3</replaceable> \\
+<replaceable>row2col1</replaceable> \&gt; \&gt; <replaceable>row2col3</replaceable> \\
...
\end{tabbing}
</screen>
-
-
<para>L&#8217;environnement <literal>tabbing</literal> fournit une technique pour aligner du
-texte en colonnes. Il fonctionne en réglant des taquet et en tabulant
-jusqu&#8217;à eux bien comme on le ferait sur une machine à écrire. Il
-convient le mieux pour les cas où la largeur de chaque colonnne est
-constante et connue d&#8217;avance.
+texte en colonnes. Il fonctionne en réglant des taquets et en tabulant
+jusqu&#8217;à eux à la façon dont on le faisait avec une machine à écrire
+ordinaire. Il convient le mieux pour les cas où la largeur de chaque
+colonne est constante et connue d&#8217;avance.
</para>
<para>Cet environnement peut être rompu entre plusieurs pages, contrairement à
l&#8217;environnement <literal>tabular</literal>.
</para>
-<para>Les commandes suivante peuvent être utilisée au sein d&#8217;un environnement <literal>tabbing</literal> :
+<indexterm role="cp"><primary>ligne tabulée, tabbing</primary></indexterm>
+<para>L&#8217;environnement <literal>tabbing</literal> contient une suite de <firstterm>lignes
+tabulées</firstterm>, la première ligne tabulée commence immédiatement après
+<literal>\begin{tabbing}</literal> et chaque ligne se termine par <literal>\\</literal> ou
+<literal>\kill</literal>. Il est possible de terminer la dernière ligne juste par
+<literal>\end{tabbing}</literal>, ce qui est équivalent à
+<literal>\\\end{tabbing}</literal>.
+</para>
+<indexterm role="cp"><primary>motif courant de taquets de tabulation, tabbing</primary></indexterm>
+<para>L&#8217;environnement <literal>tabbing</literal> a un <firstterm>motif courant de taquets de
+tabulation</firstterm> qui est une séquence de <replaceable>n</replaceable> taquets, avec <inlineequation><mathphrase><replaceable>n</replaceable> &gt;
+0</mathphrase></inlineequation>, ce qui crée <replaceable>n</replaceable> colonnes correspondantes. Immédiatement après
+<literal>\begin{tabbing}</literal> on a <inlineequation><mathphrase><replaceable>n</replaceable>=1</mathphrase></inlineequation>, c.-à-d. le motif
+courant de taquets contient une seul taquet, désigné comme le taquet
+N°0, et dont la position est le début de ligne, c.-à-d. que la
+première colonne commence au début de la ligne.
+</para>
+<indexterm role="cp"><primary>taquet courant, tabbing</primary></indexterm>
+<para>L&#8217;un des taquets du motif courant ayant été réglé comme le <firstterm>taquet
+courant</firstterm>, par défaut tout texte composé par la suite au sein de
+l&#8217;envionnement <literal>tabbing</literal> est composé en drapeau droit avec le fer à
+gauche sur ce taquet, c&#8217;est à dire qu&#8217;il est aligné à gauche dans la
+colonne courante. La composition est faite en mode LR.
+</para>
+<indexterm role="cp"><primary>taquet de début de ligne courant, tabbing</primary></indexterm>
+<para>Par ailleurs l&#8217;environnement <literal>tabbing</literal> a un <firstterm>taquet de début de
+ligne courant</firstterm>. Par défaut, immédiatement après <literal>\begin{tabbing}</literal>
+c&#8217;est le taquet N°0, mais cela peut être changé avec les commandes
+<literal>\+</literal> et <literal>\-</literal>. Au début de chaque ligne tabulée, le taquet
+courant est initalement égal au taquet de début de ligne courant.
+</para>
+<para>La marge de droite de l&#8217;environnement <literal>tabbing</literal> est la fin de
+ligne, c.-à-d. que la largeur de l&#8217;environnement est de longueur
+<literal>\linewidth</literal>. Il n&#8217;y a pas par défaut de taquet correspondant à la
+marge de droite, même s&#8217;il serait possible avec un peu de calcul d&#8217;en
+définir un à cette position (voir exemples ci-après).
+</para>
+<para>En ce qui concerne la marge de gauche, ou autrement dit le taquet N°0,
+contrairement à l&#8217;environnement <literal>tabular</literal>, il n&#8217;est pas nécessaire
+de mettre un <literal>\noindent</literal> devant <literal>\begin{tabbing}</literal> pour
+éviter un renfoncement : un environnement <literal>tabbing</literal> commence
+toujours un nouveau paragraphe sans renfoncement. De plus il est inutile
+d&#8217;étoiler une commande <literal>\hspace</literal> en début de ligne tabulée pour que
+l&#8217;espace soit pris en compte.
+</para>
+<para>Les commandes suivantes peuvent être utilisées au sein d&#8217;un
+environnement <literal>tabbing</literal> :
</para>
<variablelist><varlistentry><term><indexterm role="fn"><primary>\\ (tabbing)</primary></indexterm><literal>\\ (tabbing)</literal>
-</term><listitem><para>Finit une ligne.
+</term><listitem><para>Finit une ligne tabulée et la compose. Après cette commande une nouvelle
+ligne tabulée commence, et donc le taquet courant redevient le taquet
+courant de début de ligne.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\= (tabbing)</primary></indexterm><literal>\= (tabbing)</literal>
-</term><listitem><para>Règle un taquet à la position courante.
+</term><listitem><para>Règle un taquet à la position courante. La <replaceable>n</replaceable>ième commande
+<literal>\=</literal> de la ligne tabulée courante définit le taquet N°<replaceable>n</replaceable>, ou
+le redéfinit s&#8217;il avait été déjà défini dans une ligne tabulée
+précédente. Lorsque le nombre de taquets dans le motif courant est
+<inlineequation><mathphrase>(<replaceable>n</replaceable>+1)</mathphrase></inlineequation>, c&#8217;est à dire qu&#8217;on a des taquets N°0 à N°<replaceable>n</replaceable>,
+alors la <inlineequation><mathphrase>(<replaceable>n</replaceable>+1)</mathphrase></inlineequation>ième commande <literal>\=</literal> définit le taquet
+N°<inlineequation><mathphrase><replaceable>n</replaceable>+1</mathphrase></inlineequation>, ce qui porte le nombre de taquets à
+<inlineequation><mathphrase><replaceable>n</replaceable>+2</mathphrase></inlineequation>. La position des taquets peut être définie avec plus de
+liberté que ce qui se passait avec un machine à écrire ordinaire. En
+effet il est possible de définir à la même position deux taquets de
+numéros N°<replaceable>n</replaceable> et N°<replaceable>m</replaceable> distincts, voire de faire en sorte que
+les taquets N°<replaceable>n</replaceable> et N°<replaceable>m</replaceable>, avec <inlineequation><mathphrase><replaceable>n</replaceable>&lt;<replaceable>m</replaceable></mathphrase></inlineequation>, soient
+à des positions telles que le taquet N°<replaceable>m</replaceable> soit avant le taquet
+N°<replaceable>n</replaceable>.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\&gt; (tabbing)</primary></indexterm><literal>\&gt; (tabbing)</literal>
</term><listitem><indexterm role="fn"><primary>\&gt;</primary></indexterm>
-<para>Avance au taquet suivant.
+<para>Change le taquet courant au taquet suivant dans l&#8217;ordre logique,
+c.-à-d. si le taquet courant est le taquet N°<replaceable>n</replaceable>, alors, en
+supposant qu&#8217;il y ait au moins <inlineequation><mathphrase><replaceable>n</replaceable>+2</mathphrase></inlineequation> taquets définis, on
+passe au taquets N°<inlineequation><mathphrase><replaceable>n</replaceable>+1</mathphrase></inlineequation>, sinon cette commande provoque une
+erreur.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\&lt;</primary></indexterm><literal>\&lt;</literal>
-</term><listitem><para>Place le texte qui suit à la gauche de la marge locale (sans changer
-cette marge). Ne peut être utilisé qu&#8217;au début d&#8217;une ligne.
+</term><listitem><para>Change le taquet courant au taquet précédent dans l&#8217;ordre logique. Cette
+commande ne peut être utilisée qu&#8217;au début d&#8217;une ligne tabulée, et que
+lorsque le taquet de début de ligne courant est le taquet N°<replaceable>n</replaceable> avec
+<inlineequation><mathphrase><replaceable>n</replaceable>&gt;0</mathphrase></inlineequation>. Le taquet courant devient alors le taquet
+N°<inlineequation><mathphrase><replaceable>n</replaceable>-1</mathphrase></inlineequation>.
+</para>
+<para>Il est en fait possible d&#8217;avoir <replaceable>m</replaceable> commandes <literal>\&lt;</literal> consécutives
+à condition que <inlineequation><mathphrase><replaceable>m</replaceable>&#8804;<replaceable>n</replaceable></mathphrase></inlineequation>, le taquet courant devient
+alors le taquet N°<inlineequation><mathphrase>(<replaceable>n</replaceable>-<replaceable>m</replaceable>)</mathphrase></inlineequation>. Si par contre
+<inlineequation><mathphrase><replaceable>m</replaceable>&gt;<replaceable>n</replaceable></mathphrase></inlineequation>, alors la <inlineequation><mathphrase><replaceable>n</replaceable>+1</mathphrase></inlineequation> commande <literal>\&lt;</literal>
+provoque une erreur.
+</para>
+<para>Il est possible, même si c&#8217;est absurde, d&#8217;avoir ensuite des commandes
+<literal>\&gt;</literal> qui défont ce qu&#8217;on fait les commandes <literal>\&lt;</literal>. Ainsi en
+supposant qu&#8217;au début d&#8217;une ligne tabulée le taquet de début de ligne
+courant soit le taquet N°2, faire commencer la ligne par <literal>\&lt;\&lt;\&gt;\&gt;</literal>
+n&#8217;a aucun effet. Par contre, <literal>\&lt;\&lt;\&lt;\&gt;\&gt;\&gt;</literal> provoquera une erreur,
+parce que la troisième commande <literal>\&lt;</literal> est illicite. Dans les mêmes
+conditions faire <literal>\&lt;\&gt;\&lt;\&gt;</literal> provoque également une erreur, car la
+seconde commande <literal>\&lt;</literal> n&#8217;est pas consécutive de la première, elle
+n&#8217;est donc pas, au sens où on l&#8217;entend, utilisée en début de ligne.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\+</primary></indexterm><literal>\+</literal>
-</term><listitem><para>Déplace la marge de gauche d&#8217;un taquet vers la droite pour la ligne
-suivante et toutes celles qui suivent.
+</term><listitem><para>Change le taquet de début de ligne courant au taquet suivant dans
+l&#8217;ordre logique pour la ligne tabulée suivante, et toutes celles qui
+suivent tant qu&#8217;une autre commande ne vient pas le modifier. La notion
+de taquet suivant dans l&#8217;ordre logique suit le même principe que pour la
+commande <literal>\&gt;</literal>, c&#8217;est à dire que s&#8217;il n&#8217;y a que <inlineequation><mathphrase><replaceable>n</replaceable>+1</mathphrase></inlineequation>
+taquets défini, et que le taquet de début de ligne courant est le taquet
+N°<replaceable>n</replaceable>, alors cette commande provoque une erreur. La commande
+<literal>\+</literal> peut être invoquée n&#8217;importe où dans la ligne tabulée, et on
+peut avoir plusieurs commandes <literal>\+</literal> au sein de la même ligne, du
+moment que pour chacune d&#8217;elle un nombre suffisant de taquets est déjà
+défini. Par exemple le code suivant provoque une erreur parce que bien
+qu&#8217;à la fin de la première on ait trois taquets définis, au moment où la
+commande <literal>\+</literal> est invoquée le nombre de taquets définis ne vaut que
+1, on ne peut donc pas passer du taquet N°0 au taquet N°1 :
+</para><screen>\begin{tabbing}
+Vive \+\=la \=France\\
+Vive \&gt;la\&gt;République\\
+\end{tabbing}
+</screen><para>En revanche le code suivant fonctionne, car lorsque la commande
+<literal>\+</literal> est passée on a trois taquets définis, les taquets N°0 à 2, on
+peut donc passer du taquet N°0 au taquet N°1.
+</para><screen>\begin{tabbing}
+Vive \=la \=France\+\\
+Vive \&gt;la\&gt;République\\
+\end{tabbing}
+</screen><para>C&#8217;est pourquoi l&#8217;usage est que la ou les commandes <literal>\+</literal> sont
+toujours invoquées juste avant la fin de ligne <literal>\\</literal> ou <literal>\kill</literal>.
</para>
+<para>Il est possible, même si cela est absurde, d&#8217;avoir sur la même ligne à
+la fois des commandes <literal>\+</literal> et <literal>\-</literal> s&#8217;annulant l&#8217;une l&#8217;autre,
+du moment qu&#8217;aucune d&#8217;elle ne fasse passer sur un taquet non défini.
+</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\-</primary></indexterm><literal>\-</literal>
-</term><listitem><para>Déplace la marge de gauche d&#8217;un taquet vers la gauche pour la ligne
-suivante et toutes celles qui suivent.
+</term><listitem><para>Change le taquet de début de ligne courant au taquet précédent dans
+l&#8217;ordre logique pour la ligne tabulée suivante, et toutes celles qui
+suivent tant qu&#8217;une autre commande ne vient pas le modifier. C&#8217;est à
+dire que si le taquet de début de ligne courant est le taquet N°<replaceable>n</replaceable>,
+et qu&#8217;on a <replaceable>m</replaceable> commandes <literal>\-</literal> avec <inlineequation><mathphrase><replaceable>m</replaceable>&#8805;<replaceable>n</replaceable></mathphrase></inlineequation>,
+alors le taquet de début de ligne courant de la ligne suivante devient
+le taquet N°<inlineequation><mathphrase><replaceable>n</replaceable>-<replaceable>m</replaceable></mathphrase></inlineequation>. Par contre, si
+<inlineequation><mathphrase><replaceable>m</replaceable>&gt;<replaceable>n</replaceable></mathphrase></inlineequation>, alors la <inlineequation><mathphrase>(<replaceable>n</replaceable>+1)</mathphrase></inlineequation>ième commande
+<literal>\+</literal> provoque une erreur.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\' (tabbing)</primary></indexterm><literal>\' (tabbing)</literal>
</term><listitem><para>Déplace tout ce que vous avez tapé jusqu&#8217;alors dans la colonne courante,
c.-à-d. tout ce qui suit la plus récente commande <literal>\&gt;</literal>,
-<literal>\&lt;</literal>, <literal>\'</literal>, <literal>\\</literal>, ou <literal>\kill</literal>, à la droite de la
-colonne précédente, aligné à droite sur le taquet de la colonne
-courante.
+<literal>\&lt;</literal>, <literal>\'</literal>, <literal>\\</literal>, ou <literal>\kill</literal>, aligné à droite dans
+la colonne précédente, le fer à droite étant espacé du taquet courant
+d&#8217;une longueur <literal>\tabbingsep</literal>. Voir aussi <literal>\`</literal>.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\` (tabbing)</primary></indexterm><literal>\` (tabbing)</literal>
-</term><listitem><para>Vous perme de placer du texte justifié à droite sur n&#8217;importe quel
-taquet, y compris le taquet 0. Toutefois, ne peut pas placer du texte à
-la droite de la dernière colonne parce qu&#8217;il n&#8217;y a pas de taquet à cet
-endroit. La commande <literal>\`</literal> déplace tout le texte qui la suit,
-jusqu&#8217;à la commande <literal>\\</literal> ou <literal>\end{tabbing}</literal> qui termine la
-ligne.
-</para>
+</term><listitem><para>Vous permet de placer du texte justifié à droite en face de n&#8217;importe
+quel taquet, y compris le taquet 0. Les commandes <literal>\`</literal> et <literal>\'</literal>
+alignent toutes deux le texte à droite, toutefois elles se distinguent
+fortement par deux aspects :
+</para><itemizedlist><listitem><para>Tout d&#8217;abord le texte qui est déplacé est, dans le cas de <literal>\`</literal>, le
+texte qui suit la commande <literal>\`</literal> et qui va jusqu&#8217;à la fin de la
+ligne tabulée, c.-à-d. jusqu&#8217;à <literal>\\</literal> ou <literal>\end{tabbing}</literal>.
+Il ne doit y avoir aucune commande <literal>\&gt;</literal> ou <literal>\'</literal> entre le
+<literal>\`</literal> et la commande <literal>\\</literal> ou <literal>\end{tabbing}</literal> qui termine
+la ligne. Dans le cas de la commande <literal>\'</literal> au contraire, c&#8217;est le
+texte qui précède la commande <literal>\'</literal>.
+</para></listitem><listitem><para>Par ailleurs, avec <literal>\'</literal> l&#8217;alignement se fait sur un taquet et avec
+un espacement relatif de <literal>\tabbingspace</literal>, alors qu&#8217;avec <literal>\`</literal>
+l&#8217;alignement se fait sur la marge de droite et sans espacement relatif.
+</para></listitem></itemizedlist>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\a (tabbing)</primary></indexterm><literal>\a (tabbing)</literal>
-</term><listitem><indexterm role="fn"><primary>\a' (acute accent in tabbing)</primary></indexterm>
-<indexterm role="fn"><primary>\a` (grave accent in tabbing)</primary></indexterm>
-<indexterm role="fn"><primary>\a= (macron accent in tabbing)</primary></indexterm>
+</term><listitem><indexterm role="fn"><primary>\a' (aigu, accent dans tabbing)</primary></indexterm>
+<indexterm role="fn"><primary>\a` (grave, accent dans tabbing)</primary></indexterm>
+<indexterm role="fn"><primary>\a= (macron, accent dans tabbing)</primary></indexterm>
<para>Dans un environnement <literal>tabbing</literal>, les commandes <literal>\=</literal>, <literal>\'</literal>
et <literal>\`</literal> ne produisent pas d&#8217;accents comme d&#8217;habitude
-(voir <link linkend="Accents">Accents</link>). À leur place, on utilise les commandes <literal>\a=</literal>,
+(see <link linkend="Accents">Accents</link>). À leur place, on utilise les commandes <literal>\a=</literal>,
<literal>\a'</literal> et <literal>\a`</literal>.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\kill</primary></indexterm><literal>\kill</literal>
@@ -4088,44 +5704,131 @@ produire une sortie. L&#8217;effet de toute commande <literal>\=</literal>, <lit
<literal>\pushtabs</literal>.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\pushtabs</primary></indexterm><literal>\pushtabs</literal>
-</term><listitem><para>Sauvegarde positions courantes de tous les taquets. C&#8217;est utile pour
-changer temporairement les positions de taquets au milieu d&#8217;un
-environnement <literal>tabbing</literal>.
-</para>
+</term><listitem><para>Sauvegarde dans une pile dédiée à cet effet le motif courant de taquets
+de tabulation. C&#8217;est utile pour changer temporairement les positions de
+taquets au milieu d&#8217;un environnement <literal>tabbing</literal>. Après un
+<literal>\pushtabs</literal>, on a un nouveau motif vierge, c.-à-d. ne contenant
+qu&#8217;un seul taquet, le taquet N°0 à la position de début de ligne. Pour
+toute commande <literal>\pushtabs</literal> il doit y avoir une commande
+<literal>\poptabs</literal> avant la fin de l&#8217;environnement, c&#8217;est à dire que la
+pile doit être explicitement vidée avant le <literal>end{tabbing}</literal>.
+</para>
+
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\tabbingsep</primary></indexterm><literal>\tabbingsep</literal>
-</term><listitem><para>Distance à la gauche d&#8217;un taquet déplacé par <literal>\'</literal>.
+</term><listitem><para>Distance du texte déplacé par <literal>\'</literal> à la gauche du taquet courant.
</para>
</listitem></varlistentry></variablelist>
-<para>Cet exemple compose un fonction en Pascal function dans un format
-traditionnel :
-</para>
-<screen>\begin{tabbing}
-function \= fact(n : integer) : integer;\\
- \&gt; begin \= \+ \\
- \&gt; if \= n $&gt;$ 1 then \+ \\
- fact := n * fact(n-1) \- \\
- else \+ \\
- fact := 1; \-\- \\
+<para>Il est à noter que les espaces en début de ligne, où après <literal>\=</literal>,
+<literal>\&gt;</literal> ou <literal>\&lt;</literal> sont gobés, qu&#8217;il s&#8217;agisse d&#8217;espaces produits par
+la macro <literal>\space</literal> ou par le caractère espace. Par contre l&#8217;espace
+produit par la le caractère de contrôle espace (<literal>\ <!-- /@w --></literal>, c.-à-d.
+une contr&#8217;oblique suivie d&#8217;un caractère espace) n&#8217;est pas gobé.
+</para>
+<para>Cet exemple compose un fonction en Pascal dans un format traditionnel :
+</para>
+<screen>{\ttfamily
+\begin{tabbing}
+function \= fact(n : integer) : integer;\+\\
+ begin \=\+\\
+ if \= n $&gt;$ 1 then\+\\
+ fact := n * fact(n-1)\-\\
+ else\+\\
+ fact := 1;\-\-\\
end;\\
-\end{tabbing}
-</screen>
+\end{tabbing}}
+</screen>
+<para>Le résultat ressemble à cela :
+</para><screen>function fact(n : integer) : integer;
+ begin
+ if n &gt; 1 then
+ fact := n * fact(n-1);
+ else
+ fact := 1;
+ end;
+</screen>
+<indexterm role="fn"><primary>paquetage <literal>algorithm2e</literal></primary></indexterm>
+<indexterm role="fn"><primary><literal>algorithm2e</literal>, paquetage</primary></indexterm>
+
+<indexterm role="fn"><primary>paquetage <literal>listings</literal></primary></indexterm>
+<indexterm role="fn"><primary><literal>listings</literal>, paquetage</primary></indexterm>
+
+<para>Ceci n&#8217;était qu&#8217;un exemple illustrant <literal>tabbing</literal>, pour formatter du
+code considérez plutôt les paquetages <filename>algorithm2e</filename> pour du
+pseudo-code, et <literal>listings</literal> pour du vrai code.
+</para>
+<para>Voici un autre exemple où le taquet N°2 est entre le taquet N°0 et le
+taquet N°1 :
+</para>
+<screen>{\ttfamily
+\begin{tabbing}
+ 12\=34\=\kill
+ 12345678\=9\\
+ 1\&gt;2\&gt;3\\
+\end{tabbing}}
+</screen>
+<para>Le résultat ressemble à cela :
+</para><screen>123456789
+1 3 2
+</screen>
+<para>Voici un exemple où les taquets N°0 et N°1 sont confondus, ainsi que les
+taquets N°2 et N°3, ce qui permet de superposer le texte aux taquets
+impairs sur celui au taquets pairs, par exemple pour souligner ou barrer
+comme avec une machine à écrire, en superposant un caractère <literal>_</literal> ou
+un caractère <literal>&#8722;</literal>. Evidemment ce n&#8217;est qu&#8217;une illustration de
+la flexivilité des taquets, et non une méthode convenable pour souligner
+ou barrer un mot, d&#8217;un part parce que <literal>tabbing</literal> en soi commençant
+un nouveau paragraphe ne permet pas d&#8217;agir sur un seul mot, et d&#8217;autre
+part, parce que le paquetage <literal>soul</literal> fait cela beaucoup mieux.
+<indexterm role="fn"><primary>paquetage <literal>soul</literal></primary></indexterm>
+<indexterm role="fn"><primary><literal>soul</literal>, paquetage</primary></indexterm>
+</para>
+
+<screen>{\ttfamily
+\begin{tabbing}
+ \=souligne \=\=\kill
+ soulign\a'e\&gt;
+ \_{}\_{}\_{}\_{}\_{}\_{}\_{}\_{}\&gt;
+ barr\a'e\&gt;{--}{--}{--}{--}{--}{--}\\
+\end{tabbing}}
+</screen>
+
+<para>Finalement, voici un exemple où on a placé le taquet N°5 décalé d&#8217;une
+longueur <literal>\tabbingsep</literal> à droite de la marge de droite.
+</para>
+<screen>{\ttfamily
+\begin{tabbing}
+\hspace{1cm}\=\hspace{1cm}\=\hspace{1cm}\=\hspace{1cm}\=
+ \hspace{\dimexpr\linewidth-4cm+\tabbingsep}\=\kill
+1\&gt;2\&gt;X\'3\&gt;4\&gt;5\&gt;\a`a gauche de de la marge de droite
+ avec \textbackslash'\'\\
+1\&gt;2\&gt;X\'3\&gt;4\&gt;5\`\a`a gauche de de la marge de droite
+ avec \textbackslash`\\
+\end{tabbing}}
+</screen>
+<para>Le résultat ressemble à cela :
+</para>
+<screen><!-- 012345678901234567890123456789012345678901234567890123456789 -->
+1 2 X 3 4 5 à gauche de la marge de droite avec \'
+1 2 X 3 4 5 à gauche de la marge de droite avec \`
+</screen>
</sect1>
<sect1 label="8.22" id="table">
<title><literal>table</literal></title>
<indexterm role="fn"><primary>environnement <literal>table</literal></primary></indexterm>
<indexterm role="fn"><primary><literal>table</literal>, environnement</primary></indexterm>
+
<indexterm role="cp"><primary>tableaux, créer</primary></indexterm>
<indexterm role="cp"><primary>créer des tableaux</primary></indexterm>
<para>Synopsis :
</para>
<screen> \begin{table}[<replaceable>placement</replaceable>]
- <replaceable>corps-du-talbeau</replaceable>
+ <replaceable>corps-du-tableau</replaceable>
\caption[<replaceable>titreldt</replaceable>]{<replaceable>titre</replaceable>}
\end{table}
</screen>
-<para>Une classe de flottants (voir <link linkend="Floats">Floats</link>). Parce qu&#8217;ils ne peuvent pas
+<para>Une classe de flottants (see <link linkend="Floats">Floats</link>). Parce qu&#8217;ils ne peuvent pas
être coupés à cheval sur plusieurs pages, il ne sont pas composés en
séquence avec le texte normale, mais à la place sont « flottés » vers un
endroit convenable, tel que le sommet d&#8217;une page suivante.
@@ -4138,12 +5841,12 @@ l&#8217;algorithme de placement des flottants, voir <link linkend="Floats">Float
etc.
</para>
<para>L&#8217;étiquette est optionnelle ; elle est utilisée pour les double renvois
-(voir <link linkend="Cross-references">Cross references</link>).
+(see <link linkend="Cross-references">Cross references</link>).
<indexterm role="fn"><primary>\caption</primary></indexterm>
La commande <literal>\caption</literal> spécifie la légende <replaceable>texte</replaceable> pour la
figure. La légende est numérotée par défaut. Si <replaceable>titreldt</replaceable> est
-présent, il est utilisé dans la liste des talbeaux au lieu de <replaceable>titre</replaceable>
-(voir <link linkend="Tables-of-contents">Tables of contents</link>).
+présent, il est utilisé dans la liste des tableaux au lieu de <replaceable>titre</replaceable>
+(see <link linkend="Table-of-contents-etc_002e">Table of contents etc.</link>).
</para>
<screen>\begin{table}[b]
\centering
@@ -4162,6 +5865,7 @@ présent, il est utilisé dans la liste des talbeaux au lieu de <replaceable>tit
<title><literal>tabular</literal></title>
<indexterm role="fn"><primary>environnement <literal>tabular</literal></primary></indexterm>
<indexterm role="fn"><primary><literal>tabular</literal>, environnement</primary></indexterm>
+
<indexterm role="cp"><primary>lignes dans des tableaux</primary></indexterm>
<indexterm role="cp"><primary>aligner du texte dans des tableaux</primary></indexterm>
@@ -4193,9 +5897,9 @@ beaucoup des caractéristiques.
</screen>
<para>Le format vertical de deux colonnes alignées à gauche, avec une barre
verticales entre elles, est spécifié par l&#8217;argument <literal>{l|l}</literal> de <literal>tabular</literal>.
-<indexterm role="fn"><primary>&amp;</primary></indexterm>
+<indexterm role="fn"><primary>&amp; pour cellules de tableau</primary></indexterm>
Les colonnes sont séparées avec une esperluette <literal>&amp;</literal>. On crée un
-filet horizontal entre deux ligne avec <literal>\hline</literal>.
+filet horizontal entre deux lignes avec <literal>\hline</literal>.
<indexterm role="fn"><primary>\\ pour <literal>tabular</literal></primary></indexterm>
La fin de chaque ligne est marquée avec une
double-contr&#8217;oblique <literal>\\</literal>. Cette <literal>\\</literal> est optionnelle après
@@ -4249,7 +5953,7 @@ de l&#8217;environnement.
</listitem></varlistentry><varlistentry><term><literal>@{<replaceable>texte ou espace</replaceable>}</literal>
</term><listitem><para>Ceci insère <replaceable>texte ou espace</replaceable> à cette position dans chaque ligne. Le
matériel <replaceable>texte ou espace</replaceable> est composé en mode LR. Ce texte est
-fragile (voir <link linkend="_005cprotect">\protect</link>).
+fragile (see <link linkend="_005cprotect">\protect</link>).
</para>
<para>Ce spécificateur est optionnel : à moins que vous mettiez dans votre
propre @-expression alors les classes <literal>book</literal>, <literal>article</literal> et
@@ -4319,8 +6023,8 @@ sont pas permis au sein d&#8217;une telle cellule, sauf à l&#8217;intérieur d&
environnement comme <literal>minipage</literal>, <literal>array</literal>, ou <literal>tabular</literal>,
ou à l&#8217;intérieur d&#8217;une <literal>\parbox</literal> explicite, ou dans la portée d&#8217;une
déclaration <literal>\centering</literal>, <literal>\raggedright</literal>, ou
-<literal>\raggedleft</literal> (quand elles sont utilisée au sein d&#8217;une cellule de
-colonne en <literal>p</literal> ces déclaration doivent apparaître entre accolade,
+<literal>\raggedleft</literal> (quand elles sont utilisées au sein d&#8217;une cellule de
+colonne en <literal>p</literal> ces déclarations doivent apparaître entre accolades,
comme dans <literal>{\centering .. \\ ..}</literal>. Sans quoi &latex; prendra la
double contr&#8217;oblique comme une fin de ligne.
</para>
@@ -4344,7 +6048,7 @@ peut la changer comme dans
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\arraystretch</primary></indexterm><literal>\arraystretch</literal>
</term><listitem><para>Un facteur par lequel l&#8217;espacement entre les lignes au sein des
-environnement <literal>tabular</literal> et <literal>array</literal> est multiplié. La valeur
+environnements <literal>tabular</literal> et <literal>array</literal> est multiplié. La valeur
par défaut est &#8216;<literal>1</literal>&#8217; pour aucune dilatation/contraction. On peut la
changer comme dans <literal>\renewcommand{\arraystretch}{1.2}</literal>.
</para>
@@ -4504,6 +6208,7 @@ utilisée dans une expression <literal>@{&#8230;}</literal>.
<indexterm role="fn"><primary>environnement <literal>thebibliography</literal></primary></indexterm>
<indexterm role="fn"><primary><literal>thebibliography</literal>, environnement</primary></indexterm>
+
<indexterm role="cp"><primary>bibliography, creating (manually)</primary></indexterm>
<para>Synopsis :
@@ -4516,14 +6221,31 @@ utilisée dans une expression <literal>@{&#8230;}</literal>.
<para>L&#8217;environnement <literal>thebibliography</literal> produit une bibliographie ou une
liste de références.
</para>
-<para>Dans la classe <literal>article</literal>, cette liste de références est intitulée
-« Réferences » ; dans la classe <literal>report</literal>, elle est intitulée
-« Bibliographie ». Vous pouvez changer le titre (dans les classes standardes)
-en redéfinissant la commande <literal>\refname</literal>. Par exemple, cela
-l&#8217;élimine complètement :
+<para>Dans la classe <literal>article</literal>, cette liste de références est intitulée
+&#8216;<literal>Références</literal>&#8217; et ce titre est stocké dans la macro <literal>\refname</literal> ;
+dans la classe <literal>report</literal>, elle est intitulée &#8216;<literal>Bibliographie</literal>&#8217; et
+ce titre est stocké dans la macro <literal>\bibname</literal>.
+</para>
+<para>Vous pouvez changer le titre en redéfinissant celle des commandes
+<literal>\refname</literal> ou <literal>\bibname</literal> qui est applicable selon la classe :
+</para>
+<itemizedlist><listitem><indexterm role="fn"><primary>\bibname</primary></indexterm>
+<para>Pour les classes standardes dont le niveau le plus élevé de rubricage
+est <literal>\chapter</literal> le titre est dans la macro <literal>\bibname</literal>, par
+exemple les classes <filename>book</filename> et <filename>report</filename> tombent dans cette
+catégorie.
+</para></listitem><listitem><indexterm role="fn"><primary>\refname</primary></indexterm>
+<para>Pour les classes standardes dont le niveau le plus élevé de rubricage
+est <literal>\section</literal> le titre est dans la macro <literal>\refname</literal>, par
+exemple la classe <filename>article</filename> tombe dans cette catégorie.
+</para></listitem></itemizedlist>
+<indexterm role="fn"><primary>paquetage <literal>babel</literal></primary></indexterm>
+<indexterm role="fn"><primary><literal>babel</literal>, paquetage</primary></indexterm>
+
+<para>Typiquement il n&#8217;est ni nécessaire ni désirable de redéfinir directement
+<literal>\refname</literal> ou <literal>\bibname</literal> ; les paquetages linguistiques comme
+<filename>babel</filename> s&#8217;en chargent.
</para>
-<screen>\renewcommand{\refname}{}
-</screen>
<para>L&#8217;argument obligatoire <replaceable>étiquette-la-plus-large</replaceable> est un texte qui,
lorsqu&#8217;il est composé, est aussi large que la plus large des étiquettes
d&#8217;article produit pas les commandes <literal>\bibitem</literal>. C&#8217;est typiquement
@@ -4555,7 +6277,7 @@ entrée contient les <replaceable>étiquette</replaceable> et <replaceable>clef_
considéré. Lorsque le fichier <filename>.aux</filename> est lu par la commande
<literal>\begin{document}</literal>, l&#8217;<replaceable>étiquette</replaceable> de l&#8217;article est associée à
sa <replaceable>clef_de_cite</replaceable>, ce qui a pour effet que toute référence à
-<replaceable>clef_de_cite</replaceable> avec une commande <literal>\cite</literal> (voir <link linkend="_005ccite">\cite</link>)
+<replaceable>clef_de_cite</replaceable> avec une commande <literal>\cite</literal> (see <link linkend="_005ccite">\cite</link>)
produit l&#8217;<replaceable>étiquette</replaceable> associée.
</para>
@@ -4570,7 +6292,7 @@ produit l&#8217;<replaceable>étiquette</replaceable> associée.
<screen>\cite[<replaceable>subcite</replaceable>]{<replaceable>clefs</replaceable>}
</screen>
<para>L&#8217;argument <replaceable>clefs</replaceable> est une liste d&#8217;une ou plus de clefs de
-références bibliographiques (voir <link linkend="_005cbibitem">\bibitem</link>), séparées par des
+références bibliographiques (see <link linkend="_005cbibitem">\bibitem</link>), séparées par des
virgules. Cette commande génère une référence bibliographique au sein du
textes contenant les étiquettes associées aux clefs contenues dans
<replaceable>clefs</replaceable> par les entrées respectives au sein du fichier <filename>.aux</filename>.
@@ -4608,7 +6330,7 @@ bibliograhique dans le fichier <filename>.aux</filename>.
fortement recommandé si vous avez besoin d&#8217;une bibliographie de plus
d&#8217;un ou deux titre) pour mainteninr votre bibliographie, vous n&#8217;utilisez
pas l&#8217;environnement <literal>thebibliography</literal>
-(voir <link linkend="thebibliography">thebibliography</link>). Au lieu de cela, vous incluez les lignes :
+(see <link linkend="thebibliography">thebibliography</link>). Au lieu de cela, vous incluez les lignes :
</para>
<screen>\bibliographystyle{<replaceable>stylebib</replaceable>}
\bibliography{<replaceable>ficbib1</replaceable>,<replaceable>ficbib2</replaceable>}
@@ -4650,6 +6372,7 @@ ou <literal>\nocite</literal> sont listées dans la bibliographie.
<indexterm role="fn"><primary>environnement <literal>theorem</literal></primary></indexterm>
<indexterm role="fn"><primary><literal>theorem</literal>, environnement</primary></indexterm>
+
<indexterm role="cp"><primary>théorèmes, composition des</primary></indexterm>
<para>Synopsis :
@@ -4660,7 +6383,7 @@ ou <literal>\nocite</literal> sont listées dans la bibliographie.
</screen>
<para>L&#8217;environnement <literal>theorem</literal> produit « Théorème <replaceable>n</replaceable> » en gras
suivi de <replaceable>texte-théorème</replaceable>, où les possibilité de numérotation pour
-<replaceable>n</replaceable> sont décrites par <literal>\newtheorem</literal> (voir <link linkend="_005cnewtheorem">\newtheorem</link>).
+<replaceable>n</replaceable> sont décrites par <literal>\newtheorem</literal> (see <link linkend="_005cnewtheorem">\newtheorem</link>).
</para>
</sect1>
@@ -4669,6 +6392,7 @@ suivi de <replaceable>texte-théorème</replaceable>, où les possibilité de nu
<indexterm role="fn"><primary>environnement <literal>titlepage</literal></primary></indexterm>
<indexterm role="fn"><primary><literal>titlepage</literal>, environnement</primary></indexterm>
+
<indexterm role="cp"><primary>fabriquer une page de titre</primary></indexterm>
<indexterm role="cp"><primary>pages de titre, création</primary></indexterm>
@@ -4682,9 +6406,9 @@ suivi de <replaceable>texte-théorème</replaceable>, où les possibilité de nu
une page sur laquelle ne sont inscrit aucun numéro de page ou libellé de
rubrique. Il entraîne aussi que la page suivante a le numéro un. Le
formatage de la page de titre vous est laissé. La commande <literal>\today</literal>
-peut être utile sur les pages de titre (voir <link linkend="_005ctoday">\today</link>).
+peut être utile sur les pages de titre (see <link linkend="_005ctoday">\today</link>).
</para>
-<para>Vous pouvez utiliser la commande <literal>\maketitle</literal> (voir <link linkend="_005cmaketitle">\maketitle</link>)
+<para>Vous pouvez utiliser la commande <literal>\maketitle</literal> (see <link linkend="_005cmaketitle">\maketitle</link>)
pour produire une page de titre standarde sans utiliser l&#8217;environnement
<literal>titlepage</literal>.
</para>
@@ -4695,6 +6419,7 @@ pour produire une page de titre standarde sans utiliser l&#8217;environnement
<indexterm role="fn"><primary>environnement <literal>verbatim</literal></primary></indexterm>
<indexterm role="fn"><primary><literal>verbatim</literal>, environnement</primary></indexterm>
+
<indexterm role="cp"><primary>texte verbatim</primary></indexterm>
<indexterm role="cp"><primary>simuler du texte tapuscrit</primary></indexterm>
<indexterm role="cp"><primary>texte tapuscrit, simulation de</primary></indexterm>
@@ -4713,8 +6438,8 @@ par exemple le caractère <literal>\</literal> produit &#8216;<literal>\</litera
fait de &latex; une machine à écrire, c.-à-d. que le retour chariot
et les blancs y ont un tel effet.
</para>
-<para>L&#8217;environnement <literal>verbatim</literal> utilise une police de type machine à
-écrire à chasse fixe (<literal>\tt</literal>).
+<para>L&#8217;environnement <literal>verbatim</literal> utilise une police de type tapuscrit
+(encore appelé « machine à écrire ») à chasse fixe (<literal>\tt</literal>).
</para>
<sect2 label="8.27.1" id="_005cverb">
@@ -4746,6 +6471,7 @@ sont tapés avec un caractère « espace visible ».
<title><literal>verse</literal></title>
<indexterm role="fn"><primary>environnement <literal>verse</literal></primary></indexterm>
<indexterm role="fn"><primary><literal>verse</literal>, environnement</primary></indexterm>
+
<indexterm role="cp"><primary>poésie, un environnement pour la</primary></indexterm>
<para>Synopsis :
@@ -4815,7 +6541,7 @@ environnement <literal>tabular</literal> ou <literal>array</literal>.
<para>Dans des circonstances ordinaires (par ex. en dehors d&#8217;une colonne
spécifiée par <literal>p{...}</literal> dans un environnement <literal>tabular</literal>) la
commande <literal>\newline</literal> est un synonyme de <literal>\\</literal>
-(voir <link linkend="_005cnewline">\newline</link>).
+(see <link linkend="_005cnewline">\newline</link>).
</para>
<para>En plus de commencer une nouvelle ligne, la forme étoilée <literal>\\*</literal> dit
à &latex; de ne pas commencer une nouvelle page entre les deux lignes,
@@ -4850,7 +6576,7 @@ ligne.
<indexterm role="cp"><primary>saut de ligne</primary></indexterm>
<para>Dans du texte ordinaire ceci est équivalent à une double-contr&#8217;oblique
-(voir <link linkend="_005c_005c">\\</link>) ; cela rompt la ligne, sans dilatation du texte le
+(see <link linkend="_005c_005c">\\</link>) ; cela rompt la ligne, sans dilatation du texte le
précéndent.
</para>
<para>Au sein d&#8217;un environnement <literal>tabular</literal> ou <literal>array</literal>, dans une
@@ -4901,7 +6627,7 @@ dans les cas où ne suffisent ni le contrôle standard de la césure fait
l&#8217;algorithme de césure de &tex; et les règles de césures données par les
paquetages de gestion linguistiques, ni les moyens de contrôle
explicites offerts par les commandes <literal>\hyphenation</literal>
-(voir <link linkend="_005chyphenation">\hyphenation</link>) et <literal>\-</literal> (voir <link linkend="_005c_002d-_0028hyphenation_0029">\- (césure
+(see <link linkend="_005chyphenation">\hyphenation</link>) et <literal>\-</literal> (see <link linkend="_005c_002d-_0028hyphenation_0029">\- (césure
à gré)</link>).
</para>
<para><literal>\discretionary</literal> indique qu&#8217;un saut de ligne est possible à cet
@@ -4951,7 +6677,7 @@ effet que &tex; fait le difficile à propos des saut de ligne. Ceci
d&#8217;occasionnellement une boîte trop pleine (&#8216;<literal>overfull \hbox</literal>&#8217;).
</para>
<para>Cette commande annule l&#8217;effet d&#8217;une commande <literal>\sloppy</literal> précédente
-(voir <link linkend="_005csloppy">\sloppy</link>).
+(see <link linkend="_005csloppy">\sloppy</link>).
</para>
</sect1>
@@ -4962,7 +6688,7 @@ d&#8217;occasionnellement une boîte trop pleine (&#8216;<literal>overfull \hbox
difficile à propos des sauts de ligne. Ceci evite les boîtes trop pleines,
au prix d&#8217;un espacement lâche entre les mots.
</para>
-<para>L&#8217;effet dure jusqu&#8217;à la prochaine commande <literal>\fussy</literal> (voir <link linkend="_005cfussy">\fussy</link>).
+<para>L&#8217;effet dure jusqu&#8217;à la prochaine commande <literal>\fussy</literal> (see <link linkend="_005cfussy">\fussy</link>).
</para>
</sect1>
@@ -5024,11 +6750,15 @@ désirer influencer les sauts.
</para>
-<sect1 label="10.1" id="_005ccleardoublepage">
-<title><literal>\cleardoublepage</literal></title>
+<sect1 label="10.1" id="_005cclearpage-_0026-_005ccleardoublepage">
+<title><literal>\clearpage</literal> &amp; <literal>\cleardoublepage</literal></title>
+<!-- xx Revoir la traduction -->
<indexterm role="fn"><primary>\cleardoublepage</primary></indexterm>
<indexterm role="cp"><primary>commencer une page de droite</primary></indexterm>
+<indexterm role="fn"><primary>\clearpage</primary></indexterm>
+<indexterm role="cp"><primary>débourrer les flottant et commencer une page</primary></indexterm>
+<indexterm role="cp"><primary>commencer une nouvelles page et débourrer les flottant</primary></indexterm>
<para>La commande <literal>\cleardoublepage</literal> finit la page courante et fait que
&latex; imprime tous les flottants, tableaux et figures, qui sont
@@ -5038,12 +6768,6 @@ et une page de droite (numérotée impaire), en produisant si nécessaire
une page à blanc.
</para>
-</sect1>
-<sect1 label="10.2" id="_005cclearpage">
-<title><literal>\clearpage</literal></title>
-<indexterm role="fn"><primary>\clearpage</primary></indexterm>
-<indexterm role="cp"><primary>débourrer les flottant et commencer une page</primary></indexterm>
-<indexterm role="cp"><primary>commencer une nouvelles page et débourrer les flottant</primary></indexterm>
<para>La commande <literal>\clearpage</literal> finit la page actuelle et fait que
&latex; imprime tous les flottants, tableaux et figures, qui sont
@@ -5051,18 +6775,48 @@ apparus en entrée jusqu&#8217;à ce point et sont en attente.
</para>
</sect1>
-<sect1 label="10.3" id="_005cnewpage">
+<sect1 label="10.2" id="_005cnewpage">
<title><literal>\newpage</literal></title>
<indexterm role="fn"><primary>\newpage</primary></indexterm>
<indexterm role="cp"><primary>nouvelle page, commencer</primary></indexterm>
<indexterm role="cp"><primary>commencer une nouvelle page</primary></indexterm>
-<para>La commande <literal>\newpage</literal> finit la page courante, mais ne débourre pas
-tous les flottants (voir <link linkend="_005cclearpage">\clearpage</link>).
+<para>Synopsis :
+</para>
+<screen>\newpage
+</screen>
+<para>La commande <literal>\newpage</literal> finit la page courante. Cette commande est
+robuste (see <link linkend="_005cprotect">\protect</link>).
+</para>
+<para>Les sauts de page de &latex; sont optimisés de sorte que d&#8217;ordinaire on
+n&#8217;utilise cette commande dans le corps d&#8217;un document que pour les
+finitions sur la version finale, ou à l&#8217;interieur de commandes.
+</para>
+<para>Alors que les commandes <literal>\clearpage</literal> et <literal>\cleardoublepage</literal>
+finissent également la page courante, en plus de cela elles débourrent
+les flottants pendants (see <link linkend="_005cclearpage-_0026-_005ccleardoublepage">\clearpage &amp; \cleardoublepage</link>). Et, si
+&latex; est en mode à deux colonne alors <literal>\clearpage</literal> et
+<literal>\cleardoublepage</literal> finissent las page courante en laissant
+possiblement une colonne vide, alors que <literal>\newpage</literal> finit seulement
+la colonne courante.
+</para>
+<para>Contrairement à <literal>\pagebreak</literal> (see <link linkend="_005cpagebreak-_0026-_005cnopagebreak">\pagebreak &amp; \nopagebreak</link>),
+la commande <literal>\newpage</literal> n&#8217;a pas pour effet que la nouvelle page
+commence exactement là où la requête est faite. Dans l&#8217;exemple suivant
+</para>
+<screen>Four score and seven years ago our fathers brought forth on this
+continent,
+\newpage
+\noindent a new nation, conceived in Liberty, and dedicated to the
+proposition that all men are created equal.
+</screen>
+<para>la nouvelle page commence après &#8216;<literal>continent</literal>&#8217;, et la ligne où se
+produit le saut n&#8217;est pas justifiée à droite. De plus, <literal>\newpage</literal>
+n&#8217;étire pas verticalement la page, contrairement à <literal>\pagebreak</literal>.
</para>
</sect1>
-<sect1 label="10.4" id="_005cenlargethispage">
+<sect1 label="10.3" id="_005cenlargethispage">
<title><literal>\enlargethispage</literal></title>
<indexterm role="fn"><primary>\enlargethispage</primary></indexterm>
<indexterm role="cp"><primary>agrandir la page courante</primary></indexterm>
@@ -5081,7 +6835,7 @@ possible. Ceci est normalement utilisé en même temps qu&#8217;un
</para>
</sect1>
-<sect1 label="10.5" id="_005cpagebreak-_0026-_005cnopagebreak">
+<sect1 label="10.4" id="_005cpagebreak-_0026-_005cnopagebreak">
<title><literal>\pagebreak</literal> &amp; <literal>\nopagebreak</literal></title>
<indexterm role="fn"><primary>\pagebreak</primary></indexterm>
<indexterm role="fn"><primary>\nopagebreak</primary></indexterm>
@@ -5157,7 +6911,7 @@ contraire.
<para>Changez l&#8217;aspect que &latex; donne au compteur de note en bas de page
avec quelque chose du genre de
<literal>\renewcommand{\thefootnote}{\fnsymbol{footnote}}</literal>, ce qui
-utilise une séquence de symboles (voir <link linkend="_005calph-_005cAlph-_005carabic-_005croman-_005cRoman-_005cfnsymbol">\alph \Alph \arabic \roman
+utilise une séquence de symboles (see <link linkend="_005calph-_005cAlph-_005carabic-_005croman-_005cRoman-_005cfnsymbol">\alph \Alph \arabic \roman
\Roman \fnsymbol</link>). Pour rendre ce changement global mettez cela dans
le préambule. Si vous faite ce changement local alors vous désirerez
sans doute réinitialiser le compte avec
@@ -5199,7 +6953,7 @@ rubriques suivantes.
utilise le compteur <literal>mpfootnote</literal> au lieu de <literal>footnote</literal>, de
sorte que les notes sont numérotéee indépendemment. Elles apparaissent
au bas de l&#8217;environnement, et non au bas de la page. Et par défaut
-elles apparaissent alphabétiquement. Voir <link linkend="minipage">minipage</link>.
+elles apparaissent alphabétiquement. See <link linkend="minipage">minipage</link>.
</para>
</sect1>
@@ -5215,7 +6969,7 @@ elles apparaissent alphabétiquement. Voir <link linkend="minipage">minipage</li
<para>Sans l&#8217;argument optionnel, la commande <literal>\footnotemark</literal> place dans
le texte le numéro de la note courante. Cette commande peut être
utilisée en mode paragraphe interne. Vous pouvez donner le texte de la
-note séparéement la commande <literal>\footnotetext</literal>.
+note séparément la commande <literal>\footnotetext</literal>.
</para>
<para>Cette commande pour produire plusieurs marque de note en bas de page
faisant référence à la même note avec
@@ -5265,7 +7019,7 @@ dans la cellule du tableau mais rien n&#8217;est composé en bas de la page.
\end{center}
</screen>
<para>La solution est d&#8217;entourer l&#8217;environnement the <literal>tabular</literal> d&#8217;un environnement
-<literal>minipage</literal>, comme ci-après (voir <link linkend="minipage">minipage</link>).
+<literal>minipage</literal>, comme ci-après (see <link linkend="minipage">minipage</link>).
</para>
<screen>\begin{center}
\begin{minipage}{.5\textwidth}
@@ -5274,7 +7028,7 @@ dans la cellule du tableau mais rien n&#8217;est composé en bas de la page.
\end{center}
</screen>
<para>La même technique marche au sein d&#8217;un environnement <literal>table</literal>
-flottant (voir <link linkend="table">table</link>). To get the footnote at the bottom of the page
+flottant (see <link linkend="table">table</link>). To get the footnote at the bottom of the page
use the <filename>tablefootnote</filename> package, comme illustré dans l&#8217;exemple
ci-apès. Si vous placez <literal>\usepackage{tablefootnote}</literal> dans le
préambule et utilisez le code source ci-dessous, alors la note
@@ -5306,6 +7060,7 @@ les autres notes en bas de page.
</screen>
<indexterm role="fn"><primary>paquetage <literal>footmisc</literal></primary></indexterm>
<indexterm role="fn"><primary><literal>footmisc</literal>, paquetage</primary></indexterm>
+
<indexterm role="cp"><primary><literal>stable</literal>, option du paquetage <literal>footmisc</literal></primary></indexterm>
<indexterm role="cp"><primary>option <literal>stable</literal> du paquetage <literal>footmisc</literal></primary></indexterm>
<para>a pour effet que la note en bas de page apparaît à la fois en bas de la
@@ -5340,7 +7095,7 @@ n&#8217;apparaît pas).
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\footnotesep</primary></indexterm><literal>\footnotesep</literal>
</term><listitem><para>La hauteur de l&#8217;étai placé au début de la note en bas de page. Par
défaut, c&#8217;est réglé à l&#8217;étai nomal pour des police de taille
-<literal>\footnotesize</literal> (voir <link linkend="Font-sizes">Font sizes</link>), donc il n&#8217;y a pas d&#8217;espace
+<literal>\footnotesize</literal> (see <link linkend="Font-sizes">Font sizes</link>), donc il n&#8217;y a pas d&#8217;espace
supplémentaire entre les notes. Cela vaut &#8216;<literal>6.65pt</literal>&#8217; pour des polices
à &#8216;<literal>10pt</literal>&#8217;, &#8216;<literal>7.7pt</literal>&#8217; pour &#8216;<literal>11pt</literal>&#8217;, et &#8216;<literal>8.4pt</literal>&#8217; pour
&#8216;<literal>12pt</literal>&#8217;.
@@ -5377,11 +7132,18 @@ des genres.
\newcommand*{\<replaceable>cmd</replaceable>}[<replaceable>nargs</replaceable>][<replaceable>optargdéfaut</replaceable>]{<replaceable>défn</replaceable>}
\renewcommand*{\<replaceable>cmd</replaceable>}[<replaceable>nargs</replaceable>][<replaceable>optargdéfaut</replaceable>]{<replaceable>défn</replaceable>}
</screen>
+<!-- xxx Revoir la trad. -->
+<para>Définit ou redéfinit une commande (voir aussi la discussion de
+<literal>\DeclareRobustCommand</literal> dans <link linkend="Class-and-package-commands">Class and package commands</link>).
+</para>
<indexterm role="cp"><primary>forme en *, définir de nouvelles commandes</primary></indexterm>
<indexterm role="cp"><primary>forme étoilée, définir de nouvelles commandes</primary></indexterm>
-<para>La forme étoilée (en <literal>*</literal>) de ces commandes exige que les arguments
-ne contiennent pas de paragraphes de texte (la commande n&#8217;est pas
-<literal>\long</literal>, dans la terminologie de &tex; de base).
+<indexterm role="fn"><primary>\long</primary></indexterm>
+<para>La forme étoilée (en <literal>*</literal>) de ces commandes interdit que les
+arguments contiennent une multiplicité de paragraphes de texte (la
+commande n&#8217;est pas <literal>\long</literal>, dans la terminologie de
+&tex; de base). Avec la forme par défaut, il est possible qu&#8217;un
+argument soit une multiplicité de paragraphes.
</para>
<variablelist><varlistentry><term><replaceable>cmd</replaceable>
</term><listitem><para>Obligatoire ; <literal>\<replaceable>cmd</replaceable></literal> est le nom de la commande. Pour
@@ -5416,10 +7178,10 @@ cas, tout argument obligatoire sera désigné en commençant par <literal>#2</li
<para>Omettre <literal>[<replaceable>maval</replaceable>]</literal> dans un appel n&#8217;est pas la même chose
qu&#8217;avoir les crochets ne contenant rien, comme dans <literal>[]</literal>. Dans le
premier cas le paramètre <literal>#1</literal> se développe en <replaceable>optargdéfaut</replaceable> ;
-alors que dans le secon <literal>#1</literal> se développe en une chaîne vide.
+alors que dans le second <literal>#1</literal> se développe en une chaîne vide.
</para>
</listitem></varlistentry><varlistentry><term><replaceable>défn</replaceable>
-</term><listitem><para>Le texte par lequel substituer chaque occurrence de \<literal>cmd</literal> ; le
+</term><listitem><para>Le texte par lequel substituer chaque occurrence de <literal>\<replaceable>cmd</replaceable></literal> ; le
paramètre positionnel <literal>#<replaceable>n</replaceable></literal> au sein de <replaceable>défn</replaceable> est
remplacée par le texte passé comme <replaceable>n</replaceable>ième argument.
</para>
@@ -5472,17 +7234,183 @@ la définition et par conséquent définissent bien un groupe.
-<!-- xx \providecommand, * forme (non-\long) -->
+</sect1>
+<sect1 label="12.2" id="_005cprovidecommand">
+<title><literal>\providecommand</literal></title>
+
+<indexterm role="fn"><primary>\providecommand</primary></indexterm>
+<indexterm role="cp"><primary>commandes, définir de nouvelles</primary></indexterm>
+<indexterm role="cp"><primary>définir une nouvelle commande</primary></indexterm>
+<indexterm role="cp"><primary>nouvelles commandes, définir</primary></indexterm>
+
+<para>Définit une commande, du moment qu&#8217;aucune commande de même nom n&#8217;existe déjà.
+</para>
+<para>Synopsis :
+</para>
+<screen>\providecommand{<replaceable>cmd</replaceable>}[<replaceable>nargs</replaceable>][<replaceable>optargdéfaut</replaceable>]{<replaceable>defn</replaceable>}
+\providecommand*{<replaceable>cmd</replaceable>}[<replaceable>nargs</replaceable>][<replaceable>optargdéfaut</replaceable>]{<replaceable>defn</replaceable>}
+</screen>
+<para>Si aucune commande de ce nom n&#8217;existe alors ceci a le même effet que
+<literal>\newcommand</literal> (see <link linkend="_005cnewcommand-_0026-_005crenewcommand">\newcommand &amp; \renewcommand</link>). Si une
+commande de ce nom existe déjà alors cette définition est sans
+effet. Ceci est particulièrement utile dans un fichier de style, ou dans
+tout fichier susceptible d&#8217;être chargé plus d&#8217;une fois.
+</para>
+</sect1>
+<sect1 label="12.3" id="_005cmakeatletter-_0026-_005cmakeatother">
+<title><literal>\makeatletter</literal> et <literal>\makeatother</literal></title>
+
+<para>Synopsis :
+</para>
+<screen>\makeatletter
+ ... définition de commande comprenant @ dans leur nom ..
+\makeatother
+</screen>
+<para>Utilisez cette paire de commande quand vous redéfinissser les commandes
+&latex; dont le nom comprend un caractère arobe <literal>@</literal>. La
+déclaration <literal>\makeatletter</literal> a pour effet que le caractère
+arobase <literal>@</literal> ait le code de catégorie des lettres, c.-à-d. 11. La
+déclaration <literal>\makeatother</literal> règle de code de catégorie de <literal>@</literal>
+à 12, sa valeur d&#8217;origine.
+</para>
+<para>À mesure que chaque caractère est lu par &tex; pour &latex;, un code
+de catégorie lui est assigné. On appelle aussi ce code
+<indexterm role="cp"><primary>catcode</primary></indexterm>
+<indexterm role="cp"><primary>code de catégorie de caractère</primary></indexterm>
+<indexterm role="cp"><primary>catégorie, code de caractère</primary></indexterm>
+<firstterm>catcode</firstterm> pour faire court. Par exemple, la contre-oblique <literal>\</literal>
+reçoit le catcode 0. Les noms de commande consistent en un caractère de
+catégorie 0, d&#8217;ordinaire une contr&#8217;oblique, suivi par des lettres,
+c-à-d. des caractères de catégorie 11 (à ceci près qu&#8217;une commande
+peut également consister en un caractère de catégorie 0 suivi d&#8217;un
+unique caractère qui n&#8217;est pas une lettre).
+</para>
+<para>Le code source de &latex; suit la convention que certaines commandes
+utilisent <literal>@</literal> dans leur nom. Ces commandes sont principalement
+destinées aux auteurs de paquetages ou de classes. Cette convention
+empèche les auteurs qui sont juste utilisateurs d&#8217;un paquetage ou d&#8217;une
+classe de remplacer accidentellement une telle commande par une commande
+définie par eux, puisque par défaut l&#8217;arobe a le catcode 12 (other).
+</para>
+<para>Utilisez la paire <literal>\makeatletter</literal> et <literal>\makeatother</literal> au sein
+d&#8217;un fichier <filename>.tex</filename>, typiquement dans le préambule, quand vous
+définissez ou redéfinissez des commandes dont le nom comprend <literal>@</literal>,
+en entourant votre définition par elles. Ne les utilisez pas au sein de
+fichiers <filename>.sty</filename> ou <filename>.cls</filename> puisque les commandes
+<literal>\usepackage</literal> et <literal>\documentclass</literal> font déjà le nécessaire pour
+que l&#8217;arobe ait le catcode d&#8217;une lettre, à savoir 11.
+</para>
+<indexterm role="fn"><primary>paquetage <literal>macros2e</literal></primary></indexterm>
+<indexterm role="fn"><primary><literal>macros2e</literal>, paquetage</primary></indexterm>
+
+<para>Pour une liste complète des macros contenant une arobase dans leur nom,
+voir le document <ulink url="http://ctan.org/pkg/macros2e">http://ctan.org/pkg/macros2e</ulink>.
+<!-- xx pourquoi est-ce que ceci a été enlevé : -->
+<!-- xx Ces macros sont surtout à l'intention des auteurs de classes et de -->
+<!-- xx paquetages. -->
+</para>
+<para>Dans l&#8217;exemple suivant une commande <literal>\these@nomuniversite</literal> se
+trouve dans le fichier de classe, et l&#8217;utilisateur veut changer sa
+définition. Pour cela, il suffit d&#8217;insérer les trois lignes suivantes
+dans le préambule, avant le <literal>\begin{document}</literal> :
+</para>
+<screen>\makeatletter
+\renewcommand{\these@nomuniversite}{Université Lyon III Jean Moulin}
+\makeatother
+</screen>
+
+</sect1>
+<sect1 label="12.4" id="_005c_0040ifstar">
+<title><literal>\@ifstar</literal></title>
+
+<indexterm role="fn"><primary>\@ifstar</primary></indexterm>
+<indexterm role="cp"><primary>commandes, variantes étoilées</primary></indexterm>
+<indexterm role="cp"><primary>étoilées, variantes de commandes</primary></indexterm>
+
+
+<!-- Inpirée des trucs & astuces de Manuel Pégourié-Gonnard -->
+<!-- (https://elzevir.fr/imj/latex/tips.html#stared) -->
+<para>Vous l&#8217;avez sans doute remarqué, beaucoup d&#8217;environnements ou commandes
+standards de &latex; existent sous une variante étoilée. Vous pouvez avoir
+envie de reprendre cette idée quand vous définissez vos commandes et arguments.
+</para>
+<para>Si vous avez lu <link linkend="_005cnewenvironment-_0026-_005crenewenvironment">\newenvironment &amp; \renewenvironment</link>, vous aurez compris
+que c&#8217;est immédiat pour les environnements car l&#8217;étoile est un caractère
+autorisé dans les noms d&#8217;environnements. Il vous suffit donc de faire
+<literal>\newenvironment{<replaceable>monenv</replaceable>}</literal> et
+<literal>\newenvironment{<replaceable>monenv</replaceable>*}</literal> avec les définitions souhaitées.
+</para>
+<para>Pour les commandes, c&#8217;est plus compliqué car l&#8217;étoile ne peut pas faire partie
+du nom de la commande. Il y aura donc une première commande, qui devra être
+capable de regarder si elle est ou non suivie d&#8217;une étoile et d&#8217;adapter son
+comportement en conséquence. Cette première commande ne pourra pas accepter
+d&#8217;argument, mais pourra faire appel à des commandes qui en acceptent. Par
+ailleurs, on utilise la commande <literal>\@ifstar</literal> interne du noyau &latex; et
+vous pouvez vous reportez à « <link linkend="_005cmakeatletter-_0026-_005cmakeatother">\makeatletter &amp; \makeatother</link> » pour
+comprendre pourquoi cela implique l&#8217;usage d&#8217;un bloc
+<literal>\makeatletter...\makeatother</literal>.
+</para>
+<para>Dans cet exemple, on définit <literal>\ciel</literal> comme une commande avec un
+argument obligatoire et admettant une variante étoilée <literal>\ciel*</literal>
+également avec un argument obligatoire :
+</para>
+<screen>\makeatletter
+\newcommand*\ciel@starred[1]{ciel #1 étoilé}
+\newcommand*\ciel@unstarred[1]{ciel #1 non étoilé}
+\newcommand\ciel{\@ifstar{\ciel@starred}{\ciel@unstarred}}
+\makeatother
+</screen>
+<para>ainsi, <literal>\ciel{bleu}</literal> composera « ciel bleu non étoilé » tandis que
+<literal>\ciel*{nocturne}</literal> composera « ciel nocturne étoilé ».
+</para>
+<para>Notez que les commandes intermédiaires <literal>\ciel@starred</literal> et
+<literal>\ciel@unstarred</literal> comportent un <literal>@</literal> dans leur nom ce qui est
+possible puisque elles apparaissent au sein d&#8217;un bloc
+<literal>\makeatletter...\makeatother</literal>. Ceci assure qu&#8217;elles ne puissent pas être
+utilisées directement dans le document. L&#8217;utilisation de @ dans le nom
+comporte certes un risque de collision avec une commande interne du noyeau
+&latex;, mais une telle collision est facile à détecter et corriger car
+<literal>\newcommand*{\<replaceable>cmd</replaceable>}</literal> vérifie que si la commande <literal>\<replaceable>cmd</replaceable></literal>
+n&#8217;est pas déjà définie et génère une erreur si c&#8217;est le cas.
+</para>
+<para>Voici un autre exemple, où la commande <literal>\agentsecret</literal> comporte deux
+arguments, tandis que sa variante étoilée <literal>\agentsecret*</literal> n&#8217;en présente qu&#8217;un seul :
+</para>
+<screen>\makeatletter
+\newcommand*\agentsecret@starred[1]{\textsc{#1}}
+\newcommand*\agentsecret@unstarred[2]{\textit{#1} \textsc{#2}}
+\newcommand\agentsecret{\@ifstar{\agentsecret@starred}
+&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;{\agentsecret@unstarred}}
+\makeatother
+</screen>
+<para>Avec cette définition, la célèbre réplique de l&#8217;agent 007 :
+</para>
+<screen>Je m'appelle \agentsecret*{Bond}, \agentsecret{James}{Bond}.
+</screen>
+<para>est équivalente à :
+</para>
+<screen>Je m'appelle \textsc{Bond}, \textit{James} textsc{Bond}.
+</screen>
+<para>Un dernier mot :
+dans le nom d&#8217;une commande, l&#8217;étoile est comme une sorte d&#8217;argument optionnel.
+Ceci est différent des noms d&#8217;environnement, où l&#8217;étoile fait partie
+du nom lui-même, et peut donc être à n&#8217;importe quelle position !
+D&#8217;un point de vue purement &tex;nique il est donc possible de mettre un nombre indéfini
+d&#8217;espaces entre la commande et l&#8217;étoile. Ainsi <literal>\agentsecret*{Bond}</literal> et
+<literal>\agentsecret *{Bond}</literal> sont équivalents. Toutefois la pratique commune
+est de ne jamais insérer de tels espaces.
+</para>
</sect1>
-<sect1 label="12.2" id="_005cnewcounter">
-<title><literal>\newcounter</literal></title>
+<sect1 label="12.5" id="_005cnewcounter">
+<title><literal>\newcounter</literal> : allouer un compteur</title>
<indexterm role="fn"><primary>\newcounter</primary></indexterm>
<indexterm role="cp"><primary>compteurs, définir de nouveaux</primary></indexterm>
<para>Synopsis :
</para>
-<screen>\newcounter{<replaceable>nomcompteur</replaceable>}[<replaceable>super</replaceable>]
+<screen>\newcounter{<replaceable>nomcompteur</replaceable>}
+\newcounter{<replaceable>nomcompteur</replaceable>}[<replaceable>super</replaceable>]
</screen>
<para>La commande <literal>\newcounter</literal> définit un nouveau compteur nommé <replaceable>nomcompteur</replaceable>.
Le nouveau compteur est initialisé à zéro.
@@ -5491,50 +7419,57 @@ Le nouveau compteur est initialisé à zéro.
<replaceable>nomcompteur</replaceable> est réinitialisé à chaque incrémentation du compteur
nommé <replaceable>super</replaceable>.
</para>
-<para>Voir <link linkend="Counters">Counters</link>, pour plus d&#8217;information à propos des compteurs.
+<para>See <link linkend="Counters">Counters</link>, pour plus d&#8217;information à propos des compteurs.
</para>
</sect1>
-<sect1 label="12.3" id="_005cnewlength">
-<title><literal>\newlength</literal></title>
+<sect1 label="12.6" id="_005cnewlength">
+<title><literal>\newlength</literal> : allouer une longueur</title>
<indexterm role="fn"><primary>\newlength</primary></indexterm>
-<indexterm role="cp"><primary>longueurs, définir de nouvelles</primary></indexterm>
+<indexterm role="cp"><primary>longueurs, allouer de nouvelles</primary></indexterm>
+<indexterm role="cp"><primary>longueurs élastiques, définir de nouvelles</primary></indexterm>
+<indexterm role="cp"><primary>élastiques, définir de nouvelles longueurs</primary></indexterm>
+<indexterm role="cp"><primary>pas, registre de, &tex; de base</primary></indexterm>
+<indexterm role="cp"><primary>ressort, registre de, &tex; de base</primary></indexterm>
-<para>Synopsis :
+<para>Alloue un nouveau registre de <firstterm>longueur</firstterm>. Synopsis :
</para>
<screen>\newlength{\<replaceable>arg</replaceable>}
</screen>
-<para>La commande <literal>\newlength</literal> définit l&#8217;argument obligatoire comme une
-commande de <firstterm>longueur</firstterm> avec une valeur de <literal>0mm</literal>. L&#8217;argument
-doit être une séquence de contrôle, comme dans
-<literal>\newlength{\foo}</literal>. Une erreur se produit si <literal>\foo</literal> est déjà
-défini.
+<para>Cette commande prnedre un argument obligatoire qui doit commencer par
+une contr&#8217;oblique (&#8216;<literal>\</literal>&#8217;). Elle crée un nouveau registre de longueur
+nommé <literal>\<replaceable>arg</replaceable></literal>, ce qui constitue un emplacement où détenir des
+longueurs (élastiques) telles que <literal>1in plus.2in minus.1in</literal> (ce que
+&tex; de base appelle un registre <literal>skip</literal>, ou regristre de
+pas). Le registre est crée avec une valeur initiale de zéro. La séquence
+de contrôle <literal>\<replaceable>arg</replaceable></literal> doit ne pas être déjà définie.
</para>
-<para>Voir <link linkend="Lengths">Lengths</link>, pour comment régler la nouvelle longeur à une valeur non
-nulle, et pour plus d&#8217;information à propos des longueurs en général.
+<para>See <link linkend="Lengths">Lengths</link>, pour plus d&#8217;information à propos des longueurs.
</para>
</sect1>
-<sect1 label="12.4" id="_005cnewsavebox">
-<title><literal>\newsavebox</literal></title>
+<sect1 label="12.7" id="_005cnewsavebox">
+<title><literal>\newsavebox</literal> : allouer une boîte</title>
+
<indexterm role="fn"><primary>\newsavebox</primary></indexterm>
+<indexterm role="cp"><primary>boîte, allouer une nouvelle</primary></indexterm>
-<para>Synopsis :
+<para>Alloue un « baquet » pour détenir une boîte. Synopsis :
</para>
<screen>\newsavebox{\<replaceable>cmd</replaceable>}
</screen>
-<para>Définit <literal>\<replaceable>cmd</replaceable></literal> pour se référer à un nouveau bac pour stocker
+<para>Définit <literal>\<replaceable>cmd</replaceable></literal> pour se référer à un nouveau baquet pour stocker
des boîtes. Une telle boîte sert à détenir du matériel composé, pour
-l&#8217;utiliser plusieurs fois (voir <link linkend="Boxes">Boxes</link>) ou pour le mesurer ou le
+l&#8217;utiliser plusieurs fois (see <link linkend="Boxes">Boxes</link>) ou pour le mesurer ou le
manipuler. Le nom <literal>\<replaceable>cmd</replaceable></literal> doit commencer par une
contr&#8217;oblique, et ne doit pas être déjà défini.
</para>
<para>L&#8217;allocation d&#8217;une boîte est globale. Cette commande est fragile
-(voir <link linkend="_005cprotect">\protect</link>).
+(see <link linkend="_005cprotect">\protect</link>).
</para>
</sect1>
-<sect1 label="12.5" id="_005cnewenvironment-_0026-_005crenewenvironment">
+<sect1 label="12.8" id="_005cnewenvironment-_0026-_005crenewenvironment">
<title><literal>\newenvironment</literal> &amp; <literal>\renewenvironment</literal></title>
<indexterm role="fn"><primary>\newenvironment</primary></indexterm>
<indexterm role="fn"><primary>\renewenvironment</primary></indexterm>
@@ -5592,7 +7527,7 @@ utilisé avec des crochets à la suite, comme dans
être suivi de crochet, alors, au sein de <replaceable>défdébut</replaceable>, le
<indexterm role="cp"><primary>paramètre positionnel</primary></indexterm>
paramètre positionnel <literal>#1</literal> se développe en la valeur par défaut,
-c.-à-d. <replaceable>optargdefault</replaceable>. Dans les deux cas, le premier paramètre
+c.-à-d. <replaceable>optargdéfaut</replaceable>. Dans les deux cas, le premier paramètre
positionnel faisant référence à argument obligatoire est <literal>#2</literal>.
</para>
<para>Omettre <literal>[<replaceable>maval</replaceable>]</literal> dans l&#8217;appel est différent d&#8217;avoir des
@@ -5648,7 +7583,7 @@ Dans le document, utilisez l&#8217;environnement comme ceci :
</screen>
<para>Ce dernier exemple montre comment sauvegarder la valeur d&#8217;un argument
pour l&#8217;utiliser dans <replaceable>déffin</replaceable>, dans ce cas dans une boîte
-(voir <link linkend="_005csbox">\sbox</link>).
+(see <link linkend="_005csbox">\sbox</link>).
</para>
<screen>\newsavebox{\quoteauthor}
\newenvironment{citequote}[1][Corneille]{%
@@ -5661,7 +7596,7 @@ pour l&#8217;utiliser dans <replaceable>déffin</replaceable>, dans ce cas dans
</screen>
</sect1>
-<sect1 label="12.6" id="_005cnewtheorem">
+<sect1 label="12.9" id="_005cnewtheorem">
<title><literal>\newtheorem</literal></title>
<indexterm role="fn"><primary>\newtheorem</primary></indexterm>
<indexterm role="cp"><primary>théorèmes, définition</primary></indexterm>
@@ -5702,9 +7637,9 @@ fois.
<para>Cette commande crée un compteur nommé <replaceable>name</replaceable>. De plus, à moins que
l&#8217;argument optionnel <replaceable>numéroté_comme</replaceable> soit utilisé, la valeur
courrante de <literal>\ref</literal> est celle de
-<literal>\the<replaceable>numéroté_au_sein_de</replaceable></literal> (voir <link linkend="_005cref">\ref</link>).
+<literal>\the<replaceable>numéroté_au_sein_de</replaceable></literal> (see <link linkend="_005cref">\ref</link>).
</para>
-<para>Cette déclaration est globale. Elle est fragile (voir <link linkend="_005cprotect">\protect</link>).
+<para>Cette déclaration est globale. Elle est fragile (see <link linkend="_005cprotect">\protect</link>).
</para>
<variablelist><varlistentry><term><replaceable>nom</replaceable>
</term><listitem><para>Le nom de l&#8217;environnement. Il ne doit pas commencer avec une
@@ -5789,7 +7724,7 @@ utilise le même compteur que <literal>defn</literal>. Cela donne
</screen>
</sect1>
-<sect1 label="12.7" id="_005cnewfont">
+<sect1 label="12.10" id="_005cnewfont">
<title><literal>\newfont</literal>: définit une nouvelle police (obsolète)</title>
<indexterm role="fn"><primary>\newfont</primary></indexterm>
<indexterm role="cp"><primary>polices, commandes pour déclarer de nouvelles</primary></indexterm>
@@ -5816,7 +7751,7 @@ exemple, d&#8217;associer un gras et un romain) au travers de ce qu&#8217;il est
convenu de nommer le « Nouveau Plan de Sélection de Polices de
caractère », soit en utilisant des fichier <filename>.fd</filename> ou à travers
l&#8217;utilisation d&#8217;un moteur qui sait accéder au système de polices de
-caractère, tel que Xe&latex; (voir <link linkend="TeX-engines">Les moteurs
+caractère, tel que Xe&latex; (see <link linkend="TeX-engines">Les moteurs
&tex;</link>).
<!-- xx explain nfss somewhere -->
</para>
@@ -5842,7 +7777,7 @@ caractères dans chacune d&#8217;elles :
</screen>
</sect1>
-<sect1 label="12.8" id="_005cprotect">
+<sect1 label="12.11" id="_005cprotect">
<title><literal>\protect</literal></title>
<indexterm role="fn"><primary>\protect</primary></indexterm>
@@ -5868,11 +7803,11 @@ comme la table des matières. On appelle
<firstterm>argument mouvant</firstterm> tout argument qui est développé en interne par
&latex; sans être directement composé en sortie. Une commande est dite
fragile si elle se développe pendant ce processus en un code &tex; non
-valide. Certains exemples d&#8217;arguments mouvants sont ceut qui apparaissent
-au sein des commande <literal>\caption{...}</literal> (voir <link linkend="figure">figure</link>), dans la
-commande <literal>\thanks{...}</literal> (voir <link linkend="_005cmaketitle">\maketitle</link>), et dans les
+valide. Certains exemples d&#8217;arguments mouvants sont ceux qui apparaissent
+au sein des commandes <literal>\caption{...}</literal> (see <link linkend="figure">figure</link>), dans la
+commande <literal>\thanks{...}</literal> (see <link linkend="_005cmaketitle">\maketitle</link>), et dans les
expression en @ des environnements <literal>tabular</literal> et <literal>array</literal>
-(voir <link linkend="tabular">tabular</link>).
+(see <link linkend="tabular">tabular</link>).
</para>
<para>Si vous obtenez des erreurs étranges de commandes utilisées au sein
d&#8217;arguments mouvants, essayez des les précéder d&#8217;un <literal>\protect</literal>. Il
@@ -5896,7 +7831,7 @@ mystérieuse
<para>Dans l&#8217;exemple suivant la commande <literal>\tableofcontents</literal> produit une
erreur à cause du <literal>\(..\)</literal> dans le titre de section qui se
développe en code incorrect &tex; dans le fichier <filename>.toc</filename>. Vous
-pouvez résoudre ceci en remplaçat <literal>\(..\)</literal>
+pouvez résoudre ceci en remplaçant <literal>\(..\)</literal>
par <literal>\protect\(..\protect\)</literal>.
</para>
<screen>\begin{document}
@@ -5997,12 +7932,29 @@ pour numéroter les articles de la liste.
</para>
<screen>\value{<replaceable>compteur</replaceable>}
</screen>
-<para>La commande <literal>\value</literal> produit la valeur de <replaceable>compteur</replaceable>. Ça peut
-être utilisé partout là où &latex; attend un nombre, par exemple :
+<para>Cette commande se développe en la valeur de <replaceable>compteur</replaceable>. Elle est
+souvent utilisé dans <literal>\setcounter</literal> ou <literal>\addtocoutner</literal>, mais
+<literal>\value</literal> peut être utilisé partout là où &latex; attend un
+nombre. Elle ne doit pas être précédée par <literal>\protect</literal>
+(see <link linkend="_005cprotect">\protect</link>).
+</para>
+<para>La commande <literal>\value</literal> n&#8217;est pas utiliser pour composer la valeur du
+compteur. See <link linkend="_005calph-_005cAlph-_005carabic-_005croman-_005cRoman-_005cfnsymbol">\alph \Alph \arabic \roman \Roman \fnsymbol</link>.
+</para>
+<para>Cet exemple produit en sortie &#8216;<literal>Le compteur essai vaut 6. Le
+compteur autre vaut 5</literal>&#8217;.
</para>
-<screen>\setcounter{moncompteur}{3}
-\addtocounter{moncompteur}{1}
-\hspace{\value{moncompteur}\parindent}
+<screen>\newcounter{essai} \setcounter{essai}{5}
+\newcounter{autre} \setcounter{autre}{\value{essai}}
+\addtocounter{essai}{1}
+
+Le comppteur essai vaut \arabic{essai}.
+Le compteur autre vaut \arabic{autre}.
+</screen>
+<para>Cet exemple insère <literal>\hspace{4\parindent}</literal>.
+</para>
+<screen>\setcounter{moncptr}{3} \addtocounter{moncptr}{1}
+\hspace{\value{moncptr}\parindent}
</screen>
</sect1>
@@ -6035,7 +7987,7 @@ quantité spécifiée par l&#8217;argument <replaceable>valeur</replaceable>, qu
<indexterm role="fn"><primary>\refstepcounter</primary></indexterm>
<para>La commande <literal>\refstepcounter</literal> fonctionne de la même façon que
-<literal>\stepcounter</literal> Voir <link linkend="_005cstepcounter">\stepcounter</link>, à ceci près qu&#8217;elle définit
+<literal>\stepcounter</literal> See <link linkend="_005cstepcounter">\stepcounter</link>, à ceci près qu&#8217;elle définit
également la valeur courante de <literal>\ref</literal> comme le résultat de
<literal>\thecounter</literal>.
</para>
@@ -6063,7 +8015,7 @@ re-initialise tous les compteurs subsidiaires.
pas remis à jour pendant que le traitement par &tex; progresse.
</para>
<para>En relation avec ces compteurs, la commande <literal>\today</literal> produit une
-chaîne représentant le jour courant (voir <link linkend="_005ctoday">\today</link>).
+chaîne représentant le jour courant (see <link linkend="_005ctoday">\today</link>).
</para>
</sect1>
@@ -6072,10 +8024,118 @@ chaîne représentant le jour courant (voir <link linkend="_005ctoday">\today</l
<title>Longueurs</title>
<indexterm role="cp"><primary>longueurs, définir et utiliser</primary></indexterm>
-<indexterm role="cp"><primary>longueur</primary></indexterm>
-<para>Une <firstterm>longeur</firstterm> est une mesure de distance. Beaucoup de commandes
+<para>Une <firstterm>longueur</firstterm> est une mesure de distance. Beaucoup de commandes
&latex; prennent une longueur en argument.
</para>
+<indexterm role="cp"><primary>rigides, longueurs</primary></indexterm>
+<indexterm role="cp"><primary>élastiques, longueurs</primary></indexterm>
+<indexterm role="cp"><primary>dimen &tex; de base</primary></indexterm>
+<indexterm role="cp"><primary>skip &tex; de base</primary></indexterm>
+<indexterm role="cp"><primary>glue &tex; de base</primary></indexterm>
+<para>Il y a deux types de longueur. Une <firstterm>longueur rigide</firstterm> telle que
+<literal>10pt</literal> ne contient pas de composante en <literal>plus</literal> ou
+<literal>minus</literal>. (En &tex; de base on appelle cela une <firstterm>dimen</firstterm>).
+Une <firstterm>longueur élastique</firstterm> (ce qu&#8217;en &tex; de base on appel un
+<firstterm>skip</firstterm> ou une <firstterm>glue</firstterm>) telle que dans <literal>1cm plus0.05cm
+minus0.01cm</literal> peut contenir l&#8217;un ou l&#8217;autre de ces composantes ou les
+deux. Dans cette longueur élastique, le <literal>1cm</literal> est la <firstterm>longueur
+naturelle</firstterm> alors que les deux autres, les composantes en <literal>plus</literal> et
+<literal>minus</literal>, permette à &tex; à dilater ou contracter la longueur pour
+optimiser la disposition.
+</para>
+<para>Les exemples qui suivent utilisent ces deux commandes.
+</para>
+<screen>% Fait une barre noire de 10pt de haut et #1 de large
+\newcommand{\blackbar}[1]{\rule{#1}{10pt}}
+
+% Fait une boîte autour de #2 qui est #1 de large (sans la bordure)
+\newcommand{\showhbox}[2]{%
+ \fboxsep=0pt\fbox{\hbox to #1{#2}}}
+</screen>
+<para>Cet exemple utilise ces commandes pour afficher une barre noire de
+100 points de long entre &#8216;<literal>XXX</literal>&#8217; et &#8216;<literal>YYY</literal>&#8217;. Cette longueur est
+rigide.
+</para>
+<screen>XXX\showhbox{100pt}{\blackbar{100pt}}YYY
+</screen>
+<para>Quant au longueur élastiques, la contraction est le plus simple des
+deux : avec <literal>1cm minus 0.05cm</literal>, la longueur naturelle est 1cm
+mais &tex; peut la contracter jusqu&#8217;à 0,95cm. &tex; refuse de
+contracter plus que cela. Ainsi, ci-dessous le premier <literal>\showhbox</literal>
+fonctionne bien, un espace de 98 points étant produit entre les deux
+barres.
+</para>
+<screen>XXX\showhbox{300pt}{%
+ \blackbar{101pt}\hspace{100pt minus 2pt}\blackbar{101pt}}YYY
+
+XXX\showhbox{300pt}{%
+ \blackbar{105pt}\hspace{100pt minus 1pt}\blackbar{105pt}}YYY
+</screen>
+<para>Mais le second produit un avertissement du genre de &#8216;<literal>Overfull
+\hbox (1.0pt too wide) detected at line 17</literal>&#8217;. En sortie le premier
+&#8216;<literal>Y</literal>&#8217; est écrasé par la fin de la barre noire, parce que la matière
+contenue par la boîte est plus large que les 300pt alloués, et que
+&tex; a refusé de contracter le total en deçà de 309 points.
+</para>
+<para>Dilater est similaire à contracter, à ceci près que si &tex; doit
+dilater plus que la quantité disponible, alors il le fait. Ci-dessous
+la première ligne fonctionne bien, et produit un espace de 110 points
+entre les barres.
+</para>
+<screen>XXX\showhbox{300pt}{%
+ \blackbar{95pt}\hspace{100pt plus 10pt}\blackbar{95pt}}YYY
+
+XXX\showhbox{300pt}{%
+ \blackbar{95pt}\hspace{100pt plus 1pt}\blackbar{95pt}}YYY
+</screen>
+<para>Dans la seconde ligne &tex; a besoin de dilater de 10 points alors que
+seulement 1 point a été spécifié. &tex; dilate l&#8217;espace jusqu&#8217;à la
+longueur requise mais il produit un avertissement du genre de
+&#8216;<literal>Underfull \hbox (badness 10000) detected at line 22</literal>&#8217;. (On ne
+discute pas ici de ce que signifie « badness »).
+</para>
+<para>Il est possible de mettre à la fois de la dilatation et de la
+contraction dans la même longueur, comme dans <literal>1ex plus 0.05ex
+minus 0.02ex</literal>.
+</para>
+<para>Si &tex; ajuste plus d&#8217;une longueur élastique alors il alloue la
+dilatation ou la contraction proportionnellement.
+</para>
+<screen>XXX\showhbox{300pt}{%
+ \blackbar{100pt}% gauche
+ \hspace{0pt plus 50pt}\blackbar{80pt}\hspace{0pt plus 10pt}% milieu
+ \blackbar{100pt}}YYY % droite
+</screen>
+<para>Les barres de gauche et de droite prennent 100 points, de sorte que celle
+du milieu a besoin également de 100. La barre du milieu fait 80 points
+et donc les deux <literal>\hspace</literal> doivent se dilater de 20 points.
+Comme les deux sont <literal>plus 50pt</literal> et <literal>plus 10pt</literal>, &tex; obtient
+5/6 de la dilatation du premier espace et 1/6 du second.
+</para>
+<para>La composante <literal>plus</literal> ou <literal>minus</literal> d&#8217;une longueur élastique peut
+contenir un composante en <firstterm>fill</firstterm>, comme dans <literal>1in plus2fill</literal>.
+Cela donne à la longueur une dilatabilité ou contractabilité infinie de
+sorte que &tex; puisse l&#8217;ajuster à n&#8217;importe quelle distance. Dans
+l&#8217;exemple suivant les deux figures sont également espacées
+horizontalement sur la page.
+</para>
+<screen>\begin{minipage}{\linewidth}
+ \hspace{0pt plus 1fill}\includegraphics{godel.png}%
+ \hspace{0pt plus 1fill}\includegraphics{einstein.png}%
+ \hspace{0pt plus 1fill}
+\end{minipage}
+</screen>
+<para>&tex; en réalité a trois niveaux d&#8217;infinité pour les composantes
+élastiques : <literal>fil</literal>, <literal>fill</literal>, et <literal>filll</literal> dans l&#8217;ordre
+d&#8217;infinité croissante. D&#8217;ordinaire les auteurs de documents n&#8217;utilisent
+que celle du milieu (see <link linkend="_005chfill">\hfill</link> et see <link linkend="_005cvfill">\vfill</link>).
+</para>
+<para>Multiplier une longueur élastique par un nombre la transforme en une
+longueur rigide, de sorte qu&#8217;après <literal>\setlength{\ylength}{2.5cm
+plus 0.5cm}</literal> et <literal>\setlength{\zlength}{3\ylength}</literal> alors la
+valeur de <literal>\zlength</literal> est <literal>2.5cm</literal>.
+</para>
+
<sect1 label="14.1" id="Units-of-length">
<title>Unités de longueur</title>
@@ -6159,7 +8219,7 @@ points.
<para>En mode mathématique, beaucoup de définitions sont exprimées dans
l&#8217;unité mathématique <firstterm>mu</firstterm> donnée par 1em = 18mu, où le
em est pris de la famille courante des symboles mathématiques.
-Voir <link linkend="Spacing-in-math-mode">Spacing in math mode</link>.
+See <link linkend="Spacing-in-math-mode">Spacing in math mode</link>.
</para>
</sect1>
@@ -6252,7 +8312,7 @@ longueur <literal>\<replaceable>longueur</replaceable></literal> à la largeur
<indexterm role="fn"><primary>\totalheight</primary></indexterm>
</para>
<para>Ces paramètres de longueur peuvent être utilisés au sein des arguments
-des commandes de fabrication de boîte (voir <link linkend="Boxes">Boxes</link>). Il spécifient la
+des commandes de fabrication de boîte (see <link linkend="Boxes">Boxes</link>). Il spécifient la
largeur naturelle, etc., du texte dans la boîte. <literal>\totalheight</literal>
vaut <inlineequation><mathphrase><literal>&#92;height</literal> +
<literal>&#92;depth</literal></mathphrase></inlineequation>. Pour frabriquer une boîte dont le texte
@@ -6316,8 +8376,8 @@ supprimé.
</para>
</sect1>
-<sect1 label="15.3" id="_005cparskip">
-<title><literal>\parskip</literal></title>
+<sect1 label="15.3" id="_005cparindent-_0026-_005cparskip">
+<title><literal>\parindent</literal> &amp; <literal>\parskip</literal></title>
<indexterm role="fn"><primary>\parskip</primary></indexterm>
<indexterm role="cp"><primary>espace vertical avant les paragraphes</primary></indexterm>
@@ -6401,10 +8461,13 @@ les notes de déborder hors du bas de la page.
<indexterm role="cp"><primary>mode mathématique, entrer</primary></indexterm>
<indexterm role="fn"><primary>environnement <literal>math</literal></primary></indexterm>
<indexterm role="fn"><primary><literal>math</literal>, environnement</primary></indexterm>
+
<indexterm role="fn"><primary>environnement <literal>displaymath</literal></primary></indexterm>
<indexterm role="fn"><primary><literal>displaymath</literal>, environnement</primary></indexterm>
+
<indexterm role="fn"><primary>environnement <literal>equation</literal></primary></indexterm>
<indexterm role="fn"><primary><literal>equation</literal>, environnement</primary></indexterm>
+
<para>Il y a trois environnements qui mettent &latex; en mode mathématique :
</para>
<variablelist><varlistentry><term><literal>math</literal>
@@ -6458,9 +8521,9 @@ dessus et en dessous le signe de sommation. Par exemple
<title>Indices inférieurs &amp; supérieurs</title>
<indexterm role="cp"><primary>indice supérieur</primary></indexterm>
<indexterm role="cp"><primary>indice inférieur</primary></indexterm>
+<indexterm role="fn"><primary>^ indice supérieur</primary></indexterm>
+<indexterm role="fn"><primary>_ indice inférieur</primary></indexterm>
<indexterm role="cp"><primary>exposant</primary></indexterm>
-<indexterm role="fn"><primary>_</primary></indexterm>
-<indexterm role="fn"><primary>^</primary></indexterm>
<para>En mode mathématique, utilisez le caractère caret <literal>^</literal> pour qu&#8217;une
expression <replaceable>exp</replaceable> apparaisse en indice supérieur, c.-à-d. tapez
@@ -6521,7 +8584,6 @@ le mode, voir <link linkend="_005censuremath">\ensuremath</link>.
</para>
<!-- xx Add Negation: @code{} for negations of relevant symbols -->
<!-- Useful: http://www.w3.org/TR/WD-math-970515/section6.html -->
-
<variablelist><varlistentry><term><indexterm role="fn"><primary>\|</primary></indexterm><literal>\|</literal>
</term><listitem><para>∥ Parallèle (relation). Synonyme : <literal>\parallel</literal>.
</para>
@@ -7524,7 +9586,7 @@ police romaine et avec l&#8217;espacement adéquat.
<para>&latex; fournit diverse commandes pour produire des lettres accentuées en
math. Elles diffèrent de celles concernant les accents en texte normal
-(voir <link linkend="Accents">Accents</link>).
+(see <link linkend="Accents">Accents</link>).
</para>
<variablelist><varlistentry><term><indexterm role="fn"><primary>\acute</primary></indexterm><literal>\acute</literal>
</term><listitem><indexterm role="cp"><primary>accent aigu en math</primary></indexterm>
@@ -7612,7 +9674,7 @@ normales pour les textes mathématiques.
</para>
<para>En mode mathématique, beaucoup de définitions sont exprimées dans
l&#8217;unité mathématique <firstterm>mu</firstterm> donnée par 1 em = 18 mu, où le em est pris
-de la famille courante des symboles mathématiques (voir <link linkend="Units-of-length">Units of length</link>).
+de la famille courante des symboles mathématiques (see <link linkend="Units-of-length">Units of length</link>).
</para>
<variablelist><varlistentry><term><literal>\;</literal>
</term><listitem><indexterm role="cp"><primary>thickspace</primary></indexterm>
@@ -7634,7 +9696,7 @@ de la famille courante des symboles mathématiques (voir <link linkend="Units-of
<indexterm role="fn"><primary>\,</primary></indexterm>
<indexterm role="fn"><primary>\thinspace</primary></indexterm>
<para>Normalement <literal>3mu</literal>. Le nom long est <literal>\thinspace</literal>. Utilisable à
-la fois en mode mathématique et en mode texte. Voir <link linkend="_005cthinspace">\thinspace</link>.
+la fois en mode mathématique et en mode texte. See <link linkend="_005cthinspace">\thinspace</link>.
</para>
</listitem></varlistentry><varlistentry><term><literal>\!</literal>
</term><listitem><indexterm role="fn"><primary>\!</primary></indexterm>
@@ -8007,7 +10069,7 @@ change en <replaceable>style</replaceable> pour la page courante seulement.
</para>
<para>Une autre commande produisant de l&#8217;espace est <literal>\,</literal> pour produire une
espace « fine » (d&#8217;habitude 1/6quad). Elle peut être utilisée en
-mode texte, mais est le plus souvent utile en mode math (voir <link linkend="Spacing-in-math-mode">Espacement en mode mathématique</link>).
+mode texte, mais est le plus souvent utile en mode math (see <link linkend="Spacing-in-math-mode">Espacement en mode mathématique</link>).
</para>
<!-- -->
<!-- -->
@@ -8022,7 +10084,7 @@ mode texte, mais est le plus souvent utile en mode math (voir <link linkend="Spa
</screen>
<para>La commande <literal>\hspace</literal> ajoute de l&#8217;espace horizontal. L&#8217;argument
<replaceable>longueur</replaceable> peut être exprimé en toute unité que &latex; comprend :
-points, pouces, etc. C&#8217;est une longueur elastique. Vous pouvez
+points, pouces, etc. C&#8217;est une longueur élastique. Vous pouvez
ajouter aussi bien de l&#8217;espace négatif que de l&#8217;espace positif avec une
commande <literal>\hspace</literal> ; ajouter de l&#8217;espace negatif revient à
retourner en arrière.
@@ -8061,7 +10123,7 @@ une abréviation.
<para>Par défaut, lorsque &latex; justifie une ligne il ajuste l&#8217;espace après
le point final de chaque phrase (ou le point d&#8217;interrogation, la
virgule, ou le deux-points) plus que pour l&#8217;espace inter-mot
-(voir <link linkend="_005cfrenchspacing">\frenchspacing</link>). &latex; suppose que le point finit une phrase
+(see <link linkend="_005cfrenchspacing">\frenchspacing</link>). &latex; suppose que le point finit une phrase
à moins qu&#8217;il soit précédé d&#8217;une lettre capitale, dans quel cas il
considère que ce point fait partie d&#8217;une abréviation. Il est à noter que
si un point final de phrase est immédiatement suivit d&#8217;une parenthèse ou
@@ -8075,7 +10137,7 @@ contr&#8217;oblique-espace (<literal>\ </literal>), où d&#8217;un tilde (<liter
exemples : <literal>Nat.\ Acad.\ Science</literal>, et <literal>Mr.~Bean</literal>, et <literal>(du
fumier, etc.)\ à vendre</literal>.
</para>
-<para>Pour une autre utilisation de <literal>\ </literal>, voir <link linkend="_005c_0028SPACE_0029-after-control-sequence"><literal>\ </literal> après une séquence de contrôle</link>.
+<para>Pour une autre utilisation de <literal>\ </literal>, see <link linkend="_005c_0028SPACE_0029-after-control-sequence"><literal>\ </literal> après une séquence de contrôle</link>.
</para>
<para>Dans la situation opposée, si vous avez une lettre capitale suivi d&#8217;un point
qui finit la phrase, alors placez <literal>\@</literal> avant ce point. Par ex.,
@@ -8108,6 +10170,7 @@ d&#8217;un signe de ponctuation. Comparez :
<indexterm role="fn"><primary>paquetage <literal>xspace</literal></primary></indexterm>
<indexterm role="fn"><primary><literal>xspace</literal>, paquetage</primary></indexterm>
+
<para>Certaines commandes, notamment celles définies avec le paquetage
<literal>xspace</literal>, ne suivent pas ce comportement standard.
</para>
@@ -8137,7 +10200,7 @@ la même façon.
<title><literal>\thinspace</literal></title>
<indexterm role="fn"><primary>\thinspace</primary></indexterm>
-<para><literal>\thinspace</literal> produit une espace insécable et non-elastique qui vaut
+<para><literal>\thinspace</literal> produit une espace insécable et non-élastique qui vaut
1/6 d&#8217;em. C&#8217;est l&#8217;espace adéquate entre des guillemets anglais
simples emboîtés, comme dans &#8217;&#8221;.<!-- Abuse @dmn, which is a thin -->
<!-- space in Texinfo. -->
@@ -8166,7 +10229,7 @@ avec <emphasis>f: f;</emphasis>.
<para>Lorsque on change de fontes avec des commandes telles que
<literal>\textit{italic text}</literal> ou <literal>{\itshape italic text}</literal>,
&latex; insère automatiquement une correction italique appropriée si
-nécessaire (voir <link linkend="Font-styles">Font styles</link>).
+nécessaire (see <link linkend="Font-styles">Font styles</link>).
</para>
<para>Malgré leur nom, les caractères romains peuvent aussi avoir une
correction italique. Comparez :
@@ -8183,7 +10246,7 @@ l&#8217;espacement y est fait d&#8217;une façon différente.
<indexterm role="fn"><primary>\hrulefill</primary></indexterm>
<indexterm role="fn"><primary>\dotfill</primary></indexterm>
-<para>Produit une longueur elastique infinie (voir <link linkend="Lengths">Lengths</link>) remplie avec un
+<para>Produit une longueur élastique infinie (see <link linkend="Lengths">Lengths</link>) remplie avec un
filled filet horizontal (c.-à-d. une ligne) ou avec des pointillés, au
lieu de just de l&#8217;espace blanche.
</para>
@@ -8216,7 +10279,7 @@ défaut de 0.33em à 1.00em.
<para><literal>\addvspace{<replaceable>length</replaceable>}</literal>
</para>
<para>Ajoute un espace vertical de longeur <replaceable>length</replaceable>, ce qui est une
-longueur élatsique (voir <link linkend="Lengths">Lengths</link>). Toutefois, si l&#8217;espace vertical a
+longueur élatsique (see <link linkend="Lengths">Lengths</link>). Toutefois, si l&#8217;espace vertical a
déjà été ajouté au même point de la sortie par une commande
<literal>\addvspace</literal> précédente, alors cette commande n&#8217;ajoutera pas plus
d&#8217;espace que nécessaire à fabriquer la longeur naturelle de l&#8217;espace
@@ -8228,7 +10291,7 @@ exemple, un environnement Theorem est défini pour commencer et finir en
<literal>\addvspace{..}</literal> de sorte que deux Theorem consécutifs sont
séparés par un espace vertical, et non deux.)
</para>
-<para>Cette commande est fragile (voir <link linkend="_005cprotect">\protect</link>).
+<para>Cette commande est fragile (see <link linkend="_005cprotect">\protect</link>).
</para>
<para>L&#8217;erreur &#8216;<literal>Something's wrong--perhaps a missing \item</literal>&#8217; signifie que
vous n&#8217;étiez pas en mode vertical quand vous avez invoqué cette
@@ -8273,15 +10336,15 @@ rétrécissement (la valeur par défaut pour les classes <literal>book</literal>
<indexterm role="cp"><primary>dilatation verticale infinie</primary></indexterm>
<indexterm role="cp"><primary>verticale infinie, dilatation</primary></indexterm>
-<para>Finit le paragraphe courante et insère une longueur elastique verticale
-(voir <link linkend="Lengths">Lengths</link>) qui est infinie, de sorte qu&#8217;elle puisse se dilater ou
-that is se rétrécire autant que nécessaire.
+<para>Finit le paragraphe courant et insère une longueur élastique verticale
+(see <link linkend="Lengths">Lengths</link>) qui est infinie, de sorte qu&#8217;elle puisse se dilater ou
+se rétrécir autant que nécessaire.
</para>
<para>On l&#8217;utilise souvent de la même façon que <literal>\vspace{\fill}</literal>, à
ceci près que <literal>\vfill</literal> finit le paragraphe courant, tandis que
-<literal>\vspace{\fill}</literal> ajoute une espace verticale infinin sous sa
+<literal>\vspace{\fill}</literal> ajoute un espace vertical infini sous sa
ligne sans tenir compte de la structure du paragraphe. Dans les deux
-cas cette espace disparaît à la fin de la page ; pour éviter cela
+cas cet espace disparaît à la fin de la page ; pour éviter cela
voir <link linkend="_005cvspace">\vspace</link>.
</para>
<para>Dans l&#8217;exemple qui suit la page est remplie, de sorte que les lignes en
@@ -8310,7 +10373,7 @@ Chien perdu !
\vspace*{<replaceable>longueur</replaceable>}
</screen>
<para>Ajout l&#8217;espace verticale <replaceable>longueur</replaceable>. Celle-ci peut-être négative ou positive,
-et c&#8217;est une longueur élastique (voir <link linkend="Lengths">Lengths</link>).
+et c&#8217;est une longueur élastique (see <link linkend="Lengths">Lengths</link>).
</para>
<para>&latex; enlève l&#8217;espace verticale provenant de <literal>\vspace</literal> aux sauts
de page, c.-à-d. au sommet et au bas des pages. La version étoilée
@@ -8339,7 +10402,7 @@ chacune d&#8217;elle.
<title>Boîtes</title>
<indexterm role="cp"><primary>boîtes</primary></indexterm>
-<para>Tous les paramètres de longueurs prédéfinies (voir <link linkend="Predefined-lengths">Predefined lengths</link>)
+<para>Tous les paramètres de longueurs prédéfinies (see <link linkend="Predefined-lengths">Predefined lengths</link>)
peuvent être utilisés au sein des arguments des commandes de fabrication
de boîtes.
</para>
@@ -8383,7 +10446,7 @@ la largeur de la boîte avec l&#8217;argument optionnel <replaceable>largeur</re
(valant par défaut &#8216;<literal>.4pt</literal>&#8217;), et laisse un espace de <literal>\fboxsep</literal>
(valant par défaut &#8216;<literal>3pt</literal>&#8217;) entre le filet et le contenu de la boîte.
</para>
-<para>Voir <link linkend="_005cframebox-_0028picture_0029">\framebox (picture)</link>, pour la commande <literal>\framebox</literal> dans
+<para>See <link linkend="_005cframebox-_0028picture_0029">\framebox (picture)</link>, pour la commande <literal>\framebox</literal> dans
l&#8217;environnement <literal>picture</literal>.
</para>
@@ -8431,62 +10494,72 @@ texte au sein de la boîte est determinée par l&#8217;argument optionnel
contenir de l&#8217;espace dilatable pour que cela marche.
</para></listitem></varlistentry></variablelist>
<para><literal>\makebox</literal> est aussi utilisé au sein de l&#8217;environnement <literal>picture</literal>,
-voir <link linkend="_005cmakebox-_0028picture_0029">\makebox (picture)</link>.
+see <link linkend="_005cmakebox-_0028picture_0029">\makebox (picture)</link>.
</para>
</sect1>
<sect1 label="20.5" id="_005cparbox">
<title><literal>\parbox</literal></title>
<indexterm role="fn"><primary>\parbox</primary></indexterm>
+<indexterm role="cp"><primary>paragraphe, mode</primary></indexterm>
+<indexterm role="cp"><primary>paragraphe, dans une boîte</primary></indexterm>
-<para>Synopsis :
+
+<para>Synopsis, l&#8217;un parmi les suivants :
</para>
-<screen>\parbox[<replaceable>position</replaceable>][<replaceable>hauteur</replaceable>][<replaceable>pos-interne</replaceable>]{<replaceable>largeur</replaceable>}{<replaceable>texte</replaceable>}
+<screen>\parbox{<replaceable>largeur</replaceable>}{<replaceable>contenu</replaceable>}
+\parbox[<replaceable>position</replaceable>]{<replaceable>largeur</replaceable>}{<replaceable>contenu</replaceable>}
+\parbox[<replaceable>position</replaceable>][<replaceable>hauteur</replaceable>]{<replaceable>largeur</replaceable>}{<replaceable>contenu</replaceable>}
+\parbox[<replaceable>position</replaceable>][<replaceable>hauteur</replaceable>][<replaceable>pos-interne</replaceable>]{<replaceable>largeur</replaceable>}{<replaceable>contenu</replaceable>}
</screen>
<indexterm role="cp"><primary>mode paragraphe</primary></indexterm>
<indexterm role="cp"><primary>paragraphe, mode</primary></indexterm>
-<para>La commande <literal>\parbox</literal> produit une boîte dont le contenu est créé en
-<firstterm>mode paragraphe</firstterm>. On devrait l&#8217;utiliser pour fabriquer une boîte à
-partir de petits moreaux de texte, avec rien de trop élaboré à
-l&#8217;intérieur. En particulier, vous ne devriez utiliser aucun
-environnement de fabrication de paragraphe au sein de l&#8217;argument
-<replaceable>texte</replaceable> d&#8217;une <literal>\parbox</literal>. Pour des morceaux de texte de plus
-grande taille, y compris ceux comprenant un environnement de
-fabrication de paragraphe, vous devriez utiliser un environnement
-<literal>minipage</literal> (voir <link linkend="minipage">minipage</link>).
-</para>
-<para><literal>\parbox</literal> a deux arguments obligatoires :
-</para>
-<variablelist><varlistentry><term><replaceable>largeur</replaceable>
-</term><listitem><para>la largeur de la parbox;
-</para></listitem></varlistentry><varlistentry><term><replaceable>texte</replaceable>
-</term><listitem><para>le texte qui à mettre dans la parbox.
-</para></listitem></varlistentry></variablelist>
-<para>Par défault &latex; positionne verticallement un parbox de sorte que
-son centre soit aligné avec le centre de la ligne de texte
-alentour. Lorsque l&#8217;argument optionnel <replaceable>position</replaceable> est présent et
-vaut soit &#8216;<literal>t</literal>&#8217; soit &#8216;<literal>b</literal>&#8217;, cela vous permet respectivement
-d&#8217;aligner soit la ligne du haut, soit la ligne du bas de la parbox avec
-la ligne de base du texte alentour. Il est possible de spécifier
-<replaceable>position</replaceable> à &#8216;<literal>m</literal>&#8217; pour avoir le comportement par défaut.
+<para>La commande <literal>\parbox</literal> produit une boîte de texte de largeur
+<literal>largeur</literal>. Cette commande peut être utilisée pour fabriquer une
+boîte à partir de petits morceaux de texte, et contenant un seul
+paragraphe. Cette commande est fragile (see <link linkend="_005cprotect">\protect</link>).
</para>
-<para>L&#8217;argument optionnel <replaceable>hauteur</replaceable> l&#8217;emporte sur la hauteur naturelle de la
-boîte.
-</para>
-<para>L&#8217;argument <replaceable>pos-interne</replaceable> contrôle la position du texte au sein de la
-boîte, comme suit ; s&#8217;il n&#8217;est pas spécifié, <replaceable>position</replaceable> est utilisé.
+<screen>\begin{picture}(0,0)
+ ...
+ \put(1,2){\parbox{4.5cm}{\raggedright Le graphique étant une
+ droite sur une échelle logarithmique, la relation est
+ exponentielle.}}
+\end{picture}
+</screen>
+<para>Le <replaceable>contenu</replaceable> est taité en mode texte (see <link linkend="Modes">Modes</link>) ainsi
+&latex; fait des sauts de ligne de sorte à former un paragraphe. Mais
+il ne fabriquera pas plusieurs paragraphes ; pour cela, utilisez un
+environnement <literal>minipage</literal> (see <link linkend="minipage">minipage</link>).
+</para>
+<para>Les options d&#8217;une <literal>\parbox</literal> (à l&#8217;exception du <replaceable>contenu</replaceable>) sont
+les mêmes que pour une <literal>minipage</literal>. Par commodité on rappelle ces
+options ici plus bas, mais se référer à <link linkend="minipage">minipage</link> pour une
+description complète.
+</para>
+<para>Il y a deux arguments obligatoires. La <replaceable>largeur</replaceable> est une longueur
+rigide (see <link linkend="Lengths">Lengths</link>). Elle règle la largeur de la boîte dans
+laquelle &latex; compose le <literal>contenu</literal>. Le <literal>contenu</literal> est le
+texte qui est placé dans cette boîte. Il ne devrait pas avoir de
+composants qui fabriquent des paragraphes.
+</para>
+<para>Il y a trois arguments optionnels, <replaceable>position</replaceable>, <replaceable>hauteur</replaceable>, et
+<replaceable>pos-interne</replaceable>. La <replaceable>position</replaceable> donne l&#8217;alignement vertical de la
+<firstterm>parbox</firstterm> relativement au texte alentour. La valeurs prises en charge
+sont <literal>c</literal> ou <literal>m</literal> pour que le centre selon la dimension
+verticale de la parbox soit aligné avec le centre de la ligne de texte
+adjacente (c&#8217;est le réglage par défaut), ou <literal>t</literal> pour s&#8217;accorder la
+ligne du haut de la parbox avec la ligne de base du texte alentour, ou
+<literal>b</literal> pour accorder la ligne du bas.
+</para>
+<para>L&#8217;argument optionnel <replaceable>hauteur</replaceable> l&#8217;emporte sur la hauteur naturelle de
+la boîte.
+</para>
+<para>L&#8217;argument optionnel <replaceable>pos-interne</replaceable> contrôle la position du
+<replaceable>contenu</replaceable> au sein de la parbox. Les valeurs possibles sont :
+<literal>t</literal> pour le centrer verticalement, <literal>b</literal> pour le place en bas de
+la boîte, et <literal>s</literal> pour le dilater verticalement (pour cela, le texte
+doit contenir de l&#8217;espace vertical eslastique).
</para>
-<variablelist><varlistentry><term><literal>t</literal>
-</term><listitem><para>le texte est placé en haut de la boîte.
-</para></listitem></varlistentry><varlistentry><term><literal>c</literal>
-</term><listitem><para>le texte est centré dans la boîte.
-</para></listitem></varlistentry><varlistentry><term><literal>b</literal>
-</term><listitem><para>le texte est placé en bas de la boîte.
-</para></listitem></varlistentry><varlistentry><term><literal>s</literal>
-</term><listitem><para>dilatation (stretch) verticale ; le texte doit contenir de l&#8217;espaces
-dilatable verticalement pour que cela fonctionne.
-</para></listitem></varlistentry></variablelist>
-
</sect1>
<sect1 label="20.6" id="_005craisebox">
<title><literal>\raisebox</literal></title>
@@ -8518,10 +10591,10 @@ profondeur naturelles.
<screen>\savebox{<replaceable>\boxcmd</replaceable>}[<replaceable>largeur</replaceable>][<replaceable>pos</replaceable>]{<replaceable>texte</replaceable>}
</screen>
<para>Cette commande compose <replaceable>texte</replaceable> dans une boîte de la même façon
-qu&#8217;avec <literal>\makebox</literal> (voir <link linkend="_005cmakebox">\makebox</link>), à ceci près qu&#8217;au lieu
+qu&#8217;avec <literal>\makebox</literal> (see <link linkend="_005cmakebox">\makebox</link>), à ceci près qu&#8217;au lieu
d&#8217;imprimer la boîte résultante, elle la sauvegarde dans une boîte
étiquettée <replaceable>\boxcmd</replaceable>, ce qui doit avoir été déclaré avec
-<literal>\newsavebox</literal> (voir <link linkend="_005cnewsavebox">\newsavebox</link>).
+<literal>\newsavebox</literal> (see <link linkend="_005cnewsavebox">\newsavebox</link>).
</para>
</sect1>
@@ -8534,10 +10607,10 @@ d&#8217;imprimer la boîte résultante, elle la sauvegarde dans une boîte
<screen>\sbox{<replaceable>\boxcmd</replaceable>}{<replaceable>texte</replaceable>}
</screen>
<para><literal>\sbox</literal> tape <replaceable>texte</replaceable> au sein d&#8217;une boîte tout comme <literal>\mbox</literal>
-(voir <link linkend="_005cmbox">\mbox</link>) à ceci près qu&#8217;au lieu que la boîte résultante soit
+(see <link linkend="_005cmbox">\mbox</link>) à ceci près qu&#8217;au lieu que la boîte résultante soit
incluse dans la sortie normale, elle est sauvegardée dans la boîte
étiquetée <replaceable>\boxcmd</replaceable>. <replaceable>\boxcmd</replaceable> doit avoir été préalablement
-déclarée avec <literal>\newsavebox</literal> (voir <link linkend="_005cnewsavebox">\newsavebox</link>).
+déclarée avec <literal>\newsavebox</literal> (see <link linkend="_005cnewsavebox">\newsavebox</link>).
</para>
</sect1>
@@ -8550,12 +10623,1227 @@ déclarée avec <literal>\newsavebox</literal> (voir <link linkend="_005cnewsave
<screen>\usebox{<replaceable>\boxcmd</replaceable>}
</screen>
<para><literal>\usebox</literal> produit la boîte la plus récemment sauvegardée dans le
-bac <replaceable>\boxcmd</replaceable> par une commande <literal>\savebox</literal> (voir <link linkend="_005csavebox">\savebox</link>).
+bac <replaceable>\boxcmd</replaceable> par une commande <literal>\savebox</literal> (see <link linkend="_005csavebox">\savebox</link>).
+</para>
+</sect1>
+</chapter>
+<chapter label="21" id="Color">
+<title>Couleur</title>
+
+<indexterm role="cp"><primary>couleur</primary></indexterm>
+
+<para>Vous pouvez colorer du texte, des filets, etc. Vous pouvez également
+colorer l&#8217;intérieur d&#8217;une boîte ou une page entière et écrire du texte
+par dessus.
</para>
+<para>La prise en charge des couleurs se fait via un paquetage
+supplementaire. Aussi, toutes les commandes qui suivent ne fonctionnent
+que si le préambule de votre document contient
+<literal>\usepackage{color}</literal>, qui fournit le paquetage standard.
+</para>
+<para>Beaucoup d&#8217;autres paquetages complémentent également les possibilité de
+&latex; en matière de couleurs. Notamment <filename>xcolor</filename> est largement
+utilisé et étend significativement les possibilités décrites ici, y
+compris par l&#8217;ajout des modèles de couleur &#8216;<literal>HTML</literal>&#8217; et &#8216;<literal>Hsb</literal>&#8217;.
+</para>
+
+
+<sect1 label="21.1" id="Color-package-options">
+<title>Options du paquetage <literal>color</literal></title>
+<indexterm role="cp"><primary>color options du paquetage</primary></indexterm>
+<indexterm role="cp"><primary>options, paquetage color</primary></indexterm>
+
+<para>Synopsis (à mettre dans le préambule du document) :
+</para>
+<screen>\usepackage[<replaceable>liste d'option séparées par des virgules</replaceable>]{color}
+</screen>
+<para>Quand vous chargez le paquetage <filename>color</filename> il y a deux types d&#8217;options
+disponbiles.
+</para>
+<para>Le premier spécifie le <firstterm>pilote d&#8217;impression</firstterm>. &latex; ne contient
+pas d&#8217;information sur les diférents système de sortie, mais au lieu de
+cela dépend de l&#8217;information stockée dans un fichier. Normalement vous
+ne devriez pas spécifier les options de pilote dans le document, mais au
+lieu de cela vous vous reposez sur les valeurs par défaut de votre
+système. Un avantage de procéder ainsi est que cela rend votre document
+portable entre systèmes. Pour être complet nous incluons une liste des
+pilotes. Ceux présentement pertinents sont : <filename>dvipdfmx</filename>,
+<filename>dvips</filename>, <filename>dvisvgm</filename>, <filename>luatex</filename>, <filename>pdftex</filename>,
+<filename>xetex</filename>. Les deux pilotes <filename>xdvi</filename> et <filename>oztex</filename> sont pour
+l&#8217;essentiel des alias de <filename>dvips</filename> (et <filename>xdvi</filename> est monochrome).
+Ceux qui ne devraient pas être utilisés pour de nouveaux systèmes récent
+sont : <filename>dvipdf</filename>, <filename>dvipdfm</filename>, <filename>dviwin</filename>, <filename>dvipsone</filename>,
+<filename>emtex</filename>, <filename>pctexps</filename>, <filename>pctexwin</filename>, <filename>pctexhp</filename>,
+<filename>pctex32</filename>, <filename>truetex</filename>, <filename>tcidvi</filename>, <filename>vtex</filename> (et
+<filename>dviwindo</filename> est un alias de <filename>dvipsone</filename>).
+</para>
+<para>Les options du second type, autres que les pilotes, sont listées ci-dessous.
+</para>
+<variablelist>
+<varlistentry><term><literal>monochrome</literal>
+</term><listitem><para>Désactive les commande de couleur, de sorte qu&#8217;elles ne produisent pas
+d&#8217;erreur, mais ne produisent pas non plus de couleurs.
+</para>
+</listitem></varlistentry><varlistentry><term><literal>dvipsnames</literal>
+</term><listitem><para>Rend disponible une liste de 68 noms de couleur qui sont d&#8217;usage
+fréquent, en particulier dans des documents qui ne sont pas modernes.
+Ces noms de couelurs étaient à l&#8217;origine fournis par le pilote
+<filename>dvips</filename>, d&#8217;où le nom de l&#8217;option.
+</para>
+</listitem></varlistentry><varlistentry><term><literal>nodvipsnames</literal>
+</term><listitem><para>Ne charge pas cette liste de noms de couleur, faisant faire à &latex;
+une toute petite économie d&#8217;espace mémoire.
+</para>
+</listitem></varlistentry></variablelist>
+
+</sect1>
+<sect1 label="21.2" id="Color-models">
+<title>Modèles de couleur</title>
+
+<indexterm role="cp"><primary>modèles de couleur</primary></indexterm>
+
+<para>Un <firstterm>modèle de couleur</firstterm> est une façon de représenter les couleurs.
+Les possibilité de &latex; dépendent du pilote d&#8217;impression. Toutefois,
+les pilotes <filename>pdftex</filename>, <filename>xetex</filename>, et <filename>luatex</filename> sont de nos
+jours de loin les plus largement utilisés. Les modèles ci-après
+fonctionnent pour ces pilotes. À une exception près ils sont également
+pris en charge par tous les autre pilotes d&#8217;impression utilisés
+aujourd&#8217;hui.
+</para>
+<para>Il est à noter qu&#8217;une combinaison de couleur peut être additive, ou
+soustractive. Les combinaisons additives mélangent les couleurs de la
+lumière, de sorte que par exemple combiner des instensités pleines de
+rouge, vert et bleu produit du blanc. Les combinaisons soustractives
+mélangent les pigments, tels que les encres, de sorte que combiner des
+intensités pleine de cyan, magenta et jaune produit du noir.
+</para>
+<variablelist><anchor id="color-models-cmyk"/><varlistentry><term><literal>cmyk</literal>
+</term><listitem><para>Un liste séparée de virgule avec quatre nombres réel compris entre 0 et
+1 inclus. Le premier nombre est l&#8217;intensité du cyan, le deuxième celle
+du magenta, et les autres celle du jaune et du noir. Un valeur du
+nombre de 0 signifie l&#8217;intensité minimale, alors que 1 correspond à
+l&#8217;intensité pleine. Ce modèle est fréquemment utilisé pour l&#8217;impression
+de couleur. C&#8217;est un modèle soustractif.
+</para>
+<anchor id="color-models-gray"/></listitem></varlistentry><varlistentry><term><literal>gray</literal>
+</term><listitem><para>Un unique nombre réèl compris entre 0 et 1 inclus. Les couleurs sont
+des nuances de gris. Le nombre 0 produit du noir, alors que le 1 donne
+du blanc.
+<anchor id="color-models-rgb"/></para></listitem></varlistentry><varlistentry><term><literal>rgb</literal>
+</term><listitem><para>Une liste séparée de virgules avec trois nombres réèls compris entre 0
+et 1, inclusive. Le premier nombre est l&#8217;intensité de la composante
+rouge, la deuxième correspond au vert, et la troisière au bleu. Une
+valeur de 0 donnée au nombre signifie qu&#8217;en rien cette composante n&#8217;est
+ajouté à la couleur, alors que 1 signifie que cela est fait à pleine
+intensité. C&#8217;est un modèle additif.
+</para>
+<anchor id="color-models-RGB"/></listitem></varlistentry><varlistentry><term><literal>RGB</literal>
+</term><listitem><para>(pilotes <filename>pdftex</filename>, <filename>xetex</filename>, <filename>luatex</filename>) Une liste séparée
+par des vidugles avec trois entiers compris entre 0 et 255 inclus. Ce
+modèle est une commodité pour utiliser <literal>rgb</literal> étant donnée qu&#8217;en
+dehors de &latex; les couleurs sont souvent décrites dans un modèle
+rouge-vert-bleu utilisant des nombres dans cette plage. Les valeurs
+entrées sont converties vers le modèle <literal>rgb</literal> en divisant par 255.
+</para>
+<anchor id="color-models-named"/></listitem></varlistentry><varlistentry><term><literal>named</literal>
+</term><listitem><para>On accède au couleur par des noms tels que &#8216;<literal>PrussianBlue</literal>&#8217;. La
+liste des noms dépend du pilote, mais tous prennennt en charge les noms
+&#8216;<literal>black</literal>&#8217;, &#8216;<literal>blue</literal>&#8217;, &#8216;<literal>cyan</literal>&#8217;, &#8216;<literal>green</literal>&#8217;, &#8216;<literal>magenta</literal>&#8217;,
+&#8216;<literal>red</literal>&#8217;, &#8216;<literal>white</literal>&#8217;, et &#8216;<literal>yellow</literal>&#8217; (Voir l&#8217;option
+<literal>dvipsnames</literal> dans <link linkend="Color-package-options">Color package options</link>).
+</para>
+</listitem></varlistentry></variablelist>
</sect1>
+<sect1 label="21.3" id="Commands-for-color">
+<title>Commandes pour <literal>color</literal></title>
+
+<indexterm role="cp"><primary>color, commandes du paquetage</primary></indexterm>
+
+<para>Voici les commandes disponibles avec le paquetage <filename>color</filename>.
+</para>
+
+
+<sect2 label="21.3.1" id="Define-colors">
+<title>Definir des couleurs</title>
+
+<indexterm role="cp"><primary>couleur</primary></indexterm>
+<indexterm role="cp"><primary>définir une couleur</primary></indexterm>
+<indexterm role="cp"><primary>couleur, définir</primary></indexterm>
+
+<para>Synopsis :
+</para>
+<screen>\definecolor{<replaceable>nom</replaceable>}{<replaceable>model</replaceable>}{<replaceable>spécification</replaceable>}
+</screen>
+<para>Donne le nom <replaceable>nom</replaceable> à la couleur. Par exemple, après
+<literal>\definecolor{silver}{rgb}{0.75,0.75,0.74}</literal> vous pouvez
+utiliser cette couleur avec <literal>Hé ho,
+\textcolor{silver}{Silver}~!</literal>.
+</para>
+<para>Cet exemple donne à la couleur un nom plus abstrait, de sort qu&#8217;on
+puisse la changer sans que cela prête à confusion.
+</para>
+<screen>\definecolor{logocolor}{RGB}{145,92,131} % RGB nécessite pdflatex
+\newcommand{\logo}{\textcolor{logocolor}{Les Brioches de Robert}}
+</screen>
+<para>Il est fréquent que les couleurs d&#8217;un document soient définies dans son
+préambule, ou dans sa classe
+<!-- différence entre classe et style ? -->
+ou style, plutôt que dans le corps du document.
+</para>
+</sect2>
+<sect2 label="21.3.2" id="Colored-text">
+<title>Mettre du texte en couleur</title>
+
+<indexterm role="cp"><primary>couleur</primary></indexterm>
+<indexterm role="cp"><primary>coloré, texte</primary></indexterm>
+<indexterm role="cp"><primary>texte en couleur</primary></indexterm>
+
+<para>Synopsis :
+</para>
+<screen>\textcolor{<replaceable>nom</replaceable>}{...}
+\textcolor[<replaceable>modèle de couleur</replaceable>]{<replaceable>spécification de couleur</replaceable>}{...}
+</screen>
+<para>ou
+</para>
+<screen>\color{<replaceable>nom</replaceable>}
+\color[<replaceable>modèle de couleur</replaceable>]{<replaceable>spécification</replaceable>}
+</screen>
+<para>Le texte affecté prend la couleur correspondante. La ligne suivante
+</para>
+<screen>\textcolor{magenta}{Je suis Ozymandias, roi des rois~:} Voyez mon œuvre, ô puissants, et desespérez~!
+</screen>
+<para>met la première moitié en magenta alors que le reste est en noir. Vous
+pouvez utiliser une couleur déclarée avec <literal>\definecolor</literal> exactement
+de la même façon dont nous venons d&#8217;utiliser la couleur prédéfinie
+&#8216;<literal>magenta</literal>&#8217;.
+</para>
+<screen>\definecolor{CriseDeLaQuarantaine}{rgb}{1.0,0.11,0.0}
+Je considère l'idée de m'acheter une \textcolor{CriseDeLaQuarantaine}{voiture de sport}.
+</screen>
+<para>Les deux formes de commandes <literal>\textcolor</literal> et <literal>\color</literal>
+diffèrent en ce que la première forme prend le texte à colorer en
+argument. Ceci est souvent plus commode, ou tout du moins plus
+explicite. La seconde forme est une déclaration, comme dans <literal>La
+lune est composé de fromage {\color{vert}}</literal>, de sorte qu&#8217;elle est en
+vigueur jusqu&#8217;à la fin du groupe ou de l&#8217;environnement courant. Ceci
+est parfois utile quand on écrit des macros, ou comme ci-dessous où on
+colore tout le contenu de l&#8217;environnement <literal>center</literal>, y compris les
+lignes verticales et horizontales.
+</para>
+<screen>\begin{center} \color{blue}
+ \begin{tabular}{l|r}
+ HG &amp;HD \\ \hline
+ BG &amp;BD
+ \end{tabular}
+\end{center}
+</screen>
+<para>Vous pouvez utiliser des couleurs dans les équations. Un document peut
+avoir <literal>\definecolor{couleurvedette}{RGB}{225,15,0}</literal> dans le
+préambule, et ensuite contenir cette équation :
+</para>
+<screen>\begin{equation}
+ \int_a^b \textcolor{couleurvedette}{f'(x)}\,dx=f(b)-f(a)
+\end{equation}
+</screen>
+<para>Typiquement les couleurs utilisées dans un document sont déclarée dans
+une classe ou dans un style mais il arrive qu&#8217;on désire fonctionner au
+coup par coup. C&#8217;est le cas d&#8217;usage des secondes forme du synopsis.
+</para>
+<screen>Des couleurs de \textcolor[rgb]{0.33,0.14,0.47}{violet} et {\color[rgb]{0.72,0.60,0.37}doré} pour l'équipe
+</screen>
+<para>Le format de <replaceable>spécification de couleur</replaceable> dépend du modèle de couleur
+(see <link linkend="Color-models">Color models</link>). Par exemple, alors que <literal>rgb</literal> prend trois
+nombbres, <literal>gray</literal> n&#8217;en prend qu&#8217;un.
+</para>
+<screen>La sélection a été \textcolor[gray]{0.5}{grisée}.
+</screen>
+<para>Des couleurs au sein d&#8217;autres couleurs ne se combinent pas. Ainsi
+</para>
+<screen>\textcolor{green}{une sorte de \textcolor{blue}{bleu}}
+</screen>
+<para>se termine par un mot en bleu, et non pas dans une combinaison de bleu
+et de vert.
+</para>
+<!-- xx address coloring a line of a table? -->
+
+
+</sect2>
+<sect2 label="21.3.3" id="Colored-boxes">
+<title>Faire des boîtes en couleur</title>
+
+<indexterm role="cp"><primary>couleur</primary></indexterm>
+<indexterm role="cp"><primary>colorées, boîtes</primary></indexterm>
+<indexterm role="cp"><primary>boîtes colorées</primary></indexterm>
+
+<para>Synopsis :
+</para>
+<screen>\colorbox{<replaceable>nom</replaceable>}{...}
+\colorbox[<replaceable>nom modèle</replaceable>]{<replaceable>spécification couleur arrière-plan boîte</replaceable>}{...}
+</screen>
+<para>ou
+</para>
+<screen>\fcolorbox{<replaceable>couleur cadre</replaceable>}{<replaceable>couleur arrière-plan boîte</replaceable>}{...}
+\fcolorbox[<replaceable>nom modèle</replaceable>]{<replaceable>spécification couleur cadre</replaceable>}{<replaceable>spécification arrière-plan boîte</replaceable>}{...}
+</screen>
+<para>Fabrique une boite avec la couleur d&#8217;arrière-plan indiquée. La commande <literal>\fcolorbox</literal>
+place un cadre autour de la boîte. Par exemple ceci :
+</para>
+<screen>Nom~:~\colorbox{cyan}{\makebox[5cm][l]{\strut}}
+</screen>
+<para>fabrique une boîte de couleur cyanqui fait cinqu centimètres de long et
+dont la profondeur et la hauteur sont déterminées par le <literal>\strut</literal>
+(de sorte que la profondeur est <literal>-.3\baselineskip</literal> et la hauteur
+est <literal>\baselineskip</literal>). Ceci met un texte blanc sur un arrière plan
+bleu :
+</para>
+<screen>\colorbox{blue}{\textcolor{white}{Welcome to the machine.}}
+</screen>
+<para>La commande <literal>\fcolorbox</literal> utilise les mêmes paramètres que
+<literal>\fbox</literal> (see <link linkend="_005cfbox-and-_005cframebox">\fbox and \framebox</link>), à savoir <literal>\fboxrule</literal> et
+<literal>\fboxsep</literal>, pour régler l&#8217;épaisseur du filet et de la séparation
+entre l&#8217;intérieur de la boîte et le filet l&#8217;entourant. Les valeurs par
+défaut de &latex; sont <literal>0.4pt</literal> et <literal>3pt</literal> respectivement.
+</para>
+<para>L&#8217;exemple suivant change l&#8217;épaisseur de la bordure en 0,8 points.
+Notez qu&#8217;il est entre accolades de sorte que le changement cesse d&#8217;être
+en vigueur à la fin de la seconde ligne.
+</para>
+<screen>{\setlength{\fboxrule}{0.8pt}
+\fcolorbox{black}{red}{En aucun cas ne tournez cette poignée.}}
+</screen>
+</sect2>
+<sect2 label="21.3.4" id="Colored-pages">
+<title>Faire des pages en couleur</title>
+
+<indexterm role="cp"><primary>couleur</primary></indexterm>
+<indexterm role="cp"><primary>colorée, page</primary></indexterm>
+<indexterm role="cp"><primary>page colorée</primary></indexterm>
+<indexterm role="cp"><primary>arrière-plan coloré</primary></indexterm>
+
+<para>Synopsis :
+</para>
+<screen>\pagecolor{<replaceable>nom</replaceable>}
+\pagecolor[<replaceable>modèle de couleur</replaceable>]{<replaceable>spécification de couleur</replaceable>}
+\nopagecolor
+</screen>
+<para>Les deux premières commandes règlent l&#8217;arrière-plan de la page, et de
+toutes les pages suivantes, à la couleur indiquée. Pour une explication
+de la spécification dans la seconde forme see <link linkend="Colored-text">Colored text</link>. La
+troisième fait revenir l&#8217;arrière-plan à la normale, c-à-d. un
+arrière-plan transparent. (Si cela n&#8217;est pas pris en charge, alors
+utilisez <literal>\pagecolor{white}</literal>, bien que cela produit un
+arrière-plan blanc au lieu de l&#8217;arrière-plan transparent par défaut.)
+</para>
+<screen> ...
+\pagecolor{cyan}
+ ...
+\nopagecolor
+</screen>
+
+</sect2>
+</sect1>
</chapter>
-<chapter label="21" id="Special-insertions">
+<chapter label="22" id="Graphics">
+<title>Graphiques</title>
+
+<indexterm role="cp"><primary>graphiques</primary></indexterm>
+<indexterm role="cp"><primary>graphics, paquetage</primary></indexterm>
+
+<para>Vous pouvez utiliser des graphiques tel que des fichier PNG ou PDF dans
+vos documents &latex;. Vous aurez besoin d&#8217;un paquetage supplémentaire
+standard de &latex;. Cet exemple montre en bref comment :
+</para>
+<screen>\include{graphicx} % dans le préambule
+ ...
+\includegraphics[width=0.5\linewidth]{graphique.pdf}
+</screen>
+<para>Pour utiliser les commandes décrite ici, le préambule de votre document
+doit contenir soit <literal>\usepackage{graphicx}</literal>, soit
+<literal>\usepackage{graphics}</literal>. (Le plus souvent, c&#8217;est <filename>graphicx</filename>
+qui est préférable.)
+</para>
+<para>Les graphiques peuvent être de deux types, matriciels ou vectoriels.
+&latex; peut utiliser les deux. Dans les graphiques matriciels le
+fichier comprend pour chaque position dans un tableau une entrée
+décrivant la couleur de celle-ci. Un exemple de ceci est une
+photograpgie en format JPG. Dans une graphique vectoriel, le fichier
+contient une liste d&#8217;instructions telles que &#8216;<literal>dessin un cercle avec
+tel rayon et tel centre</literal>&#8217;. Un exemple de ceci est le dessin d&#8217;une ligne
+produit par le programme Asymptote en format PDF. En général les
+graphiques vectoriel sont plus utiles car on peut les redimensionner
+sans pixélisation ou autres problèmes, et parce que la plupart du temps
+ils ont une taille plus petites.
+</para>
+<para>Il y a des systèmes particulièrement bien adapté pour produire des
+graphiques pour un document &latex;. Par exemple, qui vous permettent
+d&#8217;utiliser les mêmes polices que dans votre document. &latex; comprend
+un environnement <literal>picture</literal> (see <link linkend="picture">picture</link>) qui a des possibilités
+de base. En plus de cela, il y a d&#8217;autres façons d&#8217;inclure des
+commandes de production de graphiques dans le document. Deux systèmes
+pour cela sont les paquetages PSTricks et TikZ. Il y a aussi des
+systèmes externe à &latex; qui génèrent un graphique qu&#8217;on peut inclure
+en utilisant les commandes de ce chapitre. Il y a aussi deux autres
+systèmes qui utilisent un langage de programmation : Asymptote et
+MetaPost. Encore un autre système qui utilise une interface graphique :
+Xfig. Une description complète des ces systèmes est hors du champ
+d&#8217;application de ce document ; reportez vous à leur documentation sur le
+CTAN.
+</para>
+
+
+<sect1 label="22.1" id="Graphics-package-options">
+<title>Options du paquetage <literal>graphics</literal></title>
+
+<indexterm role="cp"><primary>graphics, options du paquetage</primary></indexterm>
+<indexterm role="cp"><primary>options, paquetage graphics</primary></indexterm>
+
+<para>Synopsis (à placer dans le préambule du document) :
+</para>
+<screen>\usepackage[<replaceable>liste d'option séparée par des virgules</replaceable>]{graphics}
+</screen>
+<para>ou
+</para>
+<screen>\usepackage[<replaceable>liste d'option séparée par des virgules</replaceable>]{graphicx}
+</screen>
+<para>Le paquetage <literal>graphicx</literal> a un format pour les arguments optionnels
+passés à <literal>\includegraphics</literal> qui est commode (c&#8217;est le format
+clef/valeur), ainsi c&#8217;est le meilleur des deux choix pour les nouveaux
+documents. Quand vous chargez les paquetages <filename>graphics</filename> ou
+<literal>graphicx</literal> avec <literal>\usepackage</literal> il y a deux sortes d&#8217;options
+disponibles.
+</para>
+<para>La première est que &latex; ne contient pas d&#8217;information concernant
+les différents systèmes de sortie, mais au lieu de cela dépend de
+l&#8217;informtion stockée dans un fichier <firstterm>pilote d&#8217;impression</firstterm>.
+Normalment vous ne devriez pas spécifier l&#8217;option de pilote dans le
+document, mais au lieu de cela vous reposer sur les valeurs par défaut
+du système. Un avantage de procéder ainsi et que cela rend les documents
+portables entre systèmes.
+</para>
+<para>Pour être complet voici une liste des pilotes. Ceux qui sont
+actuellement pertinents sont : <filename>dvipdfmx</filename>, <filename>dvips</filename>,
+<filename>dvisvgm</filename>, <filename>luatex</filename>, <filename>pdftex</filename>, <filename>xetex</filename>. Les deux
+pilotes <filename>xdvi</filename> and <filename>oztex</filename> sont essentiellement des alias de
+<filename>dvips</filename> (et <filename>xdvi</filename> est monochrome). Ceux qu&#8217;on ne devrait pas
+utiliser pour de nouveaux systèmes sont : <filename>dvipdfmx</filename>, <filename>dvips</filename>,
+<filename>dvisvgm</filename>, <filename>luatex</filename>, <filename>pdftex</filename>, <filename>xetex</filename>. Les deux
+pilotes <filename>xdvi</filename> et <filename>oztex</filename> sont essentiellement des alias de
+<filename>dvips</filename> (et <filename>xdvi</filename> est monochrome). Ceux qui ne devraient pas
+être utilisés pour de nouveaux systèmes sont : <filename>dvipdf</filename>,
+<filename>dvipdfm</filename>, <filename>dviwin</filename>, <filename>dvipsone</filename>, <filename>emtex</filename>,
+<filename>pctexps</filename>, <filename>pctexwin</filename>, <filename>pctexhp</filename>, <filename>pctex32</filename>,
+<filename>truetex</filename>, <filename>tcidvi</filename>, <filename>vtex</filename> (et <filename>dviwindo</filename> est un
+alias de <filename>dvipsone</filename>). Ces pilotes sont stockés dans des fichiers
+avec une extension <filename>.def</filename>, tels que <filename>pdftex.def</filename>.
+</para>
+<para>La seconde sorte d&#8217;options est décrite ci-après.
+</para>
+<variablelist><varlistentry><term><literal>demo</literal>
+</term><listitem><para>Au lieu d&#8217;un fichier d&#8217;image, &latex; met un rectangle de 150 pt
+sur 100 pt (à moins qu&#8217;une autre taille soit spécifiée dans la
+commande <literal>\includegraphics</literal>).
+</para>
+</listitem></varlistentry><varlistentry><term><literal>draft</literal>
+</term><listitem><para>Aucun des fichier grahpique n&#8217;est affiché, mais au lieu de cela le nom
+du fichier est imprimé au sein d&#8217;une boîte de la bonne taille. De sorte
+à ce que la taille soit déterminée, le fichier doit être présent.
+</para>
+</listitem></varlistentry><varlistentry><term><literal>final</literal>
+</term><listitem><para>(Option par défaut) L&#8217;emporte sur toute options <literal>draft</literal> précédente,
+de sorte que le document afficher le contenu des fichiers graphiques.
+</para>
+</listitem></varlistentry><varlistentry><term><literal>hiderotate</literal>
+</term><listitem><para>Ne montre pas le texte ayant subi une rotation. (Ceci permet d&#8217;utiliser
+une visionneuse ne prenant pas en charge le texte ayant subi une
+rotation).
+<!-- what does it show? -->
+</para>
+</listitem></varlistentry><varlistentry><term><literal>hidescale</literal>
+</term><listitem><para>Ne montre pas le texte rétréci/dilaté. (Ceci permet d&#8217;utiliser une
+visionneuse ne prenant pas en charge le texte ayant subi un
+rétrécissment/une dilatation.)
+<!-- what does it show? -->
+</para>
+</listitem></varlistentry><varlistentry><term><literal>hiresbb</literal>
+</term><listitem><para>Dans un fichier PS ou EPS la taille du graphique peut être spécifiée de
+deux façons. Les lignes <literal>%%BoundingBox</literal> décrivent la taille du
+graphique en utilisant des multiples entiers d&#8217;un point PostScript,
+c-à-d. des multiples entiers d&#8217; 1/72 de pouce. Une addition plus
+récente au langage PostScript autorise les multiples décimaux, tel que
+1.23, dans les lignes <literal>%%HiResBoundingBox</literal>. Cette option fait que
+&latex; lit la taille à partir de <literal>%%HiResBoundingBox</literal> plutôt que
+de <literal>%%BoundingBox</literal>.
+</para>
+</listitem></varlistentry></variablelist>
+</sect1>
+<sect1 label="22.2" id="Graphics-package-configuration">
+<title>Configuration du paquetage <literal>graphics</literal></title>
+
+<indexterm role="cp"><primary>graphics</primary></indexterm>
+<indexterm role="cp"><primary>graphics, paquetage</primary></indexterm>
+<indexterm role="cp"><primary>configuration du paquetage graphics</primary></indexterm>
+<indexterm role="cp"><primary>EPS, fichiers</primary></indexterm>
+<indexterm role="cp"><primary>JPEG, fichiers</primary></indexterm>
+<indexterm role="cp"><primary>JPG, fichiers</primary></indexterm>
+<indexterm role="cp"><primary>PDF, fichiers graphiques</primary></indexterm>
+<indexterm role="cp"><primary>PNG, fichiers</primary></indexterm>
+
+<para>Ces commandes configurent la façon dont &latex; recherche le graphique
+dans le système le fichier.
+</para>
+<para>Le comportement du code de recherche dans le système de fichier dépend
+nécessairement de la plateforme. Dans ce document nous couvrons
+GNU/Linux, Macintosh, et Windows, étant donné que ces systèmes ont des
+configurations typiques. Pour les autres situations consultez la
+documentation dans <filename>grfguide.pdf</filename>, ou le source &latex;, ou la
+documentationn de votre distribution &tex;.
+</para>
+
+
+<sect2 label="22.2.1" id="_005cgraphicspath">
+<title><literal>\graphicspath</literal></title>
+
+<indexterm role="fn"><primary>\graphicspath</primary></indexterm>
+
+<para>Synopsis :
+</para>
+<screen>\graphicspath{<replaceable>liste des répertoires entre les accolades</replaceable>}
+</screen>
+<para>Déclare une liste de répertoires dans lesquels rechercher des fichiers
+graphiques. Ceci permet d&#8217;écrire plus tard quelque chose du genre de
+<literal>\includegraphics{lion.png}</literal> au lieu de donner son chemin.
+</para>
+<para>&latex; recherche toujours en premier les fichiers graphiques dans le
+répertoire courant (et dans le répertoire de sortie, si spécifié ;
+see <link linkend="output-directory">output directory</link>). La déclaration ci-dessous dit au système de
+regarder ensuite dans le sous-répertoire <filename>img</filename>, et ensuite
+<filename>../img</filename>.
+</para>
+<screen>\usepackage{graphicx} % ou graphics; à mettre dans le préambule
+ ...
+\graphicspath{ {img/} {../img/} }
+</screen>
+<para>La déclaration <literal>\graphicspath</literal> est optionnelle. Si vous ne
+l&#8217;incluez pas, alors le comportement par défaut de &latex; est de
+rechercher dans tous les endroits où il recherche d&#8217;habitude un fichier
+(il utilise la commande <literal>\input@path</literal> de &latex;). En
+particulier, dans ce cas l&#8217;un l&#8217;un des endroit où il regarde est le
+répertoire courant.
+</para>
+<para>Mettez chaque nom de répertoire entre accolades ; en particulier,
+ci-dessus on a écrit &#8216;<literal><literal>{img}</literal></literal>&#8217;. Faites ainsi même si il n&#8217;y
+a qu&#8217;un seul répertoire. Chaque nom de répertoire doit se terminer par
+une oblique vers l&#8217;avant <filename>/</filename>. Ceci est vrai même sur Windows, où
+la bonne pratique est d&#8217;utilise des obliques vers l&#8217;avant pour tous les
+séparateur de répertoire puisque cela rend le document portable vers
+d&#8217;autres plateformes. Si vous avez des espace dans votre nom de
+répertoire alors utilisez des guillemets anglais, comme dans
+<literal>{&quot;mes docs/&quot;}</literal>. Enfreindre l&#8217;une de ces règles aura pour effet
+que &latex; rapportera une erreur <literal>Error: File `<replaceable>filename</replaceable>' not found</literal>.
+</para>
+<para>Pour faire simple, l&#8217;algorithme est que dans l&#8217;exemple qui suit, après
+avoir regardé dans le répertoire courant,
+</para>
+<screen>\graphicspath{ {img/} {../img/} }
+...
+\usepackage{lion.png}
+</screen>
+<para>pour chacun des répertoires listés, &latex; le concatène avec le nom du
+fichier et recherche le fichier ainsi nommé, eh cherchant
+<filename>img/lion.png</filename> et puis <filename>../img/lion.png</filename>. Cet algorithme
+signifie que la commande <literal>\graphicspath</literal> ne recherche pas
+récursivement dans les sous-répertoires : si vous faites
+<literal>\graphicspath{{a/}}</literal> et que le graphique est dans
+<filename>a/b/lion.png</filename> alors &latex; ne le trouvera pas. Cela signifie
+aussi que vous pouvez utiliser des chemins absolus tels que
+<literal>\graphicspath{{/home/jim/logos/}}</literal> ou
+<literal>\graphicspath{{C:/Users/Albert/Pictures/}}</literal>. Toutefois, faire
+cela rend votre document non portable. (Vous pourriez préserver la
+portabilité en ajustant vos le paramètre <literal>TEXINPUTS</literal> du fichier de
+configuration des réglages système &tex; ; voir la documentation de
+votre système).
+</para>
+<para>Vous pouvez utiliser <literal>\graphicspath</literal> n&#8217;improte-où dans le
+document. Vous pouvez l&#8217;utiliser plus d&#8217;une fois. Sa valeur peut être
+affichée avec <literal>\makeatletter\typeout{\Ginput@path}\makeatother</literal>.
+</para>
+<para>Les répertoires sont à donner relativement au fichier de base. Pour
+faire clair, supposez que vous travaillez sur un document basé sur
+<filename>livre/livre.tex</filename> et qu&#8217;il contienne
+<literal>\include{chapitres/chap1}</literal>. Si dans <filename>chap1.tex</filename> vous
+mettez <literal>\graphicspath{{graphiques/}}</literal> alors &latex; ne
+cherchera pas les graphiques dans <filename>livre/chapitres/graphiques</filename>,
+mais dans <filename>livre/graphiques</filename>.
+</para>
+
+</sect2>
+<sect2 label="22.2.2" id="_005cDeclareGraphicsExtensions">
+<title><literal>\DeclareGraphicsExtensions</literal></title>
+
+<indexterm role="fn"><primary>\DeclareGraphicsExtensions</primary></indexterm>
+
+<para>Synopsis :
+</para>
+<screen>\DeclareGraphicsExtensions{<replaceable>liste séparée par des virgules d'extentions de fichier</replaceable>}
+</screen>
+<para>Déclare les extensions de nom de fichier à essayer. Ceci vous permet de
+spécifier l&#8217;ordre dans lequel les formats graphiques sont choisis quant
+les fichiers graphiques sont inclus en donnant le nom de fichier sans
+l&#8217;extension, comme dans <literal>\includegraphics{courbe_de_fonction}</literal>.
+</para>
+<para>Dans l&#8217;exemple qui suit, &latex; trouve les fichiers au format PNG
+avant les fichiers PDF.
+</para>
+<screen>\DeclareGraphicsExtensions{.png,PNG,.pdf,.PDF}
+ ...
+\includegraphics{lion} % trouve <filename>lion.png</filename> avant <filename>lion.pdf</filename>
+</screen>
+<para>Du fait que le nom <filename>lion</filename> ne contient pas de point, &latex;
+utilise la liste d&#8217;extension. Pour chacun des répertoires dans la liste
+de chemins graphiques (see <link linkend="_005cgraphicspath">\graphicspath</link>), &latex; essaie les
+extensions dans l&#8217;ordre donné. S&#8217;il ne trouve aucun fichier
+correspondant après avoir essayé tous les répertoires et toutes les
+extensions, alors il renvoie une erreur &#8216;<literal>! LaTeX Error: File
+`<filename>lion</filename>' not found</literal>&#8217;. Notez que vous devez inclure le point au
+début de chaque extension.
+</para>
+<para>Du fait que les noms de fichiers sous GNU/Linux et Macintosh sont
+sensibles à la casse, la liste des extensions de fichier est sensible à
+la casse sur ces plateformes. La plateforme Windows n&#8217;est pas sensible
+à la casse.
+</para>
+<para>Vous n&#8217;êtes pas tenu d&#8217;inclure <literal>\DeclareGraphicsExtensions</literal> dans
+votre document ; le pilote d&#8217;impression a une valeur par défaut
+raisonnable. Par exemple, la version la plus récente de
+<filename>pdftex.def</filename> a cette liste d&#8217;extensions.
+</para>
+<screen>.png,.pdf,.jpg,.mps,.jpeg,.jbig2,.jb2,.PNG,.PDF,.JPG,.JPEG,.JBIG2,.JB2
+</screen>
+<para>Vous pouvez utiliser cette commande n&#8217;importe où dans le document. Vous
+pouvez l&#8217;utiliser plus d&#8217;une fois. On peut afficher la valeur courante
+avec <literal>\makeatletter\typeout{\Gin@extensions}\makeatother</literal>.
+</para>
+
+</sect2>
+<sect2 label="22.2.3" id="_005cDeclareGraphicsRule">
+<title><literal>\DeclareGraphicsRule</literal></title>
+
+<indexterm role="fn"><primary>\DeclareGraphicsRule</primary></indexterm>
+
+<para>Synopsis :
+</para>
+<screen>\DeclareGraphicsRule{<replaceable>extension</replaceable>}{<replaceable>type</replaceable>}{<replaceable>extension taille-fic</replaceable>}{<replaceable>commande</replaceable>}
+</screen>
+<para>Declare comment gérer les fichiers graphiques dont le nom se termine en
+<replaceable>extension</replaceable>.
+</para>
+<para>L&#8217;exemple suivant déclare que tous le fichiers dont ele est de la forme
+<filename>nomfichier-sans-point.mps</filename> doivent être traité comme une sortie de
+MetaPost, ce qui signifie que le pilote d&#8217;impression utilisera son code
+de gestion MetaPost pour traiter le fichier en entrée.
+</para>
+<screen>\DeclareGraphicsRule{.mps}{mps}{.mps}{}
+</screen>
+<para>La déclaration suivante
+</para>
+<screen>\DeclareGraphicsRule{*}{mps}{*}{}
+</screen>
+<para>dit à &latex; qu&#8217;il doit traiter comme une sortie MetaPost tout fichier
+avec extension non couverte par une autre règle, ainsi il couvre
+<filename>nomfichier.1</filename>, <filename>nomfichier.2</filename>, etc.
+</para>
+<para>Ici on décrit les quatre arguments.
+</para>
+<variablelist><varlistentry><term><replaceable>extension</replaceable>
+</term><listitem><para>L&#8217;extension de nom de fichier à laquelle la règle considérée
+s&#8217;applique. L&#8217;extension commence au premier point dans le nom de
+fichier, en incluant le point. Utiliser l&#8217;astérisque, <literal>*</literal>, pour
+désigner la comportement par défaut pour toutes les extensions non
+déclarées.
+</para>
+</listitem></varlistentry><varlistentry><term><replaceable>type</replaceable>
+</term><listitem><para>Le type du fichier considéré. Ce type est une chaîne de caractères qui
+doit être définie dans le pilote d&#8217;impression. Par exemple, les fichiers
+avec les extensions <filename>.ps</filename>, <filename>.eps</filename>, ou <filename>.ps.gz</filename> peuvent
+tous être classifiés sous le type <literal>eps</literal>. Tous les fichiers de même
+type sont traités en entrée avec la même commande interne par le pilote
+d&#8217;impression. Par exemple, les types de fichiers reconnus par
+<filename>pdftex</filename> sont : <literal>jpg</literal>, <literal>jbig2</literal>, <literal>mps</literal>, <literal>pdf</literal>,
+<literal>png</literal>, <literal>tif</literal>.
+</para>
+</listitem></varlistentry><varlistentry><term><replaceable>extension taille-fic</replaceable>
+</term><listitem><para>L&#8217;extension du fichier à lire pour déterminer la taille du graphique, si
+un tel fichier existe. Elle peut être la même que <replaceable>extension</replaceable> mais
+aussi être différente.
+</para>
+<para>Considérons par exemple un graphique PostScript. Pour le rendre plus
+petit, il peut être compressé en un fichier <filename>.ps.gz</filename>. Les fichiers
+compressé ne sont pas lu simplement par &latex; aussi vous pouvez
+mettre l&#8217;information de boîte englobante dans une fichier séparé. Si
+<replaceable>extension taille-fic</replaceable> est vide, alors vous devez spécifier
+l&#8217;information de taill dans les arguments de <literal>\includegraphics</literal>.
+</para>
+<para>Si le fichier pilote a un procédure pour lire les tailles de fichier
+pour <literal>type</literal> alors elle est utilisée, sinon il utilise la procédure
+pour lire les fichiers <filename>.eps</filename>. (Ainsi vous pourriez spécifier la
+taille d&#8217;un fichier bitmap dans un fichier avec une ligne
+<literal>%%BoundingBox</literal> de style PostScript style si aucun autre format
+n&#8217;est disponible).
+</para>
+</listitem></varlistentry><varlistentry><term><replaceable>commande</replaceable>
+</term><listitem><para>Une commande à appliquer au fichier. La plupart du temps on laisse cet
+argument vide. Cette commande doit commencer avec un caractère accent
+grave. Ainsi,
+<literal>\DeclareGraphicsRule{.eps.gz}{eps}{.eps.bb}{`gunzip -c
+#1}</literal> spécifie que tout fichier ayant une extension <filename>.eps.gz</filename> doit
+être traité comme un fichier <literal>eps</literal>, avec l&#8217;information de boîte
+englobante stockée dans le fichier ayant l&#8217;extension <filename>.eps.bb</filename>, et
+que la commande <literal>gunzip -c</literal> sera exécuté sur votre plateforme pour
+décompresser le fichier.
+</para>
+<para>Une telle commande est spécifique à votre plateforme. De plus, votre
+système &tex; doit autoriser l&#8217;exécution de commandes externes ; par
+mesure de sécurité les système moderne restreigne l&#8217;exécution de
+commandes à moins que vous l&#8217;autorisiez explicitement. Se référer à la
+documentation de votre distribution &tex;.
+</para>
+</listitem></varlistentry></variablelist>
+</sect2>
+</sect1>
+<sect1 label="22.3" id="Commands-for-graphics">
+<title>Commandes du paquetage <literal>graphics</literal></title>
+
+<indexterm role="cp"><primary>graphics, commandes du paquetage</primary></indexterm>
+<indexterm role="cp"><primary>commandes, paquetage graphics</primary></indexterm>
+
+<para>Voici les commandes disponibles dans les paquetages <filename>graphics</filename> et
+<filename>graphicx</filename>.
+</para>
+
+
+<sect2 label="22.3.1" id="_005cincludegraphics">
+<title><literal>\includegraphics</literal></title>
+
+<indexterm role="cp"><primary>graphiques</primary></indexterm>
+<indexterm role="cp"><primary>graphics, paquetage</primary></indexterm>
+<indexterm role="cp"><primary>inclure des graphiques</primary></indexterm>
+<indexterm role="cp"><primary>importer des graphiques</primary></indexterm>
+<indexterm role="cp"><primary>EPS, fichiers</primary></indexterm>
+<indexterm role="cp"><primary>JPEG, fichiers</primary></indexterm>
+<indexterm role="cp"><primary>JPG, fichiers</primary></indexterm>
+<indexterm role="cp"><primary>PDF, fichiers graphiques</primary></indexterm>
+<indexterm role="cp"><primary>PNG, fichiers</primary></indexterm>
+<indexterm role="fn"><primary>\includegraphics</primary></indexterm>
+
+<para>Synopsis pour le paquetage <filename>graphics</filename> :
+</para>
+<screen>\includegraphics{<replaceable>nomfichier</replaceable>}
+\includegraphics[<replaceable>urx</replaceable>,<replaceable>ury</replaceable>]{<replaceable>nomfichier</replaceable>}
+\includegraphics[<replaceable>llx</replaceable>,<replaceable>lly</replaceable>][<replaceable>urx</replaceable>,<replaceable>ury</replaceable>]{<replaceable>nomfichier</replaceable>}
+\includegraphics*{<replaceable>nomfichier</replaceable>}
+\includegraphics*[<replaceable>urx</replaceable>,<replaceable>ury</replaceable>]{<replaceable>nomfichier</replaceable>}
+\includegraphics*[<replaceable>llx</replaceable>,<replaceable>lly</replaceable>][<replaceable>urx</replaceable>,<replaceable>ury</replaceable>]{<replaceable>nomfichier</replaceable>}
+</screen>
+<para>Synopsis pour le paquetage <filename>graphicx</filename> :
+</para>
+<screen>\includegraphics{<replaceable>nomfichier</replaceable>}
+\includegraphics[<replaceable>liste-à-clefs-valeurs</replaceable>]{<replaceable>nomfichier</replaceable>}
+\includegraphics*{<replaceable>nomfichier</replaceable>}
+\includegraphics*[<replaceable>liste-à-clefs-valeurs</replaceable>]{<replaceable>nomfichier</replaceable>}
+</screen>
+<para>Inclut un fichier graphique. La forme étoilée <literal>\includegraphics*</literal>
+rogne le graphique à la taille spécifiée, alors que pour la forme
+non-étoilée toute partie du graphiqe en dehors de la boîte de la taille
+spécifiée se superpose à ce qui l&#8217;entoure.
+</para>
+<para>Dans cet exemple
+</para>
+<screen>\usepackage{graphicx} % dans le préambule
+ ...
+\begin{center}
+ \includegraphics{trace.pdf}
+\end{center}
+</screen>
+<para>on incorpore dans le document le graphique dans <filename>plot.pdf</filename>, centré
+et à sa taille nominale. Vous pouvez aussi donner un chemin au fichier,
+comme dans <literal>\includegraphics{graphiques/trace.pdf}</literal>. Pour
+spécifier une liste de répertoire ou rechercher le fichier,
+see <link linkend="_005cgraphicspath">\graphicspath</link>.
+</para>
+<para>Si votre nom de fichier comprend des espaces, alors placer le entre
+guillemets anglais. Par exemple comme dans
+<literal>\includegraphics{&quot;image complementaire.jpg&quot;}</literal>.
+</para>
+<para>La commande <literal>\includegraphics{<replaceable>nomfichier</replaceable>}</literal> décide du type
+de graphique en segmentant <replaceable>nomfichier</replaceable> sur le premier point
+(&#8216;<literal>.</literal>&#8217;). Vous pouvez utiliser <replaceable>nomfichier</replaceable> sans extension de nom
+de fihcier, comme dans <literal>\includegraphics{turing}</literal> et &latex;
+essaie une séquence d&#8217;extension telle que <literal>.png</literal> et <literal>.pdf</literal>
+jusqu&#8217;à ce qu&#8217;il trouve un fichier avec cette extension
+(see <link linkend="_005cDeclareGraphicsExtensions">\DeclareGraphicsExtensions</link>).
+</para>
+<para>Si votre fichier comprend des points avantr l&#8217;extension alors vous
+pouvez les cacher avec des accolades, comme dans
+<literal>\includegraphics{{plot.2018.03.12.a}.pdf}</literal>. Ou, si vous
+utilisez le paquetage <filename>graphicx</filename> alors vous pouvez utiliser les
+options <literal>type</literal> et <literal>ext</literal> ; voir plus bas. Ces problèmes de
+noms de fichiers, et d&#8217;autres sont aussi traités par le paquetage
+<filename>grffile</filename>.
+</para>
+<para>L&#8217;exemple ci-après place un graphique dans un environnement
+<literal>figure</literal> de sorte que &latex; puisse le déplacer sur la page
+suivante si le faire rentrer dans la page courante rend mal
+(see <link linkend="figure">figure</link>).
+</para>
+<screen>\begin{figure}
+ \centering
+ \includegraphics[width=3cm]{rayonxpoumon.jpg}
+ \caption{Ça saute aux yeux : vous ne devriez arrêter de fumer} \label{fig:rayon-x}
+\end{figure}
+</screen>
+<para>L&#8217;exemple suivant place un graphique non flottant, de sorte
+à garantir qu&#8217;il apparaisse à ce point-ci du document même si cela
+oblige &latex; à dilater le texte ou à recourir à des zones blanche sur
+la page. Le graphique est centré est a une légende.
+</para>
+<screen>\usepackage{caption} % dans le préambule
+ ...
+\begin{center}
+ \includegraphics{sans/images.png}
+ \captionof{figure}{L'esprit de la nuit} \label{sans:images} % optionnel
+\end{center}
+</screen>
+<para>L&#8217;exemple suivant place une boîte avec un graphique le long d&#8217;une autre
+boîte contenant du texte, les deux boîtes étant verticalement centrées :
+</para>
+<screen>\newcommand*{\vcenteredhbox}[1]{\begin{tabular}{@{}c@{}}#1\end{tabular}}
+ ...
+\begin{center}
+ \vcenteredhbox{\includegraphics[width=0.4\textwidth]{trace}}
+ \hspace{1em}
+ \vcenteredhbox{\begin{minipage}{0.4\textwidth}
+ \begin{displaymath}
+ f(x)=x\cdot \sin (1/x)
+ \end{displaymath}
+ \end{minipage}}
+\end{center}
+</screen>
+<para>Si vous utilisez le paquetage <filename>graphics</filename> alors les seules options
+disponibles concernent la taille du graphique (mais voir
+<link linkend="_005crotatebox">\rotatebox</link> et <link linkend="_005cscalebox">\scalebox</link>). Quand un argument optionnel est
+présent alors c&#8217;est <literal>[<replaceable>urx</replaceable>,<replaceable>ury</replaceable>]</literal> et il donne les
+coordonnées du coin en haut à droite de l&#8217;image, comme une paire de
+dimensions &tex; (see <link linkend="Units-of-length">Units of length</link>). Si les unités sont omises,
+alors par défaut l&#8217;unité considérée est le <literal>bp</literal>. Dans ce cas, le
+coin en bas à gaéuche de l&#8217;image est supposée être à (0,0). Si deux
+arguments optionnels sont présents alors le premier est
+<literal>[<replaceable>llx</replaceable>,<replaceable>lly</replaceable>]</literal>, et il spécifie les coordonnées du coin en
+bas à gauche de l&#8217;image. Ainsi,
+<literal>\includegraphics[1in,0.618in]{...}</literal> demande que le graphique
+soit placé de sorte a avoir 1 inch de largeur et 0,618 inches de hauteur
+et donc son origine est à (0,0).
+</para>
+<para>Le paquetage <filename>graphicx</filename> vous offre beaucoup plus d&#8217;options.
+Spécifiez les sous la forme de paires clef-valeur, comme ci-après :
+</para>
+<screen>\begin{center}
+ \includegraphics[width=3cm,angle=90]{lion}
+ \hspace{2em}
+ \includegraphics[angle=90,width=3cm]{lion}
+\end{center}
+</screen>
+<para>Les options sont lues de gauche à doite. Ainsi le premier graphique
+ci-dessus est dilaté à une largeur de 3cm, et ensuite subit une
+rotation de 90degrés, alors que le second subit la rotation en
+premier et ensuite est dilaté à 3cm de largeur. Ainsi, à moins
+que le graphique soit parfaitement carré, à la fin les deux n&#8217;ont pas
+les mêmes largeurs et hauteurs.
+</para>
+<para>Il y a beaucoup d&#8217;options. Les principales sont listées en premier.
+</para>
+<indexterm role="cp"><primary>boîte englobante</primary></indexterm>
+<indexterm role="cp"><primary>englobante, boîte</primary></indexterm>
+<para>Notez qu&#8217;un graphique est placé par &latex; dans une boîte, qu&#8217;on
+désigne traditionnellement comme sa <firstterm>boîte englobante</firstterm> (distincte de
+la BoundingBox PostScript décrite plus bas). La zone sur laquelle le
+graphique s&#8217;imprime peut aller au delà de cette boîte, ou s&#8217;inscrire
+dans cette boîte, mais quand &latex; fabrique une page il assemble des
+boîtes, et celle-ci est la boîte allouée pour le graphique.
+</para>
+<variablelist><anchor id="includegraphics-width"/><varlistentry><term><literal>width</literal>
+</term><listitem><para>Le graphique est affiché de sorte que sa boîte englobante ait cette
+largeur. Un exemple est <literal>\includegraphics[width=2.5cm]{trace}</literal>.
+Vous pouvez utiliser les unités de longueur standardes de &tex;
+(see <link linkend="Units-of-length">Units of length</link>) et également il est commode d&#8217;utiliser
+<literal>\linewidth</literal>, ou, dans un document recto-verso, <literal>\columnwidth</literal>
+(see <link linkend="Page-layout-parameters">Page layout parameters</link>). Un exemple est qu&#8217;en utilisant le
+paquetage <filename>calc</filename> vous pouvez rendre le graphique 1cm plus
+étroit que la largeur du texte avec
+<literal>\includegraphics[width=\linewidth-1.0cm]{hefferon.jpg}</literal>.
+</para>
+</listitem></varlistentry><varlistentry><term><literal>height</literal>
+</term><listitem><anchor id="includegraphics-height"/>
+<para>Le graphique est affiché de sorte que sa boîte englobante est de cette
+hauteur. Vous pouvez utiliser les unités de longueur standardes de
+&tex; (see <link linkend="Units-of-length">Units of length</link>), et également il est commode d&#8217;utiliser
+<literal>\pageheight</literal> et <literal>\textheight</literal> (see <link linkend="Page-layout-parameters">Page layout
+parameters</link>). Par exemple, la commande
+<literal>\includegraphics[height=0.25\textheight]{godel}</literal> rend le
+graphique d&#8217;une hauteur d&#8217;un quart de celle de la zone de texte.
+</para>
+</listitem></varlistentry><varlistentry><term><literal>totalheight</literal>
+</term><listitem><anchor id="includegraphics-totalheight"/>
+<para>Le graphique est affiché de sorte que sa boîte englobante ait cette
+hauteur plus profondeur. Ceci diffère de la hauteur si le graphique a
+subi une rotation. Par exemple, s&#8217;il a subi une rotation de -90 degrès
+alors il a une hauteur nulle mais une grande profondeur.
+</para>
+</listitem></varlistentry><varlistentry><term><literal>keepaspectratio</literal>
+</term><listitem><anchor id="includegraphics-keepaspectratio"/><para>Si réglé à <literal>true</literal>, ou juste spécifié comme ci-dessous
+</para>
+<screen><literal>\includegraphics[...,keepaspectratio,...]{...}</literal>
+</screen>
+<para>et que vous donnez en option à la fois <literal>width</literal> et <literal>height</literal> (ou
+<literal>totalheight</literal>), alors &latex; rendra le graphique aussi grand que
+possible sans le déformer. C&#8217;est à dire que &latex; assure que le
+graphique n&#8217;est ni plus large que <literal>width</literal> ni plus haut que
+<literal>height</literal> (ou <literal>totalheight</literal>).
+</para>
+</listitem></varlistentry><varlistentry><term><literal>scale</literal>
+</term><listitem><para>Facteur par lequel dilater/contracter le graphique. On peut rendre
+ graphique à deux fois sa taille nominale avec
+ <literal>\includegraphics[scale=2.0]{...}</literal>. Ce nombre peut prendre
+ n&#8217;importe quelle valeur ; un nombre entre 0 et 1 contracte le graphique
+ et un nombre négatif lui applique une réflexion.
+</para>
+</listitem></varlistentry><varlistentry><term><literal>angle</literal>
+</term><listitem><para>Applique une rotation au graphique. L&#8217;angle est exprimé en degrès et
+dans le sens anti-horaire. La rotation est effectuée autour de
+l&#8217;origine donnée par l&#8217;option <literal>origin</literal> ; s&#8217;y référer. Pour une
+descrition complète de la compositiion de matériel ayant subi une
+rotation, see <link linkend="_005crotatebox">\rotatebox</link>.
+</para>
+</listitem></varlistentry><varlistentry><term><literal>origin</literal>
+</term><listitem><para>Le point du graphique autour duquel la rotation s&#8217;effectue. Les valeurs
+possibles sont toute chaîne contenant un ou deux caractères parmi :
+<literal>l</literal> pour gauche (left), <literal>r</literal> pour droite (right), <literal>b</literal> pour
+bas, <literal>c</literal> pour centré, <literal>t</literal> pour haut (top), et <literal>B</literal> pour
+ligne de base. Ainsi, saisir la commande
+<literal>\includegraphics[angle=180,origin=c]{moon}</literal> a pour effet de
+mettre la figure tête en bas en tournant autour du centre de l&#8217;image,
+alors que la commande
+<literal>\includegraphics[angle=180,origin=lB]{LeBateau}</literal> fait la
+rotation autour du point gauche de la ligne de base. (Le caractère
+<literal>c</literal> désigne le centre horizontal dans <literal>bc</literal> ou <literal>tc</literal>, mais
+le centre vertical dans <literal>lc</literal> <literal>rc</literal>). Le réglage par défaut est
+<literal>lB</literal>.
+</para>
+<para>Pour faire une rotation autour d&#8217;un point arbitraire,
+see <link linkend="_005crotatebox">\rotatebox</link>.
+</para>
+</listitem></varlistentry></variablelist>
+<para>Voici maintenant des options moins usuelles.
+</para>
+<variablelist><anchor id="includegraphics-viewport"/><varlistentry><term><literal>viewport</literal>
+</term><listitem><para>Désigne une sous-région du graphique à afficher. Prend quatre
+arguments, séparés par des espaces et exprimés comme des dimensions
+&tex;, comme dans <literal>\includegraphics[.., viewport=0in 0in 1in
+0.618in]{...}</literal>. Quand l&#8217;unité est omise, les dimensions sont par
+défaut en big points, <literal>bp</literal>. Elle sont prises relativement à
+l&#8217;origine spécifiée par la boîte englobante. Voir aussi l&#8217;option
+<literal>trim</literal>.
+</para>
+<anchor id="includegraphics-trim"/></listitem></varlistentry><varlistentry><term><literal>trim</literal>
+</term><listitem><para>Désigne les parties du graphique à ne pas afficher. Prend quatre
+arguments, séparés par des espaces, et exprimés comme des dimensions
+&tex; dimensions, comme dans <literal>\includegraphics[.., trim= 0in 0.1in
+0.2in 0.3in, ...]{...}</literal>. Ceci donne la quantité du graphique à ne pas
+afficher, c-à-d. que &latex; rogne l&#8217;image de 0 pouce sur la gauche
+left, 0.1 pouce sur la bas, 0.2 pouce sur la droite, et 0.3 pouce sur le
+haut. Voir aussi l&#8217;option <literal>viewport</literal>.
+</para>
+<anchor id="includegraphics-clip"/></listitem></varlistentry><varlistentry><term><literal>clip</literal>
+</term><listitem><para>Si réglé à <literal>true</literal>, ou juste spécifié comme ci-dessous
+</para>
+<screen>\includegraphics[...,clip,...]{...}
+</screen>
+<para>alors le graphique est rogné à sa boîte englobante. Ceci revient au
+même que d&#8217;utiliser la forme étoilée de la commande,
+<literal>\includegraphics*[...]{...}</literal>.
+</para>
+<anchor id="includegraphics-page"/></listitem></varlistentry><varlistentry><term><literal>page</literal>
+</term><listitem><para>Donne le numéro de page pour un fichier PDF multi-page. La valeur par
+défaut est <literal>page=1</literal>.
+</para>
+<anchor id="includegraphics-pagebox"/></listitem></varlistentry><varlistentry><term><literal>pagebox</literal>
+</term><listitem><para>Spécifie quelle boîte englobante utiliser pour les fichier PDF parmi les
+suivantes <literal>mediabox</literal>, <literal>cropbox</literal>, <literal>bleedbox</literal>,
+<literal>trimbox</literal>, ou <literal>artbox</literal>. Les fichier PDF n&#8217;ont pas la
+BoundingBox que les fichiers PostScript ont, mais peuvent spécifier
+jusqu&#8217;à quatre rectangle prédéfinis. La boîte MediaBox donne les
+frontière du médium physique. La boîte CropBox est la région à laquelle
+le contenu de la page devrait être épinglé quand il est affiché. La
+boite BleedBox la région à laqeulle le contenu de la page devrait être
+épinglé en production. La boîte TrimBox est correspond au dimensions
+désirée de la page finie. La boîte ArtBox est l&#8217;étendu du contenu de la
+page ayant du sens. Le pilote règle la taille de l&#8217;image en se basant
+sur la CropBox si elle est présente, sinon il n&#8217;utilise pas les autres,
+avec un ordre de préférence propre au pilote. La MediaBox est toujours
+présente.
+</para>
+<anchor id="includegraphics-interpolate"/></listitem></varlistentry><varlistentry><term><literal>interpolate</literal>
+</term><listitem><para>Active ou désactive l&#8217;interpolation des images matricielles par la
+visionneuse. On peut régler l&#8217;option avec <literal>interpolate=true</literal> ou
+juste comme ci-dessous :
+</para>
+<screen>\includegraphics[...,interpolate,...]{...}
+</screen>
+<anchor id="includegraphics-quiet"/></listitem></varlistentry><varlistentry><term><literal>quiet</literal>
+</term><listitem><para>N&#8217;écrit pas d&#8217;information dans le journal. On peut régler l&#8217;option avec
+<literal>quiet=true</literal> ou juste en la spécifiant avec
+<literal>\includegraphics[...,quiet,...]{...}</literal>,
+</para>
+<anchor id="includegraphics-draft"/></listitem></varlistentry><varlistentry><term><literal>draft</literal>
+</term><listitem><para>Lorsqu&#8217;on règle l&#8217;option avec <literal>draft=true</literal> ou juste ainsi
+</para>
+<screen>\includegraphics[...,draft,...]{...}
+</screen>
+<para>alors le graphique n&#8217;apparaît pas dans le document, ce qui permet
+éventuellement d&#8217;économiser l&#8217;imprimante couleur. À la place &latex;
+place une boîte vide de la bonne taille avec le nom du fichier imprimé
+dedans.
+</para>
+</listitem></varlistentry></variablelist>
+<para>Les options suivantes traitent de la boîte englobante pour les fichiers
+graphique de type PostScript Encapsulé, leur taille est spécifié avec
+une ligne <literal>%%BoundingBox</literal> qui apparaît dans le fichier. Elle a
+quatre valeurs donant la coordonnée <inlineequation><mathphrase>x</mathphrase></inlineequation> inférieure, la coordonnée
+<inlineequation><mathphrase>y</mathphrase></inlineequation> inférieure, la coordonnée <inlineequation><mathphrase>x</mathphrase></inlineequation> supérieure, et la coordonnée
+<inlineequation><mathphrase>y</mathphrase></inlineequation> supérieure. L&#8217;unité est le point PostScript, équivalent au big
+point de &tex;, à savoir 1/72 de pouce. Par exemple, si un fichier
+<filename>.eps</filename> a la ligne <literal>%%BoundingBox 10 20 40 80</literal> alors sa taille
+naturelle est 30/72 de pouche de large pour 60/72 de pouce de haut.
+</para>
+<variablelist><anchor id="includegraphics-bb"/><varlistentry><term><literal>bb</literal>
+</term><listitem><para>Spécifie la boîte englobante de la région affichée. L&#8217;argument est
+constitué de quatre dimensions séparées par des espaces, comme dans
+<literal>\includegraphics[.., bb= 0in 0in 1in 0.618in]{...}</literal>.
+D&#8217;ordinaire <literal>\includegraphics</literal> lit les ces nombre BoundingBox dans
+le fichier EPS automatiqument, de sorte que cette option n&#8217;est utile que
+si la définition de la boîte englobante est absente du fihcier ou si
+vous désirez la changer.
+</para>
+<anchor id="includegraphics-bbllx"/><anchor id="includegraphics-bblly"/><anchor id="includegraphics-bburx"/><anchor id="includegraphics-bbury"/></listitem></varlistentry><varlistentry><term><literal>bbllx, bblly, bburx, bbury</literal>
+</term><listitem><para>Règke la boîte englobante box. Ces quatre options là sont obsolète,
+mais existent encore pour maintenir la rétrocompatibilité avec des
+paquetages anciens.
+</para>
+<anchor id="includegraphics-natwidth"/><anchor id="includegraphics-natheight"/></listitem></varlistentry><varlistentry><term><literal>natwidth, natheight</literal>
+</term><listitem><para>Une alternative à <literal>bb</literal>. Régler
+</para>
+<screen>\includegraphics[...,natwidth=1in,natheight=0.618in,...]{...}
+</screen>
+<para>revient au même que régler <literal>bb=0 0 1in 0.618in</literal>.
+</para>
+<anchor id="includegraphics-hiresbb"/></listitem></varlistentry><varlistentry><term><literal>hiresbb</literal>
+</term><listitem><para>Si réglé à <literal>true</literal>, ou juste spécifié comme dans
+</para>
+<screen>\includegraphics[...,hiresbb,...]{...}
+</screen>
+<para>alors &latex; recherche la ligne <literal>%%HiResBoundingBox</literal> plutôt que
+la ligne <literal>%%BoundingBox</literal>. (La ligne <literal>BoundingBox</literal> n&#8217;utilise
+que des nombres entiers naturels alors que la ligne
+<literal>HiResBoundingBox</literal> utilise des décimaux ; les deux utilisent une
+unité équivalente au big point de &tex;, 1/72 de pouce). Pour
+l&#8217;emporter sur un réglage précédent à <literal>true</literal>, on peut la régler à
+<literal>false</literal>.
+</para>
+</listitem></varlistentry></variablelist>
+<para>Les options suivantes permettent à l&#8217;utilisateur de l&#8217;emporter sur la
+méthode par laquelle &latex; choisit le type d&#8217;un graphique en fonction
+de son extension de nom de fichier. Par exemple avec
+<literal>\includegraphics[type=png,ext=.xxx,read=.xxx]{lion}</literal> le fichier
+<filename>lion.xxx</filename> est lu comme s&#8217;il s&#8217;agissait de <filename>lion.png</filename>. Pour
+plus ample information, see <link linkend="_005cDeclareGraphicsRule">\DeclareGraphicsRule</link>.
+</para>
+<variablelist><anchor id="includegraphics-type"/><varlistentry><term><literal>type</literal>
+</term><listitem><para>Spécifie le type de graphique.
+</para>
+<anchor id="includegraphics-ext"/></listitem></varlistentry><varlistentry><term><literal>ext</literal>
+</term><listitem><para>Spécifie l&#8217;extension du graphique. À n&#8217;utiliser qu&#8217;en conjonction avec
+l&#8217;option <literal>type</literal>.
+</para>
+<anchor id="includegraphics-read"/></listitem></varlistentry><varlistentry><term><literal>read</literal>
+</term><listitem><para>Spécifie l&#8217;extension du fichier lu. À n&#8217;utiliser qu&#8217;en conjonction avec
+l&#8217;option <literal>type</literal>.
+</para>
+<anchor id="includegraphics-command"/></listitem></varlistentry><varlistentry><term><literal>command</literal>
+</term><listitem><para>Spécifie une commande à appliquer à ce fichier. À n&#8217;utiliser qu&#8217;en
+conjonction avec l&#8217;option <literal>type</literal>. See <link linkend="Command-line-options">Command line options</link>,
+pour une discussion sur l&#8217;activation de la fonctionalité <literal>\write18</literal>
+pour exécuter des commandes externes.
+</para>
+</listitem></varlistentry></variablelist>
+
+</sect2>
+<sect2 label="22.3.2" id="_005crotatebox">
+<title><literal>\rotatebox</literal></title>
+
+<indexterm role="cp"><primary>rotation</primary></indexterm>
+<indexterm role="cp"><primary>rotating graphics</primary></indexterm>
+<indexterm role="cp"><primary>rotating text</primary></indexterm>
+<indexterm role="fn"><primary>\rotatebox</primary></indexterm>
+
+<para>Synopsis for <filename>graphics</filename> package:
+</para>
+<screen>\rotatebox{<replaceable>angle</replaceable>}{<replaceable>material</replaceable>}
+</screen>
+<para>Synopses for <filename>graphicx</filename> package:
+</para>
+<screen>\rotatebox{<replaceable>angle</replaceable>}{<replaceable>material</replaceable>}
+\rotatebox[<replaceable>liste-à-clefs-valeurs</replaceable>]{<replaceable>angle</replaceable>}{<replaceable>material</replaceable>}
+</screen>
+<para>Put <replaceable>material</replaceable> in a box and rotate it <replaceable>angle</replaceable> degrees counterclockwise.
+</para>
+<para>This example rotates the table column heads forty five degrees.
+</para>
+<screen>\begin{tabular}{ll}
+ \rotatebox{45}{Character} &amp;\rotatebox{45}{NATO phonetic} \\
+ A &amp;AL-FAH \\
+ B &amp;BRAH-VOH
+\end{tabular}
+</screen>
+<para>The <replaceable>material</replaceable> can be anything that goes in a box, including a graphic.
+</para>
+<screen> \rotatebox[origin=c]{45}{\includegraphics[width=1in]{lion}}
+</screen>
+<para>You can get the same effect using the <filename>graphicx</filename> package alone
+(see <link linkend="_005cincludegraphics">\includegraphics</link>).
+</para>
+<para>To place the rotated material, the first step is that &latex; sets
+<replaceable>material</replaceable> in a box, with a reference point on the left baseline.
+The second step is the rotation, by default about the reference point.
+The third step is that &latex; computes a box to bound the rotated
+material. Fourth, &latex; moves this box horizontally so that the left
+edge of this new bounding box coincides with the left edge of the box
+from the first step (they need not coincide vertically). This new
+bounding box, in its new position, is what &latex; uses as the box when
+typesetting this material.
+</para>
+<para>If you use the <filename>graphics</filename> package then the rotation is about the
+reference point of the box. If you use <filename>graphicx</filename> then these are
+the options that can go in the <replaceable>liste-à-clefs-valeurs</replaceable>.
+</para>
+<variablelist><varlistentry><term><literal>origin</literal>
+</term><listitem><para>The point of the <replaceable>material</replaceable>&#8217;s box about which the rotation happens.
+Possible values are any string containing one or two of: <literal>l</literal> for
+left, <literal>r</literal> for right, <literal>b</literal> for bottom, <literal>c</literal> for center,
+<literal>t</literal> for top, and <literal>B</literal> for baseline. Thus,
+<literal>\includegraphics[angle=180,origin=c]{moon}</literal> will turn the
+picture upside down from the center, while
+<literal>\includegraphics[angle=180,origin=lB]{LeBateau}</literal> will turn its
+picture upside down about its left baseline. (The character <literal>c</literal>
+gives the horizontal center in <literal>bc</literal> or <literal>tc</literal> but gives the
+vertical center in <literal>lc</literal> or <literal>rc</literal>.) The default is <literal>lB</literal>.
+</para>
+</listitem></varlistentry><varlistentry><term><literal>x, y</literal>
+</term><listitem><para>Specify an arbitrary point of rotation with
+<literal>\rotatebox[x=<replaceable>&tex; dimension</replaceable>,y=<replaceable>&tex;
+dimension</replaceable>]{...}</literal> (see <link linkend="Units-of-length">Units of length</link>). These give the offset
+from the box&#8217;s reference point.
+</para>
+</listitem></varlistentry><varlistentry><term><literal>units</literal>
+</term><listitem><para>This key allows you to change the default of degrees counterclockwise.
+Setting <literal>units=-360</literal> changes the direction to degrees clockwise and
+setting <literal>units=6.283185</literal> changes to radians counterclockwise.
+</para>
+</listitem></varlistentry></variablelist>
+
+</sect2>
+<sect2 label="22.3.3" id="_005cscalebox">
+<title><literal>\scalebox</literal></title>
+
+<indexterm role="cp"><primary>graphics, scaling</primary></indexterm>
+<indexterm role="cp"><primary>graphics, resizing</primary></indexterm>
+<indexterm role="cp"><primary>scaling</primary></indexterm>
+<indexterm role="cp"><primary>resizing</primary></indexterm>
+<indexterm role="cp"><primary>text, scaling</primary></indexterm>
+<indexterm role="cp"><primary>text, resizing</primary></indexterm>
+<indexterm role="fn"><primary>\scalebox</primary></indexterm>
+<indexterm role="fn"><primary>\reflectbox</primary></indexterm>
+
+<para>Synopses:
+</para>
+<screen>\scalebox{<replaceable>horizontal factor</replaceable>}{<replaceable>material</replaceable>}
+\scalebox{<replaceable>horizontal factor</replaceable>}[<replaceable>vertical factor</replaceable>]{<replaceable>material</replaceable>}
+\reflectbox{<replaceable>material</replaceable>}
+</screen>
+<para>Scale the <replaceable>material</replaceable>.
+</para>
+<para>This example halves the size, both horizontally and vertically, of the
+first text and doubles the size of the second.
+</para>
+<screen>\scalebox{0.5}{DRINK ME} and \scalebox{2.0}{Eat Me}
+</screen>
+<para>If you do not specify the optional <replaceable>vertical factor</replaceable> then it
+defaults to the same value as the <replaceable>horizontal factor</replaceable>.
+</para>
+<para>You can use this command to resize a graphic, as with
+<literal>\scalebox{0.5}{\includegraphics{lion}}</literal>. If you use the
+<filename>graphicx</filename> package then you can accomplish the same thing with
+optional arguments to <literal>\includegraphics</literal>
+(see <link linkend="_005cincludegraphics">\includegraphics</link>).
+</para>
+<para>The <literal>\reflectbox</literal> command abbreviates
+<literal>\scalebox{-1}[1]{<replaceable>material</replaceable>}</literal>. Thus, <literal>Able was
+I\reflectbox{Able was I}</literal> will show the phrase &#8216;<literal>Able was I</literal>&#8217;
+immediately followed by its mirror reflection.
+</para>
+
+</sect2>
+<sect2 label="22.3.4" id="_005cresizebox">
+<title><literal>\resizebox</literal></title>
+
+<indexterm role="cp"><primary>graphics, scaling</primary></indexterm>
+<indexterm role="cp"><primary>graphics, resizing</primary></indexterm>
+<indexterm role="cp"><primary>scaling</primary></indexterm>
+<indexterm role="cp"><primary>resizing</primary></indexterm>
+<indexterm role="cp"><primary>text, scaling</primary></indexterm>
+<indexterm role="cp"><primary>text, resizing</primary></indexterm>
+<indexterm role="fn"><primary>\resizebox</primary></indexterm>
+
+<para>Synopses:
+</para>
+<screen>\resizebox{<replaceable>horizontal length</replaceable>}{<replaceable>vertical length</replaceable>}{<replaceable>material</replaceable>}
+\resizebox*{<replaceable>horizontal length</replaceable>}{<replaceable>vertical length</replaceable>}{<replaceable>material</replaceable>}
+</screen>
+<para>Given a size, such as <literal>3cm</literal>, transform <replaceable>material</replaceable> to make it
+that size. If either <replaceable>horizontal length</replaceable> or <replaceable>vertical length</replaceable>
+is an exclamation point <literal>!</literal> then the other argument is used
+to determine a scale factor for both directions.
+</para>
+<para>This example makes the graphic be a half inch wide and scales it
+vertically by the same factor to keep it from being distorted.
+</para>
+<screen>\resizebox{0.5in}{!}{\includegraphics{lion}}
+</screen>
+<para>The unstarred form <literal>\resizebox</literal> takes <replaceable>vertical length</replaceable> to be
+the box&#8217;s height while the starred form <literal>\resizebox*</literal> takes it to
+be height+depth. For instance, make the text have a height+depth of a
+quarter inch with <literal>\resizebox*{!}{0.25in}{\parbox{1in}{This
+box has both height and depth.}}</literal>.
+</para>
+<para>You can use <literal>\depth</literal>, <literal>\height</literal>, <literal>\totalheight</literal>, and
+<literal>\width</literal> to refer to the original size of the box. Thus, make the
+text two inches wide but keep the original height with
+<literal>\resizebox{2in}{\height}{Two inches}</literal>.
+</para>
+
+</sect2>
+</sect1>
+</chapter>
+<chapter label="23" id="Special-insertions">
<title>Insertions spéciales</title>
<para>&latex; fournit des commandes pour insérer les caractères qui ont une
@@ -8564,7 +11852,7 @@ que vous pouvez taper.
</para>
-<sect1 label="21.1" id="Reserved-characters">
+<sect1 label="23.1" id="Reserved-characters">
<title>Caractères réservés</title>
<indexterm role="cp"><primary>caractères réservés</primary></indexterm>
<indexterm role="cp"><primary>réservés, caractères</primary></indexterm>
@@ -8573,7 +11861,8 @@ que vous pouvez taper.
<para>&latex; réserve les caractères suivant à un usage spécial (par exemple,
le signe pourcent <literal>%</literal> sert aux commentaires) c&#8217;est pourquoi on les
-appelle <firstterm>caractères réservés</firstterm> ou <firstterm>caractères spéciaux</firstterm>.
+appelle <firstterm>caractères réservés</firstterm> ou <firstterm>caractères spéciaux</firstterm>. Ils sont
+chacun l&#8217;objet d&#8217;une discussion ailleurs dans ce manuel.
</para>
<screen># $ % &amp; { } _ ~ ^ \
</screen>
@@ -8584,7 +11873,7 @@ appelle <firstterm>caractères réservés</firstterm> ou <firstterm>caractères
<indexterm role="fn"><primary>\_</primary></indexterm>
<indexterm role="fn"><primary>\{</primary></indexterm>
<indexterm role="fn"><primary>\}</primary></indexterm>
-<para>Si vous voulez qu&#8217;un caractère réservés soit imprimé comme lui-même,
+<para>Si vous voulez qu&#8217;un caractère réservé soit imprimé comme lui-même,
dans la même police que le corps du texte, alors pour tous les
caractères hormis les trois derniers de cette liste il suffit de les
faire précéder d&#8217;une contr&#8217;oblique <literal>\</literal>. Ainsi <literal>\$1.23</literal>
@@ -8600,8 +11889,9 @@ un accent circonflexe dans la police du corps du texte utilisez
<literal>\^{}</literal>. Une contr&#8217;oblique dans la police du corps de texte se
fait avec <literal>\textbackslash{}</literal>.
</para>
-<para>Pour produire les caractères réservé dans la police d&#8217;une machine à écrire utilisez
-<literal>\verb!!</literal> comme ci-dessous :
+<para>Pour produire les caractères réservés dans la police tapuscrite utilisez
+<literal>\verb!!</literal> comme ci-dessous (la double contr&#8217;oblique <literal>\\</literal> n&#8217;est
+là que pour aller à la ligne en sortie) :
</para>
<screen>\begin{center}
\# \$ \% \&amp; \{ \} \_ \~{} \^{} \textbackslash \\
@@ -8613,7 +11903,79 @@ sauter à la ligne.
</para>
</sect1>
-<sect1 label="21.2" id="Symbols-by-font-position">
+<sect1 label="23.2" id="Upper-and-lower-case">
+<title>Capitales et bas de casse</title>
+
+<indexterm role="cp"><primary>Capitales</primary></indexterm>
+<indexterm role="cp"><primary>Bas de casse</primary></indexterm>
+<indexterm role="cp"><primary>Casse de caractères</primary></indexterm>
+<indexterm role="cp"><primary>Changer la casse de caractères</primary></indexterm>
+
+<para>Synopsis :
+</para>
+<screen>\uppercase{<replaceable>texte</replaceable>}
+\lowercase{<replaceable>texte</replaceable>}
+\MakeUppercase{<replaceable>texte</replaceable>}
+\MakeLowercase{<replaceable>texte</replaceable>}
+</screen>
+<para>Change la casse des caractères. Les commandes primitives de &tex;
+<literal>\uppercase</literal> et <literal>\lowercase</literal> ne fonctionnent que pour les
+26 lettres sans diacritiques a-z et A-Z. Les commandes &latex;
+<literal>\MakeUppercase</literal> et <literal>\MakeLowercase</literal> changent aussi les
+caractères accessibles par des commandes telles que <literal>\ae</literal> ou
+<literal>\aa</literal>. Ces commandes <literal>\MakeUppercase</literal> et
+<literal>\MakeLowercase</literal> sont robustes, mais elles ont des arguments
+mouvants (see <link linkend="_005cprotect">\protect</link>).
+</para>
+<para>Ces commandes ne changent pas la casse des lettres utilisées dans le nom
+d&#8217;une commande au sein de <replaceable>texte</replaceable>. Mais par contre elles changent la
+casse de tout autre lettre latine au sein de l&#8217;argument <replaceable>texte</replaceable>.
+Ainsi, <literal>\MakeUppercase{Soit $y=f(x)$</literal>} produit &#8216;<literal>SOIT
+Y=F(X)</literal>&#8217;. Un autre exemple est que le nom de tout environnement est
+changé, de sorte que <literal>\MakeUppercase{\begin{tabular}
+... \end{tabular}}</literal> produit une erreur puisque la première moitié est
+changée en <literal>\begin{TABULAR}</literal>.
+</para>
+<para>&latex; utilise la même table pour changer la casse tout au long du
+document. La table utilisée est conçue pour le codage T1 ; ceci
+fonctionne bien avec les polices standardes de &tex; pour tous les
+alphabets latins, mais cause des problèmes avec d&#8217;autres alphabets.
+</para>
+<para>Pour changer la casse du texte qui résulte d&#8217;une macro au sein de
+<replaceable>texte</replaceable> il est nécessaire de faire un développement. Dans l&#8217;exemple
+qui suit la macro <literal>\Nomecole</literal> produit &#8216;<literal>UNIVERSITÉ DE MATHÉMATIQUES</literal>&#8217;.
+</para>
+<screen>\newcommand{\nomecole}{Universit\'e de math\'ematiques}
+\newcommand{\Nomecole}{\expandafter\MakeUppercase\expandafter{\nomecole}}
+</screen>
+<indexterm role="fn"><primary>paquetage <literal>textcase</literal></primary></indexterm>
+<indexterm role="fn"><primary><literal>textcase</literal>, paquetage</primary></indexterm>
+
+<para>Le paquetage <filename>textcase</filename> comble certaines des lacunes des commandes
+standardes <literal>\MakeUppercase</literal> et <literal>\MakeLowerCase</literal> de &latex;.
+</para>
+<indexterm role="fn"><primary>paquetage <literal>mfirstuc</literal></primary></indexterm>
+<indexterm role="fn"><primary><literal>mfirstuc</literal>, paquetage</primary></indexterm>
+
+<para>Pour mettre en capitale seulement la première lettre d&#8217;un mot, on peut
+utiliser le paquetage <filename>mfirstuc</filename>.
+</para>
+<indexterm role="fn"><primary>paquetage <literal>expl3</literal></primary></indexterm>
+<indexterm role="fn"><primary><literal>expl3</literal>, paquetage</primary></indexterm>
+
+<indexterm role="cp"><primary>Wright, Joseph</primary></indexterm>
+
+<para>Gérer toutes les règles concernant la casse spécifiée par Unicode, par
+ex. pour les scripts non latins, est une tâche bien plus conséquente que
+ce qui avait été considéré dans les &tex; et &latex; d&#8217;origine. Cela
+a été implémenté dans le paquetage <literal>expl3</literal> à compter de
+2020. L&#8217;article « Case changing: From &tex; primitives to the Unicode
+algorithm », (Joseph Wright, <citetitle>TUGboat</citetitle> 41:1,
+<ulink url="https://tug.org/TUGboat/tb41-1/tb127wright-case.pdf">https://tug.org/TUGboat/tb41-1/tb127wright-case.pdf</ulink>), donne un bon
+aperçu du sujet, passé et présent.
+</para>
+</sect1>
+<sect1 label="23.3" id="Symbols-by-font-position">
<title>Symboles appelés par leur position dans une police</title>
<indexterm role="fn"><primary>\symbol</primary></indexterm>
@@ -8633,7 +11995,7 @@ comme <literal>\symbol{'40}</literal> ou <literal>\symbol{&quot;20}</literal>.
</para>
</sect1>
-<sect1 label="21.3" id="Text-symbols">
+<sect1 label="23.4" id="Text-symbols">
<title>Symboles en texte</title>
<indexterm role="cp"><primary>symboles texte</primary></indexterm>
@@ -8724,7 +12086,7 @@ utilisés en mode mathématique.
<indexterm role="cp"><primary>fermant, guillemet-apostrophe simple</primary></indexterm>
<indexterm role="cp"><primary>droite, guillemet anglais simple</primary></indexterm>
<indexterm role="cp"><primary>fermant, guillemet anglais simple</primary></indexterm>
-<para>Guillemet-apostrophe simple de gauche (fermant) : &#8217;.
+<para>Guillemet-apostrophe simple de droite (fermant) : &#8217;.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\S</primary></indexterm><literal>\S</literal>
</term><listitem><para>\itemx \textsection
@@ -8928,12 +12290,12 @@ hauteur de capitale de la fonte, alors que la forme
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\textvisiblespace</primary></indexterm><literal>\textvisiblespace</literal>
</term><listitem><indexterm role="cp"><primary>visible, symbole espace, dans le texte</primary></indexterm>
<indexterm role="cp"><primary>espace visible, symbole, dans le texte</primary></indexterm>
-<para>Symbol espace visible.
+<para>Symbole espace visible.
</para>
</listitem></varlistentry></variablelist>
</sect1>
-<sect1 label="21.4" id="Accents">
+<sect1 label="23.5" id="Accents">
<title>Accents</title>
<indexterm role="cp"><primary>accents</primary></indexterm>
@@ -8970,7 +12332,7 @@ disponible avec l&#8217;OT1.
<indexterm role="cp"><primary>diacrtique accent aigu</primary></indexterm>
<para>Produit un accent aigu, comme dans &#243;. Dans l&#8217;environnement
<literal>tabbing</literal>, pousse la colonne courante à droite de la colonne
-précédente (voir <link linkend="tabbing">tabbing</link>).
+précédente (see <link linkend="tabbing">tabbing</link>).
</para>
</listitem></varlistentry><varlistentry><term><literal>\.</literal>
</term><listitem><indexterm role="fn"><primary>\. (dot-over accent)</primary></indexterm>
@@ -9011,7 +12373,7 @@ dans &#333;.
<indexterm role="cp"><primary>grave accent</primary></indexterm>
<para>Produit un accent grave suscrit à la lettre qui suit, comme dans
&#242;. Au sein de l&#8217;environnement <literal>tabbing</literal>, déplace le texte qui
-suit à la marge de droite (voir <link linkend="tabbing">tabbing</link>).
+suit à la marge de droite (see <link linkend="tabbing">tabbing</link>).
</para>
</listitem></varlistentry><varlistentry><term><literal>\~</literal>
</term><term><literal>\capitaltilde</literal>
@@ -9134,9 +12496,9 @@ sorte elle traverse les descentes. Voir aussi <literal>\underline</literal> dan
</listitem></varlistentry></variablelist>
</sect1>
-<sect1 label="21.5" id="Non_002dEnglish-characters">
+<sect1 label="23.6" id="Additional-Latin-letters">
<title>Lettres latines supplémentaires</title>
-
+<anchor id="Non_002dEnglish-characters"/>
<indexterm role="cp"><primary>caractères speciaux</primary></indexterm>
<indexterm role="cp"><primary>speciaux, caractères</primary></indexterm>
<indexterm role="cp"><primary>caractères latins non diacrités</primary></indexterm>
@@ -9240,7 +12602,7 @@ autre codage de police, tel que T1.
</listitem></varlistentry></variablelist>
</sect1>
-<sect1 label="21.6" id="_005crule">
+<sect1 label="23.7" id="_005crule">
<title><literal>\rule</literal></title>
<indexterm role="fn"><primary>\rule</primary></indexterm>
@@ -9262,7 +12624,7 @@ un rectangle. Les arguments sont :
</para></listitem></varlistentry></variablelist>
</sect1>
-<sect1 label="21.7" id="_005ctoday">
+<sect1 label="23.8" id="_005ctoday">
<title><literal>\today</literal></title>
<indexterm role="fn"><primary>\today</primary></indexterm>
<indexterm role="cp"><primary>date d&#8217;aujourd&#8217;hui</primary></indexterm>
@@ -9270,7 +12632,7 @@ un rectangle. Les arguments sont :
<para>La commande <literal>\today</literal> produit la date d&#8217;aujourd&#8217;hui, par défaut dans
le format &#8216;<literal><replaceable>mois</replaceable> <replaceable>jj</replaceable>, <replaceable>aaaa</replaceable></literal>&#8217; ; par exemple, &#8216;July 4,
1976&#8217;. Elle utilise les compteurs prédéfinis <literal>\day</literal>,
-<literal>\month</literal>, et <literal>\year</literal> (voir <link linkend="_005cday-_005cmonth-_005cyear">\day \month \year</link>) pour faire
+<literal>\month</literal>, et <literal>\year</literal> (see <link linkend="_005cday-_005cmonth-_005cyear">\day \month \year</link>) pour faire
cela. Elle n&#8217;est pas mise à jour durant l&#8217;execution de la compilation.
</para>
<para>Les extensions multilingues comme entre autres le paquetage <filename>babel</filename>
@@ -9287,75 +12649,253 @@ suivant produit &#8216;<literal>4 juillet 1976</literal>&#8217; :
<indexterm role="fn"><primary>paquetage <literal>datetime</literal></primary></indexterm>
<indexterm role="fn"><primary><literal>datetime</literal>, paquetage</primary></indexterm>
+
<para>Le paquetage <literal>datetime</literal>, entre autres, produit un large choix
d&#8217;autres formats de date.
</para>
</sect1>
</chapter>
-<chapter label="22" id="Splitting-the-input">
+<chapter label="24" id="Splitting-the-input">
<title>Partitionner le fichier d&#8217;entrée</title>
<indexterm role="cp"><primary>partitionner le fichier d&#8217;entrée</primary></indexterm>
<indexterm role="cp"><primary>fichier d&#8217;entrée</primary></indexterm>
-<para>Un document de grande taille nécessite beaucoup de données en
-entrée. Plutôt que de mettre toutes les entrées dans un seul grand
-fichier, il est plus efficace de les partitionner en plusieurs fichiers
-plus petits. Indépendamment du nombre de fichiers distincts que vous
-utilisez, il y en a un seul qui est le
+<para>&latex; vous permet de partitionner un document de grande taille en
+plusieurs plus petits. Ceci peut simplifier son édition et permette à
+plusieurs auteurs d&#8217;y travailler. Cela peut aussi accélerer le
+traitement.
+</para>
+<para>Indépendamment du nombre de fichiers distincts que vous
+utilisez, il y a toujours un seul
<indexterm role="cp"><primary>racine, fichier</primary></indexterm>
<indexterm role="cp"><primary>fichier racine</primary></indexterm>
-<firstterm>fichier racine</firstterm> ; c&#8217;est le fichier dont vous passer le nom à la
-ligne de commande quand vous exécutez &latex;.
+<firstterm>fichier racine</firstterm> sur lequel la compilation &latex;
+démarre. L&#8217;exemple ci-dessous illuste un tel fichier avec cinq fichiers
+inclus.
+</para>
+<screen>\documentclass{book}
+\includeonly{
+ % mettre en commentaire les lignes ci-dessous pour ne pas compiler le fichier
+ pref,
+ chap1,
+ chap2,
+ append,
+ bib
+ }
+\begin{document}
+\frontmatter
+\include{pref}
+\mainmatter
+\include{chap1}
+\include{chap2}
+\appendix
+\include{append}
+\backmatter
+\include{bib}
+\end{document}
+</screen>
+<para>Dans cet example on prend le matériel de <filename>pref.tex</filename>,
+<filename>chap1.tex</filename>, <filename>chap2.tex</filename>, <filename>append.tex</filename>, et
+<filename>bib.tex</filename>. Si vous compilez ce fichier, et ensuite mettez en
+commentaire toutes les lignes au sein de <literal>\includeonly{...}</literal>
+hormis <literal>chap1</literal>, et compilez de nouveau, alors &latex; traite
+seulement le matériel du premier chapitre. Ainsi, la sortie apparaît
+plus rapidement et est plus courte à imprimer. Cependant, l&#8217;avantage
+de la commande <literal>\includeonly</literal> est que &latex; retient les numéros
+de page et toute l&#8217;information de renvoi des autres parties du document
+de sorte qu&#8217;elles apparaissent correctement en sortie.
</para>
-<para>Voir <link linkend="filecontents">filecontents</link>, pour un environnement qui permet de grouper un
-fichier externe à créer avec le document principal.
+<para>See <link linkend="Larger-book-template">Larger book template</link> pour un autre exemple de <literal>\includeonly</literal>.
</para>
+<!-- xxx Pourquoi avoir supprimer cette ref. -->
+<!-- @xref{filecontents}, pour un environnement qui permet de grouper un -->
+<!-- fichier externe à créer avec le document racine. -->
-<sect1 label="22.1" id="_005cinclude">
-<title><literal>\include</literal></title>
-<indexterm role="fn"><primary>\include</primary></indexterm>
+
+<sect1 label="24.1" id="_005cendinput">
+<title><literal>\endinput</literal></title>
+
+<indexterm role="fn"><primary>\endinput</primary></indexterm>
<para>Synopsis :
</para>
-<screen>\include{<replaceable>fichier</replaceable>}
+<screen>\endinput
</screen>
-<para>Si aucune commande <literal>\includeonly</literal> n&#8217;est présente, la commande
-<literal>\include</literal> exécute un <literal>\clearpage</literal> pour commencer une nouvelle
-page (voir <link linkend="_005cclearpage">\clearpage</link>), puis elle lit <replaceable>fichier</replaceable>, et ensuite fait
-encore un <literal>\clearpage</literal>.
+<para>Quand vous écrivez <literal>\include{nomfichier}</literal>, alors au sein de
+<filename>nomfichier.tex</filename> le matériel qui vient après <literal>\endinput</literal> n&#8217;est
+pas inclus. Cette commande est optionnelle ; si <filename>nomfichier.tex</filename>
+ne comprend pas de <literal>\endinput</literal> alors &latex; lit tout le fichier.
</para>
-<para>Précédé d&#8217;une commande <literal>\includeonly</literal>, les actions de
-<literal>\include</literal> ne sont exécutées que si <replaceable>fichier</replaceable> est un élément des
-fichiers listés en argument de l&#8217;<literal>\includeonly</literal>. Voir <link linkend="_005cincludeonly">\includeonly</link>.
+<para>Par exemple, supposons que le fichier racine d&#8217;un document a un
+<literal>\input{chap1}</literal> que ce le contenu de <filename>chap1.tex</filename> est ce qui
+suit :
</para>
-<indexterm role="cp"><primary><literal>\include</literal> emboîtés interdits</primary></indexterm>
-<para>La commande <literal>\include</literal> ne doit apparaître ni dans le préambule, ni
-au sein d&#8217;un fichier lu par une autre commande <literal>\include</literal>.
+<screen>\chapter{One} Ce matériel apparaît dans le document. \endinput Ceci
+n'apparaît pas.
+</screen>
+<para>Ceci peut être utile pour placer de la documentation ou des commentaire
+à la fin d&#8217;un fichier, ou pour éviter des caractères indésirable qui
+pourraît s&#8217;ajouter si le fichier est transmis dans le corps d&#8217;un
+courriel. C&#8217;est également utile pour déboguer : une stratégie pour
+localiser des erreurs est de placer un <literal>\endinput</literal> à mi-chemin en
+cours des fichiers inclus et de voir si l&#8217;erreur disparaît. Ensuite,
+sachant quelle moitié contient l&#8217;erreur, en déplaçant le
+<literal>\endinput</literal> à mi-chemin de cette zone circonscrit de plus près
+l&#8217;endroit où elle se trouve. Ainsi on trouve rapidement la ligne
+fautive.
+</para>
+<para>Après avoir lu <literal>\endinput</literal>, &latex; continue à lire jusqu&#8217;à la fin
+de la ligne, ansi il est possible de faire suivre cette ligne par
+quelque-chose qui sera tout de même lu. Ceci vous permet entre autre de
+fermer un <literal>\if...</literal> par un <literal>\fi</literal>.
</para>
-
</sect1>
-<sect1 label="22.2" id="_005cincludeonly">
-<title>\<literal>includeonly</literal></title>
+<sect1 label="24.2" id="_005cinclude-_0026-_005cincludeonly">
+<title><literal>\include</literal> &amp; <literal>\includeonly</literal></title>
+<indexterm role="fn"><primary>\include</primary></indexterm>
<indexterm role="fn"><primary>\includeonly</primary></indexterm>
<para>Synopsis :
</para>
-<screen>\includeonly{<replaceable>fichier1</replaceable>,<replaceable>fichier2</replaceable>,...}
+<screen>\includeonly{ % dans le préambule du document
+ ...
+ <replaceable>nomfichier</replaceable>,
+ ...
+ }
+ ...
+\include{<replaceable>nomfichier</replaceable>} % dans le corps du document
+</screen>
+<para>Apporte du matériel d&#8217;un fichier externe <filename><replaceable>nomfichier</replaceable>.tex</filename>
+dans un document &latex;.
+</para>
+<para>La commande <literal>\include</literal> fait trois choses : elle exécute
+<literal>\clearpage</literal> (see <link linkend="_005cclearpage-_0026-_005ccleardoublepage">\clearpage &amp; \cleardoublepage</link>), puis elle
+insère le matériel à partir du fichier <filename><replaceable>nomfichier</replaceable>.tex</filename> dans
+le document, ensuite fait encore un <literal>\clearpage</literal>. Cette commande ne
+peut apparaître que dans le corps du document.
+</para>
+<para>La commande <literal>\includeonly</literal> contrôle quels fichiers seront lus par
+&latex; lors des commandes <literal>\include</literal> suivantes. Sa liste de noms
+de fichier est séparée par des virgules, et la commande ne peut
+apparaître que dans le préambule, ou même plus tôt, par ex. dans la
+ligne de commande : elle ne peut pas apparaître dans le corps du
+document.
+</para>
+<para>Dans le document racine en exemple ci-dessous, <filename>constitution.tex</filename>, on
+inclut trois fichiers, <filename>preambule.tex</filename>, <filename>articles.tex</filename>, et
+<filename>amendements.tex</filename>.
+</para>
+<screen>\documentclass{book}
+\includeonly{
+ preambule,
+ articles,
+ amendements
+ }
+\begin{document}
+\include{preambule}
+\include{articles}
+\include{amendements}
+\end{document}
</screen>
-<para>La commande <literal>\includeonly</literal> contrôle quels fichiers sont lisible par
-toute commande <literal>\include</literal> venant ensuite. La liste des noms de
-fichier est à éléments séparés par des virgules. Chaque élément
-<replaceable>fichier1</replaceable>, <replaceable>fichier2</replaceable>, &#8230; doit exactement correspondre à
-un nom de fichier spécifié en argument d&#8217;une commande <literal>\include</literal>
-pour que la sélection soit effective.
+<para>Le fichier <filename>preambule.tex</filename> ne contient aucun code spécial ; vous
+avez juste extrait ce chapitre de <filename>consitution.tex</filename> pour le mettre
+dans un fichier séparé pour rendre son édition plus commode.
+</para>
+<screen>\chapter{Préambule}
+Le peuple français proclame solennellement son attachement aux Droits de
+l’Homme et aux principes de la souveraineté nationale tels qu’ils ont
+été définis par la Déclaration de 1789, ...
+</screen>
+<para>Exécuter &latex; sur <filename>constitution.tex</filename> fait apparaître le
+matériel issu de ces trois fichiers dans le document mais génère
+également les fichiers auxiliaires <filename>preamble.aux</filename>,
+<filename>articles.aux</filename>, et <filename>amendements.aux</filename>. Ceux-ci contiennent de
+l&#8217;information telle que les numéros de page et les renvois (see <link linkend="Cross-references">Cross
+references</link>). Si maintenant vous mettez en commentaire les lignes de
+<literal>\includeonly</literal> contenant <literal>preambule</literal> et <literal>amendements</literal> et
+exécutez &latex; de nouveau alors le document résultant ne contiendra
+que le matériel issu de <filename>articles.tex</filename>, mais pas celui de
+<filename>preamblue.tex</filename> ni de <filename>amendements.tex</filename>. Néanmois, la
+totalité de l&#8217;information auxiliaire issue des fichiers omis est
+toujours là, y compris le numéro de la page où commence le chapitre.
+</para>
+<para>S&#8217;il n&#8217;y a pas de <literal>\includeonly</literal> dans le préambule du document,
+alors &latex; inclut tous les fichiers demandés par des commandes
+<literal>\include</literal>.
+</para>
+<para>La commande <literal>\include</literal> fabrique une nouvelle page. Pour éviter
+cela, voir <link linkend="_005cinput">\input</link> (ce qui, cependant, ne retient pas l&#8217;information
+auxiliaire).
+</para>
+<para>See <link linkend="Larger-book-template">Larger book template</link> pour un autre exemple utilisant
+<literal>\include</literal> et <literal>\includeonly</literal>. Cet exemple utilise également
+<literal>\input</literal> pour certain matériel qui ne débute pas nécessairement sur
+une nouvelle page.
+</para>
+<para>Les noms de fichiers peuvent impliquer un chemin.
</para>
-<para>Cette commande ne peut apparaître que dans le préambule.
+<screen>\documentclass{book}
+\includeonly{
+ chapitres/chap1,
+ }
+\begin{document}
+\include{chapitres/chap1}
+\end{document}
+</screen>
+<para>Pour rendre votre document portable vis à vis des diverses distributions
+et plateformes vous devriez éviter les espaces dans les noms de
+fichier. Traditionnnelement on utilise des tirets de 6 ou de 8 à la
+place. Néanmoins, pour le nom &#8216;<literal>amo amas amat</literal>&#8217;, ce qui suit
+fonctionne sous &tex; Live sur GNU/Linux:
</para>
+<screen>\documentclass{book}
+\includeonly{
+ &quot;amo\space amas\space amat&quot;
+ }
+\begin{document}
+\include{&quot;amo\space amas\space amat&quot;}
+\end{document}
+</screen>
+<para>et ceci fonctionne sous MiK&tex; sur Windows:
+</para>
+<screen>\documentclass{book}
+\includeonly{
+ {&quot;amo amas amat&quot;}
+ }
+\begin{document}
+\include{{&quot;amo amas amat&quot;}}
+\end{document}
+</screen>
+<indexterm role="cp"><primary><literal>\include</literal> imbriqués non autorisés</primary></indexterm>
+<indexterm role="cp"><primary>imbrication de <literal>\include</literal> non autorisée</primary></indexterm>
+<para>Vous ne pouvez pas utiliser <literal>\include</literal> au sein d&#8217;un fichier qui
+lui-même est inclus via <literal>\include</literal>, sans quoi vous obtenez l&#8217;erreur
+&#8216;<literal>LaTeX Error: \include cannot be nested</literal>&#8217;. La commande
+<literal>\include</literal> ne peut pas apparaître dans le préambule ; sans quoi
+vous obtenez l&#8217;erreur &#8216;<literal>LaTeX Error: Missing \begin{document}</literal>&#8217;.
+</para>
+<para>Si un fichier que vous incluez par <literal>\include</literal> n&#8217;existe pas, par
+exemple si vous tapez la commande <literal>\include{athiesme}</literal> par erreur
+à la place de <literal>\include{atheisme}</literal>, alors &latex; ne produit pas
+une erreur mais un avertissement &#8216;<literal>No file athiesme.tex.</literal>&#8217; (Il crée
+également le fichier <filename>athiesme.aux</filename>).
+</para>
+<para>Si vous faites un <literal>\include</literal> du fichier racine dans lui-même alors
+vous obtenez tout d&#8217;abord &#8216;<literal>LaTeX Error: Can be used only in
+preamble</literal>&#8217;. Les exécutions suivantes donnent &#8216;<literal>TeX capacity
+exceeded, sorry [text input levels=15]</literal>&#8217;. Pour réparer cela, vous devez
+enlever l&#8217;inclusion <literal>\include{<replaceable>racine</replaceable>}</literal> mais aussi détruire
+le fichier <filename><replaceable>racine</replaceable>.aux</filename> et exécuter de nouveau &latex;.
+</para>
+
+<!-- xxx \includeonly omis = mettre plus haut dans le nœeud, pour la -->
+<!-- xxx progressivité de l'exposé. -->
+
</sect1>
-<sect1 label="22.3" id="_005cinput">
+<sect1 label="24.3" id="_005cinput">
<title>\input</title>
<indexterm role="fn"><primary>\input</primary></indexterm>
@@ -9375,45 +12915,147 @@ n&#8217;est trouvé avec ce nom, alors on essaie le <replaceable>nomfichier</rep
</para>
</sect1>
</chapter>
-<chapter label="23" id="Front_002fback-matter">
-<title>Prologue et épilogue</title>
+<chapter label="25" id="Front_002fback-matter">
+<title>Parties pré/post-liminaires</title>
-<sect1 label="23.1" id="Tables-of-contents">
-<title>Tables des matières</title>
+<sect1 label="25.1" id="Table-of-contents-etc_002e">
+<title>Table des matières etc.</title>
<indexterm role="cp"><primary>table des matière, création</primary></indexterm>
<indexterm role="fn"><primary>\tableofcontents</primary></indexterm>
<indexterm role="fn"><primary>.toc, fichier</primary></indexterm>
-<para>On produit une table des matières avec la commande
-<literal>\tableofcontents</literal>. Placez la commande à l&#8217;endroit même où vous
-voulez que la table des matière apparaisse ; &latex; fera le reste pour
-vous. Une seconde compilation est nécessaire pour qu&#8217;un fichier
-<filename>.toc</filename> ait été produit à la précédente.
-</para>
-<para>La commande <literal>\tableofcontents</literal> produit un titre, mais il ne produit
-pas automatiquement un début de nouvelle page. Si vous voulez une
-nouvelle page après la table des matières, mettez une commande
-<literal>\newpage</literal> après la commande <literal>\tableofcontents</literal>.
-</para>
<indexterm role="fn"><primary>\listoffigures</primary></indexterm>
<indexterm role="fn"><primary>\listoftables</primary></indexterm>
-<para>Les commandes analogues <literal>\listoffigures</literal> et <literal>\listoftables</literal>
-produisent respectivement une liste des figures et une listes des
-tableaux. Le fonctionnement est exactement le même que pour la table des matières.
+<indexterm role="fn"><primary>.lof fichier</primary></indexterm>
+<indexterm role="fn"><primary>.lot fichier</primary></indexterm>
+
+<para>Synopsis, l&#8217;un parmi ceux qui suivent :
</para>
-<indexterm role="fn"><primary>\nofiles</primary></indexterm>
-<para>La commande <literal>\nofiles</literal> l&#8217;emporte sur ces commandes, et
-<emphasis>empèche</emphasis> la génération de ces listes.
+<screen>\tableofcontents
+\listoffigures
+\listoftables
+</screen>
+<para>Produit une table des matières, ou une liste des figures, ou une liste
+des tableaux. Placez la commande à l&#8217;endroit même où vous voulez que la
+table ou liste apparaisse. Vous n&#8217;avez pas à la renseigner ; par
+exemple, typiquement les entrées de la table des matières sont
+automatiquement générées à partir des commandes de rubricage
+<literal>\chapter</literal>, etc.
+</para>
+<para>L&#8217;exemple ci-dessous illustre la première commande,
+<literal>\tableofcontents</literal>. &latex; produit une table des matières sur la
+première page du livre.
+</para>
+<screen>\documentclass{book}
+% \setcounter{tocdepth}{1}
+\begin{document}
+\tableofcontents\newpage
+ ...
+\chapter{...}
+ ...
+\section{...}
+ ...
+\subsection{...}
+ ...
+\end{document}
+</screen>
+<para>En décommentant la deuxième ligne on peut limiter la table à ne lister
+que les rubriques issues de <literal>\chapter</literal> et <literal>\section</literal>, mais pas
+celle issue de <literal>\subsection</literal>, parce que la commande <literal>\section</literal>
+a pour niveau 1. See <link linkend="Sectioning">Sectioning</link> pour les numéros de niveaux des
+rubriques. Pour plus ample information sur <literal>tocdepth</literal>
+see <link linkend="Sectioning_002ftocdepth">Sectioning/tocdepth</link>.
+</para>
+<para>Un autre exemple de l&#8217;utilisation de <literal>\tableofcontents</literal> est dans
+<link linkend="Larger-book-template">Larger book template</link>.
+</para>
+<para>Si vous désirez un saut de page après la table des matières, insérez une commande
+<literal>\newpage</literal> après la commande <literal>\tableofcontents</literal>, comme ci-dessus.
+</para>
+<para>Pour fabriquer la table des matières, &latex; stocke l&#8217;information dans
+un fichier auxiliaire nommé <filename><replaceable>fichier-racine</replaceable>.toc</filename>
+(see <link linkend="Splitting-the-input">Splitting the input</link>). Par exemple, le fichier
+&latex; <filename>test.tex</filename> ci-dessous :
+</para>
+<screen>\documentclass{article}
+\begin{document}
+\tableofcontents\newpage
+\section{Premièrement}
+\subsection{Deuxièmement}
+ ...
+</screen>
+<para>écrit la ligne suivante dans <filename>test.toc</filename> :
+</para>
+<screen>\contentsline {section}{\numberline {1}Premièrement}{2}
+\contentsline {subsection}{\numberline {1.1}Deuxièmement}{2}
+</screen>
+<para>L&#8217;indication <literal>section</literal> ou <literal>subsection</literal> donne le type de
+rubrique. Le crochet <literal>\numberline</literal> vous permet de changer la façon
+dont l&#8217;information apparaît au sein de la table des matières. Son
+unique argument, <literal>1</literal> ou <literal>1.1</literal>, est le numéro de la rubrique
+alors que le reste du deuxième argument de <literal>\contentsline</literal>,
+<literal>Premièrement</literal> ou <literal>Deuxièmement</literal>, est le titre. Finalement,
+le troisième argument, <literal>2</literal>, est le numéro de la page à laquelle les
+rubriques débutent.
+</para>
+<para>Une conséquence de cette stratégie de stockage de fichier auxiliaire est
+que pour obtenir correctement la page de table des matières vous devez
+exécuter &latex; deux fois, une fois pour stocker l&#8217;information et une
+fois pour l&#8217;obtenir.
+<!-- xxx Et avec les .lot et .lof c'est aussi 2 fois, mais parce que le -->
+<!-- .aux est relu avant le .lot/.lof -->
+En particulier, la première fois que vous exécutez &latex; sur un
+nouveau document, la page de table des matières est vide hormis le titre
+&#8216;<literal>Table des matières</literal>&#8217;. Il suffit de l&#8217;exécuter de nouveau.
+</para>
+<!-- xxx ajouter que les fichier .lot et .lof sont renseignés par la commande \caption -->
+<para>Les commandes <literal>\listoffigures</literal> et <literal>\listoftables</literal> produisent
+une liste des figures et une liste des tables. Elles fonctionnent de la
+même façon que les commandes pour la table des martières ; notamment
+elles fonctionnent avec l&#8217;information stockée dans des fichiers
+<filename>.lof</filename> et <filename>.lot</filename>.
+</para>
+<para>Pour modifier le titre de la page de table des matières, inspirez vous
+la la première ligne de l&#8217;exemple suivant :
+</para>
+<screen>\renewcommand{\contentsname}{Table des matières}
+\renewcommand{\listfigurename}{Tracé de courbes}
+\renewcommand{\listtablename}{Tableaux}
+</screen>
+<para><indexterm role="fn"><primary>paquetage <literal>babel</literal></primary></indexterm>
+<indexterm role="fn"><primary><literal>babel</literal>, paquetage</primary></indexterm>
+</para>
+<indexterm role="fn"><primary>paquetage <literal>polyglossia</literal></primary></indexterm>
+<indexterm role="fn"><primary><literal>polyglossia</literal>, paquetage</primary></indexterm>
+
+<para>De même, les deux autres lignes s&#8217;occupent des deux autres. Des
+paquetages d&#8217;internationalisation tels que <filename>babel</filename> ou
+<filename>polyglossia</filename> modifient les titres en fonction de la langue de base
+sélectionnée.
+</para>
+<indexterm role="fn"><primary>paquetage <literal>tocloft</literal></primary></indexterm>
+<indexterm role="fn"><primary><literal>tocloft</literal>, paquetage</primary></indexterm>
+
+<indexterm role="fn"><primary>paquetage <literal>tocbibbind</literal></primary></indexterm>
+<indexterm role="fn"><primary><literal>tocbibbind</literal>, paquetage</primary></indexterm>
+
+<para>Le CTAN a beaucoup de paquetages traitant de la table des matières et
+des listes de figures et de tableaux. L&#8217;un d&#8217;eux bien commode pour
+ajuster certains aspects du traitement par défaut, tels que
+l&#8217;espacement, est <filename>tocloft</filename>. Et <filename>tocbibbind</filename> permet d&#8217;ajouter
+automatiquement la bibliograpghie, les indexes, etc. à la table des
+matières.
</para>
-<sect2 label="23.1.1" id="_005caddcontentsline">
+<sect2 label="25.1.1" id="_005caddcontentsline">
<title><literal>\addcontentsline</literal></title>
<indexterm role="fn"><primary>\addcontentsline{<replaceable>ext</replaceable>}{<replaceable>unit</replaceable>}{<replaceable>texte</replaceable>}</primary></indexterm>
-<indexterm role="cp"><primary>table of contents entry, manually adding</primary></indexterm>
+<indexterm role="cp"><primary>table des matières, ajouter manuellement un article</primary></indexterm>
+<!-- xx Revoir la trad. -->
<para>Synopsis :
</para>
@@ -9454,7 +13096,7 @@ suivantes, selon la valeur de l&#8217;argument <replaceable>ext</replaceable> :
</sect2>
-<sect2 label="23.1.2" id="_005caddtocontents">
+<sect2 label="25.1.2" id="_005caddtocontents">
<title><literal>\addtocontents</literal></title>
<indexterm role="fn"><primary>\addtocontents{<replaceable>ext</replaceable>}{<replaceable>texte</replaceable>}</primary></indexterm>
@@ -9472,10 +13114,39 @@ figures), ou <filename>lot</filename> (liste des tableaux).
</listitem></varlistentry><varlistentry><term><replaceable>texte</replaceable>
</term><listitem><para>Le texte à écrire.
</para></listitem></varlistentry></variablelist>
+</sect2>
+<sect2 label="25.1.3" id="_005cnofiles">
+<title><literal>\nofiles</literal></title>
+
+<indexterm role="fn"><primary>\nofiles</primary></indexterm>
+
+<para>Synopsis :
+</para>
+<screen>\nofiles
+</screen>
+<para>Empêche &latex; d&#8217;écrire quelque fichier auxiliaire que ce soit. Les
+seules sorites seront les fichiers <filename>.log</filename> et <filename>.pdf</filename> (ou
+<filename>.dvi</filename>). Cette commande ne peut être placée que dans le preambule.
+</para>
+<para>À cause de la commande <literal>\nofiles</literal> dans cet exemple aucun fichier
+<filename>.toc</filename> n&#8217;est produit.
+</para>
+<screen>\documentclass{book}
+\nofiles
+\begin{document}
+\tableofcontents\newpage
+\chapter{...}
+ ...
+</screen>
+<para>&latex; n&#8217;efface pas les fichiers auxiliaires existants, de sorte que
+si vous insérer la commande <literal>\nofiles</literal> après avoir compilé le
+fichier et obtenu un fichier <filename>.toc</filename> alors la page de table des
+matières contiendra l&#8217;ancienne information.
+</para>
</sect2>
</sect1>
-<sect1 label="23.2" id="Glossaries">
+<sect1 label="25.2" id="Glossaries">
<title>Glossaires</title>
<indexterm role="cp"><primary>glossaires</primary></indexterm>
@@ -9496,9 +13167,9 @@ est la valeur courante de <literal>\thepage</literal>.
<para>Le paquetage <literal>glossary</literal> disponible sur le CTAN fournit une prise en
charge de glossaires plus élaborée.
</para>
-
+<!-- Revoir la trad. -->
</sect1>
-<sect1 label="23.3" id="Indexes">
+<sect1 label="25.3" id="Indexes">
<title>Index</title>
<indexterm role="cp"><primary>index</primary></indexterm>
@@ -9517,7 +13188,8 @@ préambule.
<literal>\indexentry{<replaceable>texte</replaceable>}{<replaceable>numpage</replaceable>}</literal>, où <replaceable>numpage</replaceable> est
la valeur courante de <literal>\thepage</literal>.
</para>
-<indexterm role="cp"><primary>« Voir » et « Voir aussi », article d&#8217;index</primary></indexterm>
+<indexterm role="cp"><primary>Voir et Voir aussi, article d&#8217;index</primary></indexterm>
+<indexterm role="cp"><primary>article d&#8217;index, « Voir » et « Voir aussi »</primary></indexterm>
<para>Pour générer un article d&#8217;index pour « toto » qui dit « Voir titi »,
utilisez une barre verticale : <literal>\index{toto|see{titi}}</literal>.
Utilisez <literal>seealso</literal> au lieu de <literal>see</literal> pour fabriquer un article
@@ -9525,6 +13197,11 @@ en « Voir aussi ».
</para>
<indexterm role="fn"><primary>\seename</primary></indexterm>
<indexterm role="fn"><primary>\alsoname</primary></indexterm>
+<indexterm role="fn"><primary>paquetage <literal>babel</literal></primary></indexterm>
+<indexterm role="fn"><primary><literal>babel</literal>, paquetage</primary></indexterm>
+<indexterm role="fn"><primary>paquetage <literal>polyglossia</literal></primary></indexterm>
+<indexterm role="fn"><primary><literal>polyglossia</literal>, paquetage</primary></indexterm>
+
<para>Le texte « Voir » est défini par la macro <literal>\seename</literal>, et le texte
« Voir aussi » par la macro <literal>\alsoname</literal>. Ils peuvent être redéfinis
pour d&#8217;autres langages.
@@ -9542,6 +13219,7 @@ pour composer l&#8217;index.
<indexterm role="fn"><primary>\printindex</primary></indexterm>
<indexterm role="fn"><primary>paquetage <literal>makeidx</literal></primary></indexterm>
<indexterm role="fn"><primary><literal>makeidx</literal>, paquetage</primary></indexterm>
+
<para>L&#8217;index est d&#8217;ordinaire généré avec la commande <literal>\printindex</literal>.
Celle-ci est définie dans le paquetage <literal>makeidx</literal>, ainsi vous devez
mettre <literal>\usepackage{makeidx}</literal> dans le préambule.
@@ -9553,12 +13231,14 @@ nouvelle lettre dans l&#8217;index imprimé ; sa valeur par défaut est
</para>
<indexterm role="fn"><primary>paquetage <literal>showidx</literal></primary></indexterm>
<indexterm role="fn"><primary><literal>showidx</literal>, paquetage</primary></indexterm>
+
<para>Le paquetage <literal>showidx</literal> a pour effet que chaque article de l&#8217;index
est affiché dans la marge de la page où l&#8217;article apparaît. Ceci peut
aider à la préparation de l&#8217;index.
</para>
<indexterm role="fn"><primary>paquetage <literal>multind</literal></primary></indexterm>
<indexterm role="fn"><primary><literal>multind</literal>, paquetage</primary></indexterm>
+
<para>Le paquetage <literal>multind</literal> prend en charge la pluralité des index.
Voir aussi l&#8217;article de la FAQ &tex; FAQ à ce propos,
<ulink url="http://www.tex.ac.uk/cgi-bin/texfaq2html?label=multind">http://www.tex.ac.uk/cgi-bin/texfaq2html?label=multind</ulink>.
@@ -9566,7 +13246,7 @@ Voir aussi l&#8217;article de la FAQ &tex; FAQ à ce propos,
</sect1>
</chapter>
-<chapter label="24" id="Letters">
+<chapter label="26" id="Letters">
<title>Des lettres</title>
<indexterm role="cp"><primary>lettres, écrire des</primary></indexterm>
<indexterm role="cp"><primary>écrire des lettres</primary></indexterm>
@@ -9662,7 +13342,7 @@ I ne suis pas intéressé à faire affaire avec vous.
</para>
-<sect1 label="24.1" id="_005caddress">
+<sect1 label="26.1" id="_005caddress">
<title><literal>\address</literal></title>
<indexterm role="fn"><primary>\address</primary></indexterm>
@@ -9681,14 +13361,14 @@ individuel.
</para>
<para>Cette commande est optionnelle : sans la déclaration <literal>\address</literal> la
lettre est formatée avec un espace à blanc en haut de sorte à pouvoir
-être imprimée sur du papier à en-tête pré-imprimé. (Voir <link linkend="Overview">Overview</link>,
+être imprimée sur du papier à en-tête pré-imprimé. (See <link linkend="Overview">Overview</link>,
pour les détails concernant votre implémentation locale). Avec la
déclaration <literal>\address</literal>, elle est formatée comme une lettre
personnelle.
</para>
</sect1>
-<sect1 label="24.2" id="_005ccc">
+<sect1 label="26.2" id="_005ccc">
<title><literal>\cc</literal></title>
<indexterm role="fn"><primary>\cc</primary></indexterm>
@@ -9710,7 +13390,7 @@ les avec une double contr&#8217;oblique <literal>\\</literal>, comme dans :
</sect1>
-<sect1 label="24.3" id="_005cclosing">
+<sect1 label="26.3" id="_005cclosing">
<title><literal>\closing</literal></title>
<indexterm role="fn"><primary>\closing</primary></indexterm>
@@ -9733,7 +13413,7 @@ optionnelle). Par exemple :
</screen>
</sect1>
-<sect1 label="24.4" id="_005cencl">
+<sect1 label="26.4" id="_005cencl">
<title><literal>\encl</literal></title>
<indexterm role="fn"><primary>\encl</primary></indexterm>
@@ -9747,7 +13427,7 @@ optionnelle). Par exemple :
</para>
</sect1>
-<sect1 label="24.5" id="_005clocation">
+<sect1 label="26.5" id="_005clocation">
<title><literal>\location</literal></title>
<indexterm role="fn"><primary>\location</primary></indexterm>
@@ -9760,7 +13440,7 @@ seulement si le style de la page est <literal>firstpage</literal>.
</para>
</sect1>
-<sect1 label="24.6" id="_005cmakelabels">
+<sect1 label="26.6" id="_005cmakelabels">
<title><literal>\makelabels</literal></title>
<indexterm role="fn"><primary>\makelabels</primary></indexterm>
@@ -9812,7 +13492,7 @@ préambule :
</screen>
</listitem></orderedlist>
</sect1>
-<sect1 label="24.7" id="_005cname">
+<sect1 label="26.7" id="_005cname">
<title><literal>\name</literal></title>
<indexterm role="fn"><primary>\name</primary></indexterm>
@@ -9823,7 +13503,7 @@ retour.
</para>
</sect1>
-<sect1 label="24.8" id="_005copening">
+<sect1 label="26.8" id="_005copening">
<title><literal>\opening{<replaceable>texte</replaceable>}</literal></title>
<indexterm role="fn"><primary>\opening</primary></indexterm>
<indexterm role="cp"><primary>lettres, commencer</primary></indexterm>
@@ -9841,7 +13521,7 @@ texte d&#8217;<firstterm>appel</firstterm> de votre lettre. Par exemple :
</screen>
</sect1>
-<sect1 label="24.9" id="_005cps">
+<sect1 label="26.9" id="_005cps">
<title><literal>\ps</literal></title>
<indexterm role="fn"><primary>\ps</primary></indexterm>
<indexterm role="cp"><primary>postscriptum, dans une lettre</primary></indexterm>
@@ -9856,7 +13536,7 @@ texte d&#8217;<firstterm>appel</firstterm> de votre lettre. Par exemple :
</para>
</sect1>
-<sect1 label="24.10" id="_005csignature">
+<sect1 label="26.10" id="_005csignature">
<title><literal>\signature{<replaceable>texte</replaceable>}</literal></title>
<indexterm role="fn"><primary>\signature</primary></indexterm>
@@ -9915,7 +13595,7 @@ le préambule).
</sect1>
-<sect1 label="24.11" id="_005ctelephone">
+<sect1 label="26.11" id="_005ctelephone">
<title><literal>\telephone</literal></title>
<indexterm role="fn"><primary>\telephone</primary></indexterm>
@@ -9933,13 +13613,137 @@ il apparaît en bas à droite de la page.
</sect1>
</chapter>
-<chapter label="25" id="Terminal-input_002foutput">
+<chapter label="27" id="Terminal-input_002foutput">
<title>Entrée/sortie console</title>
<indexterm role="cp"><primary>entrée/sortie console</primary></indexterm>
+<sect1 label="27.1" id="_005copenin-_0026-_005copenout">
+<title><literal>\openin</literal> &amp; <literal>\openout</literal></title>
+
+<indexterm role="fn"><primary>\openin</primary></indexterm>
+<indexterm role="fn"><primary>\openout</primary></indexterm>
+<indexterm role="fn"><primary>\closein</primary></indexterm>
+<indexterm role="fn"><primary>\closeout</primary></indexterm>
+<indexterm role="cp"><primary>file, opening</primary></indexterm>
+<indexterm role="cp"><primary>file, closing</primary></indexterm>
+<indexterm role="cp"><primary>open a file</primary></indexterm>
+
+<para>Synopsis :
+</para>
+<screen>\openin <replaceable>numéro</replaceable>=<replaceable>nomfichier</replaceable>
+</screen>
+<para>ou :
+</para>
+<screen>\openout <replaceable>numéro</replaceable>=<replaceable>nomfichier</replaceable>
+</screen>
+<para>Ouvre un fichier pour y lire, ou pour y écrire. Le <replaceable>numéro</replaceable> doit
+être entre 0 et 15, comme dans <literal>\openin3</literal> (dans Lua&latex; <replaceable>numéro</replaceable>
+peut être entre 0 et 255).
+</para>
+<para>Ici &tex; ouvre le fichier le fichier <filename>presidents.tex</filename> en lecture.
+</para>
+<screen>\newread\fichierpresidents
+\openin\fichierpresidents=presidents
+\typeout{fichierpresidents vaut \the\fichierpresidents}
+\read\fichierpresidents to\presidentligne
+\typeout{\presidentligne}
+</screen>
+<para>La commande <literal>\newread</literal> alloue des numéros de flux d&#8217;entrée de 0
+à 15 (il y a aussi une commande <literal>\newwrite</literal>). La variable
+<literal>\fichierpresidents</literal> est plus facile à mémoriser mais sous le capot
+ce n&#8217;est rien de plus qu&#8217;un numéro ; le premier <literal>\typeout</literal> donne
+queleque-chose du genre de &#8216;<literal>fichierpresidents vaut 1</literal>&#8217;. De plus,
+<literal>\newread</literal> garde la trace de l&#8217;allocation de sorte que si vous en
+utilisez trop alors vous obtiendrez une erreur du genre de &#8216;<literal>! No
+room for a new \read</literal>&#8217;. Le second <literal>\typeout</literal> produit la première
+ligne du fihcier, quelque-chose du genre de &#8216;<literal>1 Bonaparte,
+Louis-Napoléon</literal>&#8217;.
+</para>
+<para>D&#8217;ordinaire &tex; n&#8217;essaie pas d&#8217;ouvrir le fichier jusqu&#8217;à la prochaine
+éjection de page. Pour changer cela, utilisez
+<literal>\immediate\openin <replaceable>numéro</replaceable>=<replaceable>nomfichier</replaceable></literal> ou
+<literal>\immediate\openout <replaceable>numéro</replaceable>=<replaceable>nomfichier</replaceable></literal>.
+</para>
+<para>Fermez les fichiers avec <literal>\closein <replaceable>numéro</replaceable></literal> et
+<literal>\closeout <replaceable>numéro</replaceable></literal>.
+</para>
+<para>La façon dont &latex; manipule les noms de fichiers varie selon les
+distributions, et peut même varier d&#8217;une version à l&#8217;autre d&#8217;une même
+distribution. Si le nom de fichier n&#8217;a pas d&#8217;extension alors &tex; y
+ajoute un <filename>.tex</filename>. L&#8217;exemple suivant crée <filename>presidents.tex</filename>, y
+écrit une ligne, et le ferme.
+</para>
+<screen>\newwrite\fichierpresidents
+\openout\fichierpresidents=presidents
+\write\fichierpresidents{1 Bonaparte, Louis-Napoléon}
+\closeout\fichierpresidents
+</screen>
+<para>Mais les noms de fichier avec un point peuvent causer des problèmes : si
+&tex; tombe sur un <replaceable>nomfichier</replaceable> comme <filename>presidents.dat</filename> il se
+peut qu&#8217;il cherche d&#8217;abord <filename>presidents.dat.tex</filename> et ensuite
+<filename>presidents.dat</filename>, ou bien le contraire. La documentation de votre
+distribution devrait en dire plus, et si cela fonctionne pour vous tant
+mieux, mais pour assurer une portabilité complète le mieux et d&#8217;utiliser
+des noms de fichier ne contenant que les vingt-six lettres ASCII
+(insensible à la casse case-sensitive) et les dix chiffres, ainsi que
+les tiret de 8 &#8216;<literal>_</literal>&#8217; et de 6 &#8216;<literal>-</literal>&#8217;, et en particulier sans point
+ni espace.
+</para>
+<para>Pour <literal>\openin</literal>, si &tex; ne peut pas trouver le fichier alors il
+ne produit pas une erreur. Il ne fait que considérer que ce flux n&#8217;est
+pas ouvert (ce qu&#8217;on peut vérifier avec <literal>\ifeof</literal> ; on peut
+également recourir à la commande <literal>\InputIfFileExists</literal>, see <link linkend="Class-and-package-commands">Class
+and package commands</link>). Si vous essayer d&#8217;utiliser le même numéro deux
+fois, &latex; ne produit pas d&#8217;erreur. Si vous essayer d&#8217;utiliser un
+mauvais numéro, alors vous obtiendrez un message d&#8217;erreur du genre de
+&#8216;<literal>! Bad number (16). &lt;to be read again&gt; = l.30 \openin16=test.jh</literal>&#8217;.
+</para>
+</sect1>
+<sect1 label="27.2" id="_005cread">
+<title><literal>\read</literal></title>
+
+<indexterm role="fn"><primary>\read</primary></indexterm>
+<indexterm role="cp"><primary>fichier, lecture d&#8217;un</primary></indexterm>
+<indexterm role="cp"><primary>lire un fichier</primary></indexterm>
+<indexterm role="cp"><primary>lecture d&#8217;un fichier</primary></indexterm>
-<sect1 label="25.1" id="_005ctypein">
+<para>Synopsis :
+</para>
+<screen>\read <replaceable>numéro</replaceable> to<replaceable>macro</replaceable>
+</screen>
+<para>Fait que la commande <replaceable>macro</replaceable> contienne la ligne suivante d&#8217;entrée du
+flux de texte <replaceable>numéro</replaceable>, comme dans <literal>\read5 to\data</literal>.
+</para>
+<para>L&#8217;exemple suivant ouvre le fichier <filename>mel.tex</filename> en lecture, me le
+contenu de la première ligne dans la commande <literal>\courriel</literal>, et
+ensuite ferme le fichier.
+</para>
+<screen>\newread\fichierreception
+\openin\fichierreception=mel
+\read\fichierreception to\courriel
+\typeout{Adresse mél : \courriel}
+\closein\fichierreception
+</screen>
+<para>Si <replaceable>numéro</replaceable> est hors de l&#8217;intervalle de 0 à 15 ou si aucun fichier
+avec ce numéro n&#8217;est ouvert, ou si le fichier est à sa fin, alors
+<literal>\read</literal> prend son entrée à partir du terminal. Notez, cependant,
+que la méthode naturelle en &latex; de prendre en entrée à partir du
+terminal est <literal>\typein</literal> (see <link linkend="_005ctypein">\typein</link>).
+</para>
+<para>Pour lire un fichier entier en une fois utilisez <literal>\input</literal>
+(see <link linkend="_005cinput">\input</link>) ou <literal>\include</literal> (see <link linkend="_005cinclude-_0026-_005cincludeonly">\include &amp; \includeonly</link>).
+</para>
+<indexterm role="fn"><primary>paquetage <literal>datatool</literal></primary></indexterm>
+<indexterm role="fn"><primary><literal>datatool</literal>, paquetage</primary></indexterm>
+
+
+<para>Une raison usuelle de vouloir lire d&#8217;un fichier de données est de faire
+du publipostage. CTAN a plusieurs paquetage pour cela ; parmi lesquels
+<filename>datatool</filename>.
+</para>
+</sect1>
+<sect1 label="27.3" id="_005ctypein">
<title><literal>\typein[<replaceable>cmd</replaceable>]{<replaceable>msg</replaceable>}</literal></title>
<indexterm role="fn"><primary>\typein</primary></indexterm>
@@ -9958,7 +13762,7 @@ le texte en entrée qui a été tapé.
</para>
</sect1>
-<sect1 label="25.2" id="_005ctypeout">
+<sect1 label="27.4" id="_005ctypeout">
<title><literal>\typeout{<replaceable>msg</replaceable>}</literal></title>
<indexterm role="fn"><primary>\typeout</primary></indexterm>
@@ -9978,41 +13782,661 @@ commande s&#8217;appliquent à <literal>msg</literal>. Une commande <literal>\sp
l&#8217;entourent. Un <literal>^^J</literal> dans <literal>msg</literal> tape un saut à la ligne.
</para>
</sect1>
+<sect1 label="27.5" id="_005cwrite">
+<title><literal>\write</literal></title>
+
+<indexterm role="fn"><primary>\write</primary></indexterm>
+
+<para>Synopsis :
+</para>
+<screen>\write <replaceable>numéro</replaceable>{<replaceable>chaîne</replaceable>}
+</screen>
+<para>Écrit <replaceable>chaîne</replaceable> vers le fichier journal (<filename>.log</filename>), vers le
+terminal, ou vers un fichier ouvert par <literal>\openout</literal>. Par exemple,
+<literal>\write6</literal> écrit vers le flux textuel numéro 6
+</para>
+<para>Si le code suivant apparaît dans le fichier <filename><replaceable>fichierbase</replaceable>.tex</filename>
+alors cela ouvre le fichier <filename><replaceable>fichierbase</replaceable>.jh</filename>, y écrit
+&#8216;<literal>Bonjour tout le monde !</literal>&#8217; et un saut le ligne, et ferme ce fichier.
+</para>
+<screen>\newwrite\monfichier
+\immediate\openout\monfichier=\jobname.jh % \jobname est le nom de base fichier racine
+...
+\immediate\write\monfichier{Bonjour tout le monde !}
+ ...
+\immediate\closeout\monfichier
+</screen>
+<indexterm role="fn"><primary>\newwrite</primary></indexterm>
+<para>Le <literal>\newwrite</literal> alloue un numéro de flux, en lui donnant un nom
+symbolique pour se faciliter la vie, de sorte que <literal>flux
+\newwrite\monfichier\the\monfichier</literal> produit quelque-chose du genre de
+&#8216;<literal>flux 3</literal>&#8217;. Ensuite <literal>\openout</literal> associe le numéro de flux avec
+le nom de fichier fourni. Et puis à la fin &tex; exécute
+<literal>\write3</literal> ce qui place la chaîne dans le fichier.
+</para>
+<indexterm role="cp"><primary>journal, écrire vers le fichier</primary></indexterm>
+<indexterm role="cp"><primary>terminal, écrire vers le</primary></indexterm>
+<indexterm role="cp"><primary><inlineequation><mathphrase>-1</mathphrase></inlineequation>, écrire dans le flux numéro</primary></indexterm>
+<para>Typiquement <replaceable>numéro</replaceable> est compris entre 0 et 15, parce que typiquement
+les auteurs &latex; suivent l&#8217;exemple précédent et le numéro est alloué
+par le système. Si <replaceable>numéro</replaceable> est hors de l&#8217;intervalle de 0 à 15 ou
+si il n&#8217;est pas associé à un fichier ouvert alors &latex; écrit
+<replaceable>chaîne</replaceable> vers le fichier journal. Si <replaceable>numéro</replaceable> est positif alors
+ne plus &latex; écrit <replaceable>chaîne</replaceable> vers le terminal. Ainsi, <literal>test
+\write-1{Bonjour tout le monde !}</literal> place &#8216;<literal>Bonjour tout le
+monde !</literal>&#8217; suivi d&#8217;un saut de ligne dans le fichier journal (c&#8217;est cez que
+la commande <literal>\wlog</literal> fait ; see <link linkend="_005cwlog">\wlog</link>). Et
+<literal>\write100{Bonjour tout le monde !}</literal> met la même chose dans le
+fichier jornal mais aussi met &#8216;<literal>Bonjour tout le monde !</literal>&#8217; suivi d&#8217;un
+saut de ligne dans la sortie terminal. (Mais 16, 17, et 18 sont des
+valeurs spéciales de <replaceable>numéro</replaceable> ; voir ci-dessous.)
+</para>
+<indexterm role="cp"><primary>Lua&tex;, 256 flux de sortie dans</primary></indexterm>
+<para>Dans Lua&tex;, au lieu de 16 flux de sortie il y en a 256
+(see <link linkend="TeX-engines">&tex; engines</link>).
+</para>
+<indexterm role="fn"><primary>\@auxout</primary></indexterm>
+<indexterm role="fn"><primary>\@mainaux</primary></indexterm>
+<para>Utilisez <literal>\write\@auxout{<replaceable>chaîne</replaceable>}</literal> pour écrire vers le
+fichier <filename>.aux</filename> courant qui est associé soit au fichier racine soit
+au fichier inclus courant ; et utilisez
+<literal>\write\@mainaux{<replaceable>chaîne</replaceable>}</literal> pour écrire le fichier
+<filename>.aux</filename> principal. Ces noms symboliques sont définis par &latex;.
+</para>
+<!-- credit: David Carlisle https://tex.stackexchange.com/a/115933/121234 -->
+<para>Par défaut &latex; n&#8217;écrit pas <replaceable>chaîne</replaceable> vers le fichier
+immediatement. C&#8217;est ainsi parce que, par exemple, vous pourriez avoir
+besoin de <literal>\write</literal> pour sauvegarder le numéro de page courant, mais
+au moment où &tex; rencontre une commande <literal>\write</literal> tpyiquement il
+ne connaît pas quel est le numéro de page, puisque il n&#8217;a pas encore
+découpé la sortie en pages. Ainsi, vous utilisez <literal>\write</literal> dans
+l&#8217;un des trois contextes suivants :
+</para>
+<screen>\immediate\write\@auxout{<replaceable>chaîne</replaceable>} %1
+\write\@auxout{<replaceable>chaîne</replaceable>} %2
+\protected@write\@auxout{}{<replaceable>chaîne</replaceable>} %3
+</screen>
+<orderedlist numeration="arabic"><listitem><indexterm role="cp"><primary><literal>\write</literal> immédiat</primary></indexterm>
+<indexterm role="fn"><primary>\immediate\write</primary></indexterm>
+<para>Avec le premier, &latex; écrit <replaceable>chaîne</replaceable> vers le fichier
+immédiatement. Toutes les macros dans <replaceable>chaîne</replaceable> sont développées à
+fond (exactement comme dans <literal>\edef</literal> de sorte que pour empêcher le
+développement vous devez utiliser <literal>\noexpand</literal>, un <literal>toks</literal>, etc.
+mais avec la différence que vous devez utiliser <literal>#</literal> au lieu de
+<literal>##</literal>).
+</para>
+</listitem><listitem><indexterm role="cp"><primary><literal>\write</literal> retardé</primary></indexterm>
+<indexterm role="cp"><primary>élément extraordinaire</primary></indexterm>
+<indexterm role="fn"><primary>\shipout et développement</primary></indexterm>
+<para>Avec le deuxième, <replaceable>chaîne</replaceable> est stocké dans la liste courante des
+choses (comme un élémént « extraordinaire » de &tex;) et conservé
+jusqu&#8217;à ce que la page soit éjectée et de la même manière les macros ne
+sont pas développées jusqu&#8217;à l&#8217;éjection (<literal>\shipout</literal>). Au moment du
+<literal>\shipout</literal>, <replaceable>chaîne</replaceable> est développée à fond.
+</para>
+</listitem><listitem><indexterm role="fn"><primary>\protected@write</primary></indexterm>
+<para>Le troisième, <literal>\protected@write</literal>, est sembable au deuxième sauf
+que vous pouvez utiliser <literal>\protect</literal> pour éviter le
+développement. Le premier argument qui est en plus vous permet d&#8217;insérer
+locallement des définitions supplémentaires pour que plus de macros
+soient protégées ou pour avoir d&#8217;autres définitions spéciales pendant
+l&#8217;écriture.
+</para></listitem></orderedlist>
+
+<para>Voici un exemple simple de développement avec <literal>\write</literal> dans lequel
+<replaceable>chaîne</replaceable> contient une séquence de contrôle <literal>\triplex</literal> que l&#8217;on
+a définie comme le texte &#8216;<literal>XYZ</literal>&#8217; :
+</para>
+<screen>\newwrite\fichierjh
+\openout\fichierjh=test.jh
+\newcommand{\triplex}{XYZ}
+\write\fichierjh{test \triplex test}
+</screen>
+<para>Ceci résulte en ce que le fichier <filename>test.jh</filename> contienne le texte
+&#8216;<literal>test XYZtest</literal>&#8217; suivi d&#8217;un saut de ligne.
+</para>
+<indexterm role="cp"><primary><literal>\write</literal>, flux 16, 17, 18</primary></indexterm>
+<para>Les cas où <replaceable>numéro</replaceable> vaut 16, 17, ou 18 sont spéciaux. À cause du
+comportement de <literal>\write</literal> quand <replaceable>numéro</replaceable> est hors de
+l&#8217;intervalle de 0 à 15 qu&#8217;on a déjà décrit plus haut, dans Plain &tex;
+<literal>\write16</literal> et <literal>\write17</literal> étaient parfois utilisés pour écrire
+dans le fichier journal et le terminal ; toutefois, dans &latex;, la
+façon naturelle de faire ceci est d&#8217;utiliser <literal>\typeout</literal>
+(see <link linkend="_005ctypeout">\typeout</link>). La commande <literal>\write18</literal> est encore plus
+spéciale ; les systèmes &tex; modernes l&#8217;utilisent pour passer des
+commandes au système d&#8217;exploitation (see <link linkend="_005cwrite18">\write18</link>).
+</para>
+<indexterm role="cp"><primary>saut de ligne, dans <literal>\write</literal></primary></indexterm>
+<indexterm role="cp"><primary><literal>^^J</literal>, dans <literal>\write</literal></primary></indexterm>
+<para>D&#8217;ordinaire <literal>\write</literal> produit en sortie une unique ligne. On peut y
+insérer un saut de ligne avec <literal>^^J</literal>. Ainsi, l&#8217;exemple suivant
+produit deux lignes dans le fichier journal :
+</para>
+<screen>\wlog{Les lignes parallèles ont beaucoup en commun.^^JMais elles ne se
+rencontrent jamais.}
+</screen>
+<indexterm role="fn"><primary>paquetage <literal>answers</literal></primary></indexterm>
+<indexterm role="fn"><primary><literal>answers</literal>, paquetage</primary></indexterm>
+
+<para>Un cas usuel dans lequel des auteurs tentent d&#8217;écrire dans leur propre
+fichier est pour les réponses à des exerccies, ou dans quelque autre
+situation où vous désirer écrire en sortie verbatim, sans développer les
+macros. CTAN a plusieurs paquetages pour cela ; parmi lesquels
+<filename>answers</filename>.
+</para>
+
+<sect2 label="27.5.1" id="_005cwrite-and-security">
+<title><literal>\write</literal> et la sécurité</title>
+
+<indexterm role="cp"><primary>securité et <literal>\write</literal></primary></indexterm>
+<indexterm role="cp"><primary><literal>\write</literal> et sécurité</primary></indexterm>
+
+<para>La possibilité d&#8217;écrire dans des fichier soulève des problèmes de
+sécurtié. Si vous compilez un fichier &latex; téléchargé et qu&#8217;il
+écrase votre fichier de mots de passe alors vous serez à juste titre
+embêté.
+</para>
+<para>Ainsi par défaut les systèmes &tex; ne vous autorisent à ouvrir en
+écriture que les fichiers qui sont dans le répertoire courant ou dans un
+sousrépertoire. L&#8217;exemple suivant
+</para>
+<screen>\newwrite\fichierjh
+\openout\fichierjh=../test.jh
+</screen>
+<para>produit une erreur du genre de :
+</para><screen>Not writing to ../test.jh (openout_any = p).
+! I can't write on file `../test.jh'
+</screen>
+<indexterm role="cp"><primary>répertoires parents, impossible d&#8217;écrire vers</primary></indexterm>
+<para>Il est possible d&#8217;avoir une telle erreur lorsqu&#8217;on essaie d&#8217;utiliser une
+commande telle que <literal>\include{../nomfichier}</literal> puisque &latex; va
+essayer d&#8217;ouvrir <filename>../filename.aux</filename>. La solution la plus simple est
+de placer les fichiers inclus dans le même répertoire que le fichier
+racine, ou dans des sous-répertoires.
+</para>
+</sect2>
+<sect2 label="27.5.2" id="_005cmessage">
+<title><literal>\message</literal></title>
+
+<indexterm role="fn"><primary>\message</primary></indexterm>
+
+<para>Synopsis :
+</para>
+<screen>\message{<replaceable>chaîne</replaceable>}
+</screen>
+<para>Écrit <replaceable>chaîne</replaceable> vers le fichier journal en <filename>.log</filename> et le
+terminal.
+</para>
+<para>Typiquement, les auteurs &latex; utilisent <literal>\typeout</literal>
+(see <link linkend="_005ctypeout">\typeout</link>) qui permet d&#8217;utiliser <literal>\protect</literal> sur toute
+commande fragile au sein de <replaceable>chaîne</replaceable> (see <link linkend="_005cprotect">\protect</link>). Mais la
+commande <literal>\typeout</literal> insère un saut de ligne à la fin de
+<replaceable>chaîne</replaceable> contrairement à <literal>\message</literal>, aussi cette dernière peut
+être utile.
+</para>
+<para>Dans l&#8217;exemple ci-dessous dans le corps du document
+</para>
+<screen>avant\message{Un Deux}\message{Trois}\message{Quatre^^JLes}
+\message{pouces vont se battre.}Après
+</screen>
+<para>dans certaines circonstances (voir ci-dessous) &latex; écrit ce qui suit
+à la fois vers le terminal et le fichier journal.
+</para>
+<screen>Un Deux Trois Quatre
+Les pouces vont se battre.
+</screen>
+<para>Un <literal>^^J</literal> produit un saut de ligne. Aussi, dans le document
+en sortie, on a entre &#8216;<literal>avant</literal>&#8217; et &#8216;<literal>Après</literal>&#8217; un seul espace (issu
+de la fin de ligne suivant &#8216;<literal>Les}</literal>&#8217;).
+</para>
+<para>Alors que <literal>\message</literal> vous permet de mieux contrôler le formatage,
+un truc à piger c&#8217;est que &latex; peut très bien bousiller ce formatage
+là en insérant des sauts de ligne selon ce qu&#8217;il a déjà sorti. Comparez
+ce corps de document, où le &#8216;<literal>Deux</literal>&#8217; a été déplacé, à celui donné en
+exemple plus haut.
+</para>
+<screen>avant\message{Un}\message{Deux Trois}\message{Quatre^^JLes}
+\message{pouces vont se battre.}Après
+</screen>
+<para>La chose suivante peut se produire : lorsque &latex; produit les
+messages en sortie vers le terminal, le message avec &#8216;<literal>Un</literal>&#8217; désormais
+plus court tient à la fin de la ligne de terminal, et du coup &latex;
+saute de ligne juste après lui et avant le &#8216;<literal>Deux Trois</literal>&#8217;. Ce saut
+de ligne apparaît également dans le fichier journal. Cette insertion de
+saut de ligne peut déprendre de, par exemple, la longueur des noms
+complet des fichiers inclus. C&#8217;est pourquoi il est difficile de produire
+des lignes formatées précisément et d&#8217;une façon qui soit portable, et de
+même de demander que votre message commence au début d&#8217;une ligne.
+</para>
+
+</sect2>
+<sect2 label="27.5.3" id="_005cwlog">
+<title><literal>\wlog</literal></title>
+
+<indexterm role="fn"><primary>\wlog</primary></indexterm>
+
+<para>Synopsis :
+</para>
+<screen>\wlog{<replaceable>chaîne</replaceable>}
+</screen>
+<para>Écrit <replaceable>chaîne</replaceable> vers le fichier journal <filename>.log</filename>.
+</para>
+<screen>\wlog{Pour tout n différent de 0, et tout x, (sin x)/n vaut six.}
+\wlog{Ben oui, il suffit de simplifier par n.}
+</screen>
+<para>D&#8217;ordinaire <replaceable>chaîne</replaceable> apparaît sur une seule ligne séparée. Utilisez
+<literal>^^J</literal> pour insérer un saut de ligne.
+</para>
+<screen>\wlog{C'est Helvetica qui téléphone à Times Roman :}
+\wlog{Change de ligne !^^JJe t'entends très mal.}
+</screen>
+
+</sect2>
+<sect2 label="27.5.4" id="_005cwrite18">
+<title><literal>\write18</literal></title>
+<indexterm role="fn"><primary>\write18</primary></indexterm>
+<indexterm role="cp"><primary>externes, commandes</primary></indexterm>
+<indexterm role="cp"><primary>commandes exécutées depuis &latex;</primary></indexterm>
+<indexterm role="cp"><primary>système, commandes exécutées depuis &latex;</primary></indexterm>
+<indexterm role="cp"><primary>interpréteur de commandes du système d&#8217;exploitation, accès à</primary></indexterm>
+<!-- Derived from: Joseph Wright: https://tex.stackexchange.com/a/20446/121234 -->
+
+<para>Synopsis :
+</para>
+<screen>\write18{<replaceable>commande_shell</replaceable>}
+</screen>
+<para>Émet une commande vers l&#8217;interpréteur du système d&#8217;exploitation. Le
+système d&#8217;exploitation exécute la commande et l&#8217;exécution de &latex;
+est bloquée jusqu&#8217;à ce que cela soit fini.
+</para>
+<indexterm role="fn"><primary>paquetage <literal>Asymptote</literal></primary></indexterm>
+<indexterm role="fn"><primary><literal>Asymptote</literal>, paquetage</primary></indexterm>
+
+<para>La séquence suivante (sur Unix)
+</para>
+<screen>\usepackage{graphicx} % dans le préambule
+ ...
+\newcommand{\numerofig}{1}
+\immediate\write18{cd pix &amp;&amp; asy figure\numerofig}
+\includegraphics{pix\figure\numerofig.pdf}
+</screen>
+<para>exécute Asymptote (le programme <literal>asy</literal>) sur le fichier
+<filename>pix/figure1.asy</filename>, de sorte que le document peut par la suite lire
+le graphique en résultant (see <link linkend="_005cincludegraphics">\includegraphics</link>). Comme pour tout
+<literal>\write</literal>, ici &latex; développe les macros contenues dans
+<replaceable>commande_shell</replaceable> de sorte que <literal>\numerofig</literal> est remplacé par
+&#8216;<literal>1</literal>&#8217;.
+</para>
+<para>Un autre exemple est que vous pouvez exécuter automatiquement Bib&tex;
+au début de chaque exécution de &latex; (see <link linkend="Using-BibTeX">Using BibTeX</link>) en
+incluant <literal>\immediate\write18{bibtex8 \jobname}</literal> comme première
+ligne du fichier. Notez que <literal>\jobname</literal> se développe par défaut en
+le nom de base du fichier racine, ou bien l&#8217;argument de l&#8217;option
+<literal>--jobname</literal> si celle-ci est passée sur la ligne de commande.
+</para>
+<para>Il peut arriver que vous ayez besoin de plusieurs étapes pour obtenir
+l&#8217;information désirée. L&#8217;exemple suivant insère en entrée une liste de
+tous les fichiers PDF du répertoire courant (voir aussi
+<filename>texosquery</filename> plus bas) :
+</para>
+<screen>\immediate\write18{ls *.pdf &gt; tmp.dat}
+\input{tmp.dat}
+</screen>
+<para>Le comportement standard de tout <literal>\write</literal> est d&#8217;attendre jusqu&#8217;à la
+prochaine éjection de page avant de développer les macros ou d&#8217;écrire
+dans le flux (see <link linkend="_005cwrite">\write</link>). Mais il se peut que vous désiriez que
+cela soit immédiat. Pour cela, utilisez
+<literal>\immediate\write18{<replaceable>commande_shell</replaceable>}</literal>.
+</para>
+<para>Autoriser l&#8217;usage de commandes système au sein d&#8217;un fichier &latex;
+pose des problème de sécurité évidents. Si vous télécharger un fichier
+depuis la Toile et qu&#8217;il contient des commandes pour détruire tous vos
+fichier, cela vous rendrait bien malheureux. Le réglage standard dans
+les distributions modernes est d&#8217;interdire l&#8217;accès complet à
+l&#8217;interpréteur de commande du système d&#8217;exploitation. Vous pouvez
+l&#8217;autoriser, si vous êtes sûr qu&#8217;il n&#8217;y a pas de danger, en compilant
+avec <literal>latex --enable-write18 <replaceable>nomfichier</replaceable></literal> (see <link linkend="Command-line-options">Command line
+options</link>). (L&#8217;option <literal>--shell-escape</literal> est un synonyme dans &tex;
+Live.)
+</para>
+<indexterm role="cp"><primary>restreint, accès shell</primary></indexterm>
+<indexterm role="cp"><primary>restreint, accès interpréteur de commande du système d&#8217;exploitation</primary></indexterm>
+<para>Au lieu de l&#8217;accès complet, les distributions modernes par défaut
+utilisent une version restreinte qui permet à certaines commandes de
+fonctionner, telles que celles qui font tourner Metafont pour générer
+les polices manquantes, même si vous n&#8217;utilisez pas l&#8217;option
+<literal>enable-write18</literal>. Par défaut cette liste de commandes autorisées
+est courte et ne fait figurer que les commandes qui sont sous contrôle
+des mainteneurs de la distribution (see <link linkend="Command-line-options">Command line options</link>).
+</para>
+<para>Certains paquetage ont besoin d&#8217;exécuter des commandes système
+externes. Par exemple <filename>sagetex</filename> vous permet de faire faire des
+calcul ou tracer des graphiques au logiciel de mathématiques <emphasis>Sage</emphasis>,
+puis d&#8217;incorporer ces sorties dans votre document. Pour cela vous devez
+exécuter &latex; avec la fonction <literal>\write18</literal> pleinement débridée.
+</para>
+<indexterm role="fn"><primary>/bin/sh, utilisé par <literal>\write18</literal></primary></indexterm>
+<indexterm role="fn"><primary>sh, utilisé par <literal>\write18</literal></primary></indexterm>
+<indexterm role="fn"><primary>cmd.exe, utilisé par <literal>\write18</literal></primary></indexterm>
+<indexterm role="fn"><primary>SHELL, environnement, variables de</primary></indexterm>
+<indexterm role="fn"><primary>SHELL, variables d&#8217;environnement</primary></indexterm>
+<para>Le texte <replaceable>commande_shell</replaceable> est toujours passé à <filename>/bin/sh</filename> sur
+les systèmes d&#8217;exploitation unixiens, et à l&#8217;interpréteur de commande DOS
+<filename>cmd.exe</filename> sur Windows. &latex; ignore tout réglage d&#8217;un autre
+interpréteur de commande par l&#8217;utilisateur, ainsi que la variable
+d&#8217;environnement <literal>SHELL</literal>.
+</para>
+<indexterm role="fn"><primary>paquetage <literal>texosquery</literal></primary></indexterm>
+<indexterm role="fn"><primary><literal>texosquery</literal>, paquetage</primary></indexterm>
+
+<indexterm role="cp"><primary>système, information</primary></indexterm>
+<indexterm role="cp"><primary>exploitation, information système de</primary></indexterm>
+<indexterm role="cp"><primary>locale, information, du système</primary></indexterm>
+<indexterm role="cp"><primary>répertoire, listage, du système</primary></indexterm>
+<para>Si votre besoin c&#8217;est d&#8217;avoir de l&#8217;information sur le système, comme le
+nom du système d&#8217;exploitation, celui de la locale, ou le contenu d&#8217;un
+répertoire, alors jeter un coup d&#8217;œil au paquetage <filename>texosquery</filename> qui
+fournit une interface commode et sûre pour cela, contrairement aux
+exemples donnés plus haut utilisant <literal>\write18</literal> à l&#8217;état brut :
+<ulink url="https://ctan.org/pkg/texosquery">https://ctan.org/pkg/texosquery</ulink>.
+</para>
+</sect2>
+</sect1>
</chapter>
-<chapter label="26" id="Command-line">
+<chapter label="28" id="Command-line">
<title>Ligne de commande</title>
<indexterm role="cp"><primary>ligne de commande</primary></indexterm>
-<para>La spécification du fichier d&#8217;entrée indique le fichier à être formaté ;
-&tex; utilise <filename>.tex</filename> comme extension de fichier par défaut. Si
-vous omettez complètment le fichier d&#8217;entrée, &tex; accèpte en entrée
-les caractères saisis à partir de la console. Vous spécifiez les
-options de commande en fournissant une chaîne en paramètre de la
-commande ; par ex.
+<para>Synopsis (depuis la ligne de commande d&#8217;un terminal) :
+</para>
+<screen>pdflatex <replaceable>options</replaceable> <replaceable>argument</replaceable>
+</screen>
+<para>Exécute &latex; sur <replaceable>argument</replaceable>. À la place de <command>pdflatex</command>
+vous pouvez aussi utiliser <command>xelatex</command>, ou <command>lualatex</command>, ou
+<command>latex</command>.
+</para>
+<para>L&#8217;exemple suivant exécute &latex; sur le fichier <filename>these.tex</filename>
+produisant en sortie <filename>these.pdf</filename>.
+</para>
+<screen>pdflatex these
+</screen>
+<para><indexterm role="fn"><primary>.tex, extension par défaut</primary></indexterm>
+Notez que <filename>.tex</filename> est l&#8217;extension par défault des noms de fichier.
+</para>
+<para>pdf&tex; est une évolution du programme original &tex;, comme le sont
+Xe&tex; et Lua&tex; (see <link linkend="TeX-engines">&tex; engines</link>). Ils sont complètement
+rétrocompatibles. Mais le programme original avait son propre format de
+sortie, DVI, alors que les plus récents peuvent produire directement un
+PDF en sortie. Ceci leur permet de profiter des fonctions
+supplémentaires des PDF tels que les hyperliens, la prise en charge de
+formats modernes d&#8217;images tels que JPG et PNG, et les programmes de
+visionnage que l&#8217;on trouve de partout. En bref, si vous exécutez
+<command>pdflatex</command> ou <command>xelatex</command> ou <command>lualatex</command> alors par
+défaut vous obtenez un PDF et avez accès à toutes ses fonctions
+modernes. Si vous exécutez <command>latex</command>, ou <literal>dvilualatex</literal>,
+alors vous obtenez un DVI. La description faite ici suppose
+pdf&latex;.
+</para>
+<para>See <link linkend="Command-line-options">Command line options</link>, pour une sélection des options de ligne de
+commande les plus utiles. Quant à <replaceable>argument</replaceable>, le cas habituel est
+qu&#8217;il ne commence pas par une contr&#8217;oblique, dans ce cas le système le
+prend pour un nom de fichier, et compile ce fichier. Si <replaceable>argument</replaceable>
+commence avec une contr&#8217;oblique, alors le système l&#8217;interprète comme une
+ligne d&#8217;entrée à &latex;, ce qui peut être utilisé pour obtenir
+certains effets spéciaux (see <link linkend="Command-line-input">Command line input</link>).
+</para>
+<para>Si vous ne donnez aucun arguments ni options alors <command>pdflatex</command>
+invite à saisir à partir du terminal. Vous pouvez vous échapper de cela
+en entrant <userinput>CTRL-D</userinput>.
+</para>
+<para>Si &latex; trouve une erreur dans votre document alors par défaut il
+s&#8217;arrête et vous interroge à ce propos. See <link linkend="Recovering-from-errors">Recovering from errors</link>
+pour un aperçu de quoi faire.
+</para>
+
+
+<sect1 label="28.1" id="Command-line-options">
+<title>Options passées à la ligne de commande</title>
+
+<indexterm role="cp"><primary>options passée à la ligne de commande</primary></indexterm>
+
+<para>On décrit ici les options de ligne de commande qui sont pertinentes pour
+rédaction ordinaire de documents. Pour une liste complète, essayez
+d&#8217;exécuter &#8216;<literal>latex --help</literal>&#8217; depuis la ligne de commande.
+</para>
+<para>Les implementations permettent en général de spécifier les options de
+ligne de commande avec un prefixe &#8216;<literal>-</literal>&#8217; ou &#8216;<literal>--</literal>&#8217;. C&#8217;est le cas à
+la fois pour &tex; Live (et Mac&tex;) et MiK&tex;. Ici on utilise
+les deux conventions indistinctement.
+</para>
+<variablelist><indexterm role="fn"><primary>--version ligne de commande, option</primary></indexterm>
+<varlistentry><term><literal>-version</literal>
+</term><listitem><para>Affiche la version courante, comme &#8216;<literal>pdfTeX 3.14159265-2.6-1.40.16
+(TeX Live 2015/Debian)</literal>&#8217; ainsi qu&#8217;une petite quantité d&#8217;information
+supplémentaire, et se termine.
+</para>
+<indexterm role="fn"><primary>--help ligne de commande, option</primary></indexterm>
+</listitem></varlistentry><varlistentry><term><literal>-help</literal>
+</term><listitem><para>Produit un message bref d&#8217;utilisation servant d&#8217;aide-mémoire et se
+termine.
+</para>
+<anchor id="interaction-modes"/><indexterm role="fn"><primary>--interaction ligne de commande, option</primary></indexterm>
+</listitem></varlistentry><varlistentry><term><literal>-interaction=<replaceable>mode</replaceable></literal>
+</term><listitem><indexterm role="cp"><primary>batchmode</primary></indexterm>
+<indexterm role="cp"><primary>scrollmode</primary></indexterm>
+<indexterm role="cp"><primary>errorstopmode</primary></indexterm>
+<indexterm role="cp"><primary>nonstopmode</primary></indexterm>
+<para>z&tex; compile un document en l&#8217;un parmi quatre modes possibles
+d&#8217;interaction : <literal>batchmode</literal>, <literal>nonstopmode</literal>, <literal>scrollmode</literal>,
+<literal>errorstopmode</literal>. Dans le mode <firstterm>errorstopmode</firstterm> (le mode par
+défaut), &tex; s&#8217;arrête à chaque erreur et demande une intervention de
+l&#8217;utilisateur. Dans le mode <firstterm>batchmode</firstterm> il n&#8217;imprime rien sur le
+terminal, on défile sur les erreurs comme si l&#8217;utilisateur appuyait
+<userinput>RETURN</userinput> à chaque erreur, et les fichiers manquants entrainent la
+terminaison de la tâche. Dans le mode <firstterm>nonstopmode</firstterm>, les messages de
+diagnostic apparaissent sur le terminal mais comme dans le mode batch il
+n&#8217;y as pas d&#8217;interaction avec l&#8217;utilisateur. Dans le mode
+<firstterm>scrollmode</firstterm>, &tex; s&#8217;arrête en cas de fichiers manquants ou
+d&#8217;entrée clavier, mais pour nulle autre raison.
+</para>
+<para>Par exemple, en démarrant &latex; avec cette ligne de commande :
+</para>
+<screen>pdflatex -interaction=batchmode <replaceable>nomfichier</replaceable>
+</screen>
+<para>on élimine la plupart des sorties terminal.
+</para>
+<indexterm role="cp"><primary>jobname</primary></indexterm>
+<indexterm role="cp"><primary>nom de fichier de la tâche courante</primary></indexterm>
+<indexterm role="fn"><primary>--jobname ligne de commande, option</primary></indexterm>
+</listitem></varlistentry><varlistentry><term><literal>-jobname=<replaceable>chaîne</replaceable></literal>
+</term><listitem><para>Règle la valeur du <firstterm>nom de tâche</firstterm> de &tex; à la chaîne de
+caractères <replaceable>chaîne</replaceable>. Le fichier journal et le fichier de sortie
+s&#8217;appeleront <filename><replaceable>chaîne</replaceable>.log</filename> et <filename><replaceable>chaîne</replaceable>.pdf</filename>.
+</para>
+<para>Quand vous exécutez <literal><command>pdflatex</command> <replaceable>options</replaceable>
+<replaceable>argument</replaceable></literal>, si <replaceable>argument</replaceable> ne commence pas par une contr&#8217;oblique
+alors &tex; considère que c&#8217;est le nom d&#8217;un fichier à lire en
+entrée. Autrement il attend la première instruction <literal>\input</literal> et le
+nom du fichier en entrée devient le nom de tâche
+(<literal>\jobname</literal>). Celui-ci est utilisé pour nommer le fichier journal
+et le fichier de sortie. L&#8217;option <literal>jobname</literal> l&#8217;emporte et spécifie
+directement le nom. See <link linkend="Command-line-input">Command line input</link>, pour un examples
+d&#8217;usage.
+</para>
+<anchor id="output-directory"/><indexterm role="cp"><primary>répertoire de sortie pour tous les fichiers externes</primary></indexterm>
+<indexterm role="cp"><primary>sortie, pour tous les fichiers externes, répertoire de</primary></indexterm>
+<indexterm role="fn"><primary>--output-directory ligne de commande, option</primary></indexterm>
+</listitem></varlistentry><varlistentry><term><literal>-output-directory=<replaceable>répertoire</replaceable></literal>
+</term><listitem><para>Écrit les fichiers dans le répertoire <replaceable>répertoire</replaceable>. Il doit déjà
+exister. Ceci s&#8217;applique à tous les fichiers externes créés par &tex;
+ou &latex;, tels que le fichier <filename>.log</filename> de l&#8217;exécution, les
+fichiers <filename>.aux</filename>, <filename>.toc</filename>, etc., créés par &latex;, de même que
+le fichier de sortie principal <filename>.pdf</filename> ou <filename>.dvi</filename> lui-même.
+</para>
+<para>Lorsqu&#8217;il est spécifié, le répertoire de sortie <replaceable>répertoire</replaceable> est
+aussi vérifié en premier automatiquement pour tout fichier lu en entrée,
+de sorte que les fichiers externes peuvent être relus en entrée, si
+désiré. Le vrai répertoire courant (dans lequel &latex; été lancé)
+demeure inchangé, et est également vérifié pour trouver les fichiers en
+entrée.
+</para>
+<indexterm role="cp"><primary>shell escape</primary></indexterm>
+<indexterm role="cp"><primary><literal>\write18</literal>, activation</primary></indexterm>
+<indexterm role="fn"><primary>--enable-write18 ligne de commande, option</primary></indexterm>
+<indexterm role="fn"><primary>--disable-write18 ligne de commande, option</primary></indexterm>
+<indexterm role="fn"><primary>--shell-escape ligne de commande, option</primary></indexterm>
+<indexterm role="fn"><primary>--no-shell-escape ligne de commande, option</primary></indexterm>
+</listitem></varlistentry><varlistentry><term><literal>--enable-write18</literal>
+</term><term><literal>--disable-write18</literal>
+</term><term><literal>--shell-escape</literal>
+</term><term><literal>--no-shell-escape</literal>
+</term><listitem><para>Activation et desactivation <literal>\write18{<replaceable>commande_shell</replaceable>}</literal>
+(see <link linkend="_005cwrite18">\write18</link>). Les deux premières options sont prises en charge à
+la fois par &tex; Live et MiK&tex;, alors que les deux suivantes sont
+des synonymes pris en charge par &tex; Live.
+</para>
+<para>Activer cette fonction a des implications lourdes de sécurité, puisque
+cela permet à un fichier &latex; d&#8217;exécuter n&#8217;importe quelle commande.
+Ainsi, par défaut, le <literal>\write18</literal> non restreint n&#8217;est pas autorisé.
+(Le réglage par défaut de &tex; Live, Mac&tex;, et MiK&tex; est
+d&#8217;autoriser l&#8217;exécution d&#8217;un nombre limité de programmes en relation
+avec &tex;, et qu&#8217;elles distribuent).
+</para>
+<para>Pa exemple, si vous invoquez &latex; avec l&#8217;option
+<literal>no-shell-escape</literal>, et que dans votre document vous appelez
+<literal>\write18{ls -l}</literal>, alors vous n&#8217;obtenez pas d&#8217;erreur mais votre
+fichier journal dit &#8216;<literal>runsystem(ls -l)...disabled</literal>&#8217;.
+</para>
+<indexterm role="fn"><primary>--halt-on-error ligne de commande, option</primary></indexterm>
+</listitem></varlistentry><varlistentry><term><literal>-halt-on-error</literal>
+</term><listitem><para>Arrête le traitement sur la première erreur.
+</para>
+<indexterm role="fn"><primary>--file-line-error ligne de commande, option</primary></indexterm>
+<indexterm role="fn"><primary>--no-file-line-error ligne de commande, option</primary></indexterm>
+</listitem></varlistentry><varlistentry><term><literal>-file-line-error</literal>
+</term></varlistentry><varlistentry><term><literal>-no-file-line-error</literal>
+</term><listitem><para>Active ou désactive le style
+<literal><replaceable>nomfichier</replaceable>:<replaceable>numéroligne</replaceable>:<replaceable>erreur</replaceable></literal> des messages
+d&#8217;erreur. Ces options ne sont disponibles qu&#8217;avec &tex; Live ou
+Mac&tex;.
+</para></listitem></varlistentry></variablelist>
+
+</sect1>
+<sect1 label="28.2" id="Command-line-input">
+<title>Spécifier du code LaTeX sur la ligne de commande</title>
+
+<indexterm role="cp"><primary>code entré sur la ligne de commande</primary></indexterm>
+<indexterm role="cp"><primary>entré, code sur la ligne de commande</primary></indexterm>
+
+<para>Au sein de l&#8217;invocation de ligne de commande <literal>pdflatex
+<replaceable>options</replaceable> <replaceable>argument</replaceable></literal> vous pouvez spécifier du code &latex;
+arbitraire en entrée en commençant <replaceable>argument</replaceable> par une
+contr&#8217;oblique. Ceci permet de faire certains effet spéciaux.
+</para>
+<indexterm role="fn"><primary>paquetage <literal>hyperref</literal></primary></indexterm>
+<indexterm role="fn"><primary><literal>hyperref</literal>, paquetage</primary></indexterm>
+
+<!-- -->
+<para>Par exemple, ce fichier (qui utilise le paquetage <filename>hyperref</filename> pour
+les hyperliens) peut produire deux types de sortie, l&#8217;un pour
+l&#8217;impression papier et l&#8217;autre pour une consultation PDF.
+</para>
+<screen>\ifdefined\paperversion % dans le préambule
+\newcommand{\urlcolor}{black}
+\else
+\newcommand{\urlcolor}{blue}
+\fi
+\usepackage[colorlinks=true,urlcolor=\urlcolor]{hyperref}
+ ...
+\href{https://www.ctan.org}{CTAN} % dans le corps
+ ...
+</screen>
+<para>Lorsqu&#8217;on compile ce document <filename>book.tex</filename> avec la ligne de commande
+<literal>pdflatex book</literal> le lien &#8216;<literal>CTAN</literal>&#8217; sera en bleu. Mais si on le
+compile avec <literal>pdflatex &quot;\def\paperversion{}\input book.tex&quot;</literal>,
+alors le lien sera en noir. (Notez l&#8217;utilise des guillemets anglais
+pour empécher l&#8217;interpretation des symboles par l&#8217;interpréteur de ligne
+de commande ; votre système fait peut-être cela différemment).
+</para>
+<para>De même, à partir d&#8217;un seul fichier <filename>principal.tex</filename> vous pouvez
+compiler deux versions distinctes.
</para>
-<screen>latex '\nonstopmode\input foo.tex'
+<!-- credit Paul Gaborit: https://tex.stackexchange.com/a/220101/121234 -->
+<screen>pdflatex -jobname=etudiants &quot;\def\etudiants{}\input{principal}&quot;
+pdflatex -jobname=professeurs &quot;\def\profs{}\input{principal}&quot;
</screen>
-<para>Traitera <filename>foo.tex</filename> sans faire de pause après chaque erreur.
+<para>L&#8217;option <literal>jobname</literal> est là parce que sinon les deux fichiers en
+sortie s&#8217;appeleraient <filename>principal.pdf</filename> et le second écraseraient le
+premier.
+</para>
+<para>Dans ce dernier exemple on charge le paquetage <filename>graphicx</filename> avec l&#8217;option
+<literal>draft</literal>
+</para>
+<!-- credit Herbert Voss: https://tex.stackexchange.com/a/17236/121234 -->
+<screen>pdflatex -jobname=aa &quot;\RequirePackage[draft]{graphicx}\input{aa.tex}&quot;
+</screen>
+<para>de sorte que les fichiers graphiques ne sont lus que pour l&#8217;information
+de dimension de boîte englobante, mais non incorporés dans le PDF.
+(L&#8217;option <literal>jobname</literal> est la parce que sinon autrement le fichier de
+sortie s&#8217;appelerait <filename>graphicx.pdf</filename>, comme <literal>\RequirePackage</literal>
+fait lui-même un <literal>\input</literal>).
+</para>
+
+</sect1>
+<sect1 label="28.3" id="Recovering-from-errors">
+<title>Quand quelque chose se passe mal</title>
+
+<para>Si &latex; trouve une erreur dans votre document alors il vous produit
+un message d&#8217;erreur et vous invite à la saisie par un point
+d&#8217;interrogation, <literal>?</literal>. Par exemple, exécuter &latex; sur ce fichier
+</para>
+<screen>\newcommand{\NP}{\ensuremath{\textbf{NP}}}
+Le problème \PN{} est mis à prix à un million de dollars.
+</screen>
+<para>a pour effet qu&#8217;il affiche ceci, et attende une saisie :
+</para>
+<screen>! Undefined control sequence.
+l.5 Le problème \PN
+ {} est mis à prix à un million de dollars.
+?
+</screen>
+<para>Le plus simple est de saisir <userinput>x</userinput> et <userinput>RETURN</userinput> et de corriger la
+coquille. Alternativement vous pourriez saisir <userinput>?</userinput> et <userinput>RETURN</userinput>
+pour voir les autres options.
</para>
-<indexterm role="cp"><primary>invite &#8216;<literal>*</literal>&#8217;</primary></indexterm>
<indexterm role="cp"><primary>&#8216;<literal>*</literal>&#8217;, invite</primary></indexterm>
+<indexterm role="cp"><primary>invite &#8216;<literal>*</literal>&#8217;</primary></indexterm>
<indexterm role="fn"><primary>\stop</primary></indexterm>
-<para>Si &latex; s&#8217;arrête au milieu du document et vous fait une invite en
-&#8216;<literal>*</literal>&#8217;, c&#8217;est qu&#8217;il attend que vous saisissiez quelque chose. Vous
-pouvez taper <literal>\stop</literal> (et retour-chariot) et il terminera
-prématurément le document.
+<para>Il y a deux autres scénarios. Le premier est que vous ayez omis le
+<literal>\end{document}</literal> ou fait une faute de frappe dessus. Dans ce cas
+&latex; produit en invite &#8216;<literal>*</literal>&#8217;. Vous pouvez revenir à la ligne de
+commande en tapant <userinput>\stop</userinput> et <userinput>RETURN</userinput>.
</para>
-<para>Voir <link linkend="TeX-engines">&tex; engines</link>, pour les autres commandes système invoquant &latex;.
+<para>Le dernier scénario est que vous ayez fait une faute de frappe sur le
+nom de fichier. Par exemple, au lieu de <literal>pdflatex test</literal> vous
+auriez tapé <literal>pdflatex tste</literal>.
+</para>
+<screen>! I can't find file `tste'.
+&lt;*&gt; tste
+
+(Press Enter to retry, or Control-D to exit)
+Please type another input file name:
+</screen>
+<para>Le plus simple est de saisir <userinput>CTRL D</userinput> (en appuyant sur les touches
+Control et d simultannément), et d&#8217;ensuite retaper la ligne de commande
+correcte.
</para>
+
+</sect1>
</chapter>
<appendix label="A" id="Document-templates">
<title>Patrons de documents</title>
<indexterm role="cp"><primary>patron de document</primary></indexterm>
<indexterm role="cp"><primary>modèle de document</primary></indexterm>
-<para>Bien que ce ne soit pas un matériel de référence, peut-être que ces
-patrons de document vous seront utiles. Davantage de resources de
-patrons sont listé à <ulink url="http://tug.org/interest.html#latextemplates">http://tug.org/interest.html#latextemplates</ulink>.
+<para>Bien qu&#8217;ils soient illustratifs, ces patrons de document vous seront
+put-être utiles. Davantage de ressources de patrons sont listées à
+<ulink url="https://tug.org/interest.html#latextemplates">https://tug.org/interest.html#latextemplates</ulink>.
</para>
@@ -10021,6 +14445,9 @@ patrons sont listé à <ulink url="http://tug.org/interest.html#latextemplates">
<indexterm role="cp"><primary><literal>beamer</literal> patron et classe</primary></indexterm>
<indexterm role="cp"><primary>patron, <literal>beamer</literal></primary></indexterm>
+<indexterm role="fn"><primary>paquetage <literal>beamer</literal></primary></indexterm>
+<indexterm role="fn"><primary><literal>beamer</literal>, paquetage</primary></indexterm>
+
<para>La classe <literal>beamer</literal> crée des présentations en diapositives. Elle a
de très nombreuses possibilités, mais voici un patron de base :
@@ -10030,7 +14457,7 @@ de très nombreuses possibilités, mais voici un patron de base :
\title{Patron pour la classe Beamer}
\author{Alex L'Auteur}
-\date{31 juillet 2007}
+\date{31 juillet 2020}
\begin{document}
@@ -10048,17 +14475,44 @@ de très nombreuses possibilités, mais voici un patron de base :
\end{document}
</screen>
-<para>Une ressource web pour cela :
-<ulink url="http://robjhyndman.com/hyndsight/beamer/">http://robjhyndman.com/hyndsight/beamer/</ulink>.
+<para>Le paquetage Beamer sur le CTAN :
+<ulink url="https://ctan.org/pkg/beamer">https://ctan.org/pkg/beamer</ulink>.
+</para>
+</sect1>
+<sect1 label="A.2" id="article-template">
+<title>Patron <literal>article</literal></title>
+
+<indexterm role="cp"><primary>patron (simple), <literal>article</literal></primary></indexterm>
+
+<para>Un patron simple pour un article.
</para>
+<screen>\documentclass{article}
+\title{Patron de la classe article}
+\author{Alex Author}
+
+\begin{document}
+\maketitle
+
+\section{Première section}
+Du texte.
+\subsection{Première section, première sous-section}
+Encore du texte.
+
+\section{Deuxième section}
+Et du texte.
+
+\end{document}
+</screen>
</sect1>
-<sect1 label="A.2" id="book-template">
+<sect1 label="A.3" id="book-template">
<title>Un patron <literal>book</literal></title>
<indexterm role="cp"><primary>patron, <literal>book</literal></primary></indexterm>
-
+<para>Voici un patron simple pour un livre. See <link linkend="Larger-book-template">Larger book template</link> pour
+un patron plus élaboré.
+</para>
<screen>\documentclass{book}
\title{Le Patron de la classe book}
\author{Alex L'Auteur}
@@ -10074,100 +14528,72 @@ Et du texte.
\section{Un sujet secondaire}
La fin.
+
\end{document}
</screen>
</sect1>
-<sect1 label="A.3" id="tugboat-template">
-<title>Un patron <literal>tugboat</literal></title>
+<sect1 label="A.4" id="Larger-book-template">
+<title>Un patron <literal>book</literal> plus élaboré</title>
-<indexterm role="cp"><primary>patron, TUGboat</primary></indexterm>
-<indexterm role="cp"><primary>classe <literal>ltugboat</literal></primary></indexterm>
+<indexterm role="cp"><primary>patron <literal>book</literal></primary></indexterm>
-<para><citetitle>TUGboat</citetitle> est la revue du groupe des utilisateur de &tex; (&tex;
-Users Group), <ulink url="http://tug.org/TUGboat">http://tug.org/TUGboat</ulink>.
+<para>Voici un patron quelque peu élaboré pour un livre. See <link linkend="book-template">book template</link>
+pour un patron plus simple.
</para>
-<screen>\documentclass{ltugboat}
-\usepackage{graphicx}
-\usepackage{ifpdf}
-\ifpdf
-\usepackage[breaklinks,hidelinks]{hyperref}
-\else
-\usepackage{url}
-\fi
-
-\title{Exemple d'article \TUB}
+<para>Ce patron utilise un <literal>\frontmatter</literal>, <literal>\mainmatter</literal>, et
+<literal>\backmatter</literal> pour contrôler la typographie des trois zones
+principales d&#8217;un livre (see <link linkend="_005cfrontmatter-_0026-_005cmainmatter-_0026-_005cbackmatter">\frontmatter &amp; \mainmatter &amp;
+\backmatter</link>). Le livre a une bibliographie et un index.
+</para>
+<para>Il est également à noter qu&#8217;il utilise <literal>\include</literal> et
+<literal>\includeonly</literal> (see <link linkend="Splitting-the-input">Splitting the input</link>). Lorsque vous
+travaillez sur un chapitre vous pouvez ne pas compiler tous les autres
+chapitres en mettant en commentaire les entrées correspondantes dans les
+arguments de <literal>\includeonly</literal>. Ceci accélère la compilation sans
+perdre aucune information telle que les renvois. (Le matériel qu&#8217;il
+n&#8217;est pas nécessaire de mettre sur une nouvelle page est inclus avec
+<literal>\input</literal> au lieu de <literal>\include</literal> ; mais ceci au dépens du
+bénéfice de maintenir les valeurs de renvois).
+</para>
+<screen>\documentclass[titlepage]{book}
+\usepackage{makeidx}\makeindex
-% répétez l'information pour chaque auteur.
-\author{Prénom Nom}
-\address{Voie\\ Ville, Code postal \\ Pays}
-\netaddress{user (at) exemple dot org}
-\personalURL{http://exemple.org/~user/}
+\title{Book Class Template}
+\author{Alex Author}
- %%% Fin des métadonnées %%%
+\includeonly{%
+ frontcover,
+ preface,
+ chap1,
+ ...
+ }
\begin{document}
+\frontmatter
+\include{frontcover}
+ % maybe comment out while drafting:
+\maketitle \input{dedication} \input{copyright}
+\tableofcontents
+\include{preface}
-\maketitle
-
-\begin{abstract}
-Ceci est un exemple d'article pour le \TUB{}.
-Prière d'écrire un abrégé.
-\end{abstract}
-
-\section{Introduction}
-
-Ceci est un exemple d'article pour le \TUB, à partir du lien
-\url{http://tug.org/TUGboat/location.html}.
-
-Nous recommandons le paquetage graphicx pour les inclusionj d'iimage, et
-le paquetage hyperref pour des adresses réticulaires (url) actives (dans
-la sortie \acro{PDF}). De nos jour le \TUB\ est produit en utilisant
-exclusivement des fichiers \acro{PDF}.
-
-La classe \texttt{ltugboat} fournit ces abréviations (et bien d'autres) :
-
-% verbatim blocks are often better in \small
-\begin{verbatim}[\small]
-\AllTeX \AMS \AmS \AmSLaTeX \AmSTeX \aw \AW
-\BibTeX \CTAN \DTD \HTML
-\ISBN \ISSN \LaTeXe
-\mf \MFB
-\plain \POBox \PS
-\TUB \TUG \tug
-\UNIX \XeT \WEB \WEAVE
-
-\, \bull \Dash \dash \hyph
-
-\acro{FRED} -&gt; {\small[er] fred} % prière d'utiliser !
-\cs{fred} -&gt; \fred
-\meta{fred} -&gt; &lt;fred&gt;
-\nth{n} -&gt; 1st, 2nd, ...
-\sfrac{3/4} -&gt; 3/4
-\booktitle{Book of Fred}
-\end{verbatim}
-
-Pour faire référence à d'autre numéros du \TUB\, veuillez utiliser le
-format \textsl{volno:issno}, par ex., ``\TUB\ 32:1'' pour notre numéro
-\nth{100}.
-
-Ce fichier n'est qu'un patron. La documentation du style \TUB\ est dans
-le document \texttt{ltubguid} se trouvant à
-\url{http://ctan.org/pkg/tugboat}. (Pour les références au \CTAN\ nous
-recommandons cette forme d'URL utilisant \texttt{/pkg/} quand cela fait
-sens ; ou, si vous avez besoin de faire référence spécifiquement à une
-localisation : \texttt{http://mirror.ctan.org/\textsl{chemin}}.)
-
-Écrivez par mél à \verb|tugboat@tug.org| en cas de problèmes ou
-questions.
-
-\bibliographystyle{plain} % nous recommandons le style de bibliographie plain
-\nocite{book-minimal} % pour forcer la bibliographie à ne pas être vide
-\bibliography{xampl} % xampl.bib est compris dans BibTeX
+\mainmatter
+\include{chap1}
+...
+\appendix
+\include{appena}
+...
-\makesignature
+\backmatter
+\bibliographystyle{apalike}
+\addcontentsline{toc}{chapter}{Bibliography}
+\bibliography
+\addcontentsline{toc}{chapter}{Index}
+\printindex
+\include{backcover}
\end{document}
-</screen></sect1>
+</screen>
+</sect1>
</appendix>
<!-- node-name, next, previous, up -->
<appendix label="B" id="License-translation">