summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/latex2e-help-texinfo-fr/latex2e-fr.texi
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/latex/latex2e-help-texinfo-fr/latex2e-fr.texi')
-rw-r--r--Master/texmf-dist/doc/latex/latex2e-help-texinfo-fr/latex2e-fr.texi6971
1 files changed, 5890 insertions, 1081 deletions
diff --git a/Master/texmf-dist/doc/latex/latex2e-help-texinfo-fr/latex2e-fr.texi b/Master/texmf-dist/doc/latex/latex2e-help-texinfo-fr/latex2e-fr.texi
index db72f4250cb..4920fd29e7b 100644
--- a/Master/texmf-dist/doc/latex/latex2e-help-texinfo-fr/latex2e-fr.texi
+++ b/Master/texmf-dist/doc/latex/latex2e-help-texinfo-fr/latex2e-fr.texi
@@ -4,18 +4,25 @@
@setfilename latex2e-fr.info
@documentlanguage fr
@documentencoding UTF-8
-@set UPDATED Août 2017
+@set UPDATED Septembre 2020
@include common.texi
-@settitle manuel de référence officieux de @LaTeX{}2e (@value{UPDATED})
+@settitle Manuel de référence officieux de @LaTeX{}2e (@value{UPDATED})
@comment % ** fin de tête (c'est pour courir Texinfo sur une région.)
@c latex 2.09 commandes devraient tous être présents maintenant,
+@c xx À faire:
+@c - --shell-escape & --file-line-no pris en charge par MiKTeX
+@c - exemple pdflatex --interaction=nonstopmode --file-line-error '\documentclass{minimal}\begin{document}\errmessage{Foirage}Salut\end{document}'
+@c => le jobname est minimal, créer un nœud sur jobname
+@c => style de message d'erreur traditionnel, car on n'est pas dans un fichier
+@c => ajouter un nœud sur \errmessage
+@c
+@c - ajouter @node Colon character & \colon
+@c
@c xx mais LaTeX2e substance est manquant.
@c xx une liste aléatoire de quelques items manquant est à la fin de ce fichier
+@c xx Lire le fichier NEWS pour les choses à mettre à jour.
@c
-@c xx misc commands from clsguide.pdf: MakeUpperCase, \ignorespacesafterend,
-@c \normalsfcodes
-@c xx color (include info from clsguide.pdf)
@c xx ending a run with errors
@c xx ctan, distributions, composant de TeX
@c xx mention \nocorr, \textit et ic
@@ -27,10 +34,21 @@
@c xx fusionner style mathématique hors texte
@c xx mode veritical, mode horizontal
@c
+@c
+@c
+@c xx Notes de P. Bideault
+@c
+@c xx Le sommaire précède immédiatement la table des matières. C'est curieux,
+@c xx C'est curieux, et perturbant.
+@c xx Cette table des matières ne serait-elle mieux située en fin de document ?
+@c
+@c
+@c
@c xx Le source2e typographie a un index avec tous noyau
@c commandes xx, même si certains sont internes et ne devraient pas être inclus.
@c xx classes.dtx et al. définir des commandes supplémentaires.
@c xx Voir aussi http://ctan.org/pkg/macros2e.
+@c xx Tous les caractères spéciaux devraient une fois pour toute être dérits
@c
@c packages xx - requis, plus, utile; Oberdiek; polices
@@ -42,30 +60,30 @@
@c
@c Autres ressources:
@c https://www.latex-project.org/help/books/lc2fr-apb.pdf
+@c http://mirror.ctan.org/info/impatient/fr/fbook.pdf
@copying
Ce document est un manuel de référence officieux pour @LaTeX{}, un
système de préparation de documents, version « @value{UPDATED} ».
Ce manuel a été traduit du fichier @file{LATEX.HLP} v1.0a de la
-bibliothèque d'aide VMS. La version pré-traduction a été rédigé par
-George D. Greenwade de Sam Houston State University. La version
+bibliothèque d'aide VMS. La version pré-traduction a été rédigée par
+George D. Greenwade de l'université d'É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'autres mises à jour et ajouts, et reconnaît avec gratitude avoir
utilisé @cite{Hypertext Help with @LaTeX{}}, de Sheldon Green, et
@cite{@LaTeX{} Command Summary} (pour @LaTeX{}2.09) de L. Botway et
C. Biemesderfer (publié par le @TeX{} Users Group en tant que
-@cite{@TeX{}niques} numéro 10), il l'a utilisé en tant que matériel de
-référence (aucun texte n'était directement copié).
+@cite{@TeX{}niques} numéro 10) ; il a utilisé ces documents en tant que matériel de
+référence et n'en a copié aucun texte directement.
-Tous droits réservés @copyright{} 2015-2017 Vincent Belaïche --- traduction.@*
-Tous droits réservés @copyright{} 2007, 2008, 2009, 2010, 2011, 2012, 2013,
-2014, 2015, 2016, 2017 Karl Berry. @*
+Tous droits réservés @copyright{} 2015-2020 Vincent Belaïche --- traduction.@*
+Tous droits réservés @copyright{} 2007-2020 Karl Berry. @*
Tous droits réservés @copyright{} 1988, 1994, 2007 Stephen Gilmore. @*
Tous droits réservés @copyright{} 1994, 1995, 1996 Torsten Martinsen.
-Ci-après se trouve la licence sous laquelle est distribuée ce manuel,
+Ci-après se trouve la licence sous laquelle est distribuée ce manuel ;
une traduction en est donnée en annexe, voir @ref{License translation}.
@comment start of License
@@ -119,9 +137,6 @@ into another language, under the above conditions for modified versions.
@macro BESU {utf8,math}
@math{@code{@backslashchar{}\math\}}
@end macro
-@macro iftexthenelse {then,else}
-\then\@c
-@end macro
@end iftex
@ifnottex
@macro BES {utf8,math}
@@ -130,27 +145,22 @@ into another language, under the above conditions for modified versions.
@macro BESU {utf8,math}
\utf8\
@end macro
-@macro iftexthenelse {then,else}
-\else\@c
-@end macro
@end ifnottex
@macro EnvIndex {env}
@findex @r{environnement} @code{\env\}
@findex @code{\env\}, @r{environnement}
+
@end macro
@macro PkgIndex {pkg}
@findex @r{paquetage} @code{\pkg\}
@findex @code{\pkg\}, @r{paquetage}
+
@end macro
-@set NotInPlainTeX Ceci n'est pas disponible en @TeX{} de base.
+@set PlainTeX @TeX{} de base
+@set NotInPlainTeX Ceci n'est pas disponible en @value{PlainTeX}.
@set NeedsAMSSymb @value{NotInPlainTeX} En @LaTeX{} vous devez charger le paquetage @file{amssymb}.
@set NeedsSTIX @value{NotInPlainTeX} En @LaTeX{} vous devez charger le paquetage @file{stix}.
-@clear HAS-MATH
-@iftex
-@set HAS-MATH
-@end iftex
-
@node Top
@top @LaTeX{}2e : un manuel de référence officieux
@@ -161,10 +171,10 @@ système de préparation de document, dans sa version « @value{UPDATED} ».
* À propos de ce document: About this document. reporter les bogues, etc.
* Aperçu: Overview. Qu'est-ce que @LaTeX{}?.
* Classe de documents: Document classes. Certaines des différentes classes disponibles.
-* Polices: Fonts. italique, gras, machine à écrire, etc
+* Polices: Fonts. italique, gras, tapuscrit, etc
* Mise en page: Layout. Contrôle de la mise en page.
* Rubricage: Sectioning. Comment bien faire des rubriques.
-* Les références croisées: Cross references. Référencement automatique.
+* Les renvois: Cross references. Renvoi automatique.
* Environnements: Environments. tels que @code{enumerate} et @code{itemize}.
* Sauts de ligne: Line breaking. Influencer les sauts de ligne.
* Sauts de page: Page breaking. Influencer les sauts de page.
@@ -178,14 +188,16 @@ système de préparation de document, dans sa version « @value{UPDATED} ».
* Les styles de page: Page styles. Différents styles de mise en page.
* Les espaces: Spaces. Espace horizontal et vertical.
* Boîtes: Boxes. Faire des boîtes.
+* Couleur: Color. Définir et utiliser des couleurs.
+* Graphiques: Graphics. Importer des graphiques de l'extérieur de @LaTeX{}.
* Insertions spéciales: Special insertions. Insertion de caractères réservés et spéciaux.
* Diviser l'entrée: Splitting the input. Traiter de gros fichiers en les partitionnant.
-* Prologue et épilogue: Front/back matter. Tables des matières, glossaires, index.
+* Parties pré/post-liminaires: Front/back matter. Table des matières, glossaires, index.
* Lettres: Letters. La classe @code{letter}.
* Entrée / sortie du terminal: Terminal input/output. Interaction avec l'utilisateur.
* La ligne de commande: Command line. Comportement indépendant du système de la ligne de commande.
* Patrons de document: Document templates. Patron pour commencer diverses classes de documents.
-* Traduction de la license: License translation. Une traduction à titre informatif de la licence.
+* Traduction de la licence: License translation. Une traduction à titre informatif de la licence.
* Index des Concepts: Concept Index. Index général.
* Index des commandes: Command Index. Liste alphabétique des commandes @LaTeX{}.
@end menu
@@ -196,12 +208,12 @@ système de préparation de document, dans sa version « @value{UPDATED} ».
@findex @url{@value{LTXREFMAN_HOME_PAGE}} @r{page d'accueil}
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'un
+préparation de document. Ce système est mis en œuvre sous forme d'un
paquet de macros pour le programme de composition @TeX{}
(@pxref{Overview}). La page d'accueil de ce document est
@url{@value{LTXREFMAN_HOME_PAGE}}. 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'autres
+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'autres
infrastructures.
@cindex @LaTeX{} ou @LaTeX{}2e, que choisir ?
@@ -222,11 +234,14 @@ par les mainteneurs de @LaTeX{}.
@cindex bogues, rapports
@cindex anomalies, rapports
Ne leur envoyez donc pas de rapports d'anomalie ou quoi que ce soit
-d'autre. Au lieu de cela, s'il vous plaît envoyez tous commentaires à
+d'autre.
+
+En revanche, n'hésitez pas à adresser vos commentaires à
@email{@value{LTXREFMAN_BUGS}}.
-Ce document est un manuel de référence. Il y a une vaste gamme d'autres sources d'information sur
-@LaTeX{}, de tous niveaux. Voici quelques introductions :
+Ce document est un manuel de référence. Il y a d'autres sources d'information sur
+@LaTeX{} : elles sont très nombreuses, et s'adressent à des utilisateurs de tous niveaux.
+Voici quelques introductions :
@c voir http://mirror.ctan.org/help/ctan/CTAN-upload-addendum.html#urls
@table @url
@@ -266,28 +281,34 @@ Qu'est-ce que @LaTeX{}?
@cindex Knuth, Donald E.
@cindex Lamport, Leslie
@cindex @LaTeX{} aperçu
-@LaTeX{} est un système de composition de document. Il fut à l'origine
-créé par Leslie Lamport et est desormais maintenu par un groupe de
+@LaTeX{} est un système de composition de documents. Il fut à l'origine
+créé par Leslie Lamport ; il est désormais maintenu par un groupe de
volontaires (@url{http://latex-project.org}). Il est largement utilisé,
en particulier pour les documents complexes et techniques, tels que ceux
impliquant des mathématiques.
+@c - Au début, ajout de « à l'aide d'un simple éditeur de texte ».
+@c - Emploi d'italiques pour les notions principales.
+@c - À la fin, ajout de « qui contient son texte mis en page ».
@cindex paquet de macro, @LaTeX{} en tant que
-Un utilisateur @LaTeX{} écrit un fichier d'entrée contenant le texte
-d'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
+À l'aide d'un simple éditeur de texte,
+un utilisateur @LaTeX{} écrit un fichier, dit @emph{fichier d'entrée},
+qui contient son texte ; des @emph{commandes} 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'interfaçant avec le programme de
composition @TeX{} de Donald E. Knuth (le terme technique est que
@LaTeX{} est un @dfn{paquet de macros} pour le moteur @TeX{}).
-L'utilisateur produit le document de sortie en donnant ce fichier
-d'entrée au moteur @TeX{}.
+En donnant le fichier d'entrée au moteur @TeX{},
+l'utilisateur produit le @emph{document de sortie}
+qui contient son texte mis en page.
@c - Les fichiers @LaTeX{} sont des fichiers texte ordinaires qui
@c - peuvent être écrits avec n'importe quel éditeur de texte aux
@c - performances raisonnables.
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'est-à-dire pour
signifier l'ensemble des commandes à la disposition d'un utilisateur de
@LaTeX{}.
@@ -296,7 +317,7 @@ signifier l'ensemble des commandes à la disposition d'un utilisateur de
Le nom @LaTeX{} est l'abréviation de ``Lamport @TeX{}''. On le prononce
LA-TÈQUE. Au sein du document, on produit le logo avec @code{\LaTeX}.
Là où l'utilisation du logo n'est pas raisonnable, comme dans du texte
-brut, écrivez le @samp{LaTeX}.
+brut, écrivez-le @samp{LaTeX}.
@menu
@@ -304,6 +325,8 @@ brut, écrivez le @samp{LaTeX}.
* Fichiers de sortie: Output files. Fichiers produits.
* Moteurs @TeX{}: @TeX{} engines. Programmes qui peuvent compiler du code source @TeX{} et @LaTeX{}.
* Syntaxe des commandes @LaTeX{}: @LaTeX{} command syntax. Syntaxe générale des commandes @LaTeX{}.
+* Environnement: Environment. Zone du code source avec un comportement distinct.
+* CTAN:: Notre dépôt.
@end menu
@node Starting and ending
@@ -315,7 +338,8 @@ brut, écrivez le @samp{LaTeX}.
@cindex Bonjour le monde
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'agit d'obtenir un document
+contenant la phrase « Bonjour le monde ».
@example
\documentclass@{article@}
@@ -326,8 +350,8 @@ Bonjour le monde \LaTeX.
@cindex classe de document, définition
@noindent
-Ici @samp{article} et ce qu'on appelle la @dfn{classe de document},
-implémentée dans une fichier @file{article.cls}. N'importe quelle classe
+Ici @samp{article} est ce que l'on appelle la @dfn{classe de document} ;
+elle est implémentée dans une fichier @file{article.cls}. N'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'autres sont
largement disponibles. @xref{Document classes}.
@@ -345,8 +369,9 @@ aucun autre) est obligatoire dans tous les documents @LaTeX{}
d'environnements, et bien plus encore sont définis séparément.
@xref{Environments}.
-Les rubriques suivantes discutent de la façon de produire des PDF et
-d'autres format de sortie à partir d'un fichier d'entrée @LaTeX{}.
+Les rubriques suivantes sont consacrées aux façons de produire,
+à partir d'un fichier d'entrée @LaTeX{}, des documents PDF ou
+d'autres formats.
@node Output files
@@ -364,25 +389,25 @@ soit en @file{.dvi} soit en @file{.pdf}.
@findex @r{commande} dvips
@findex @r{commande} dvipdfmx
@findex @r{commande} dvitype
-Si il est invoqué avec la commande système @command{latex}, alors il
+S'il est invoqué avec la commande système @command{latex}, alors il
produit un fichier « DeVice Independent@footnote{Indépendant du
périphérique de sortie, ce n'est toutefois pas un format portable de
document} » (@file{.dvi}). Vous pouvez visualiser ce fichier avec une
commande comme @command{xdvi}, ou le convertir en fichier PostScript
@code{.ps} avec @command{dvips} ou en fichier « Portable Document
Format@footnote{Format portable de document} » @code{.pdf} avec
-@command{dvipdfmx}. Un grand nombre d'autres progammes utilitaires DVI
-sont disponibles (@url{http://mirror.ctan.org/dviware}).
+@command{dvipdfmx}. Un grand nombre d'autres progammes utilitaires
+pour fichiers DVI sont disponibles (@url{http://mirror.ctan.org/dviware}).
@item .pdf
@findex .pdf @r{fichier}
@cindex pdf@TeX{}
@findex @r{commande} pdflatex
Si @LaTeX{} est invoqué avec la commande système @command{pdflatex},
-parmi d'autres commandes (@pxref{@TeX{} engines}), alors la sortie
-principale est un fichier ``Portable Document Format''
+alors la sortie principale est un fichier ``Portable Document Format''
(@file{.pdf}). Typiquement, il s'agit d'un fichier autonome, avec toutes
les polices et images incorporées.
+D'autres commandes (@pxref{@TeX{} engines}) produisent des fichiers PDF.
@c - Cela peut être très utile, mais cela rend le fichier de sortie beaucoup
@c - plus grand que le fichier @file{.dvi} produit à partir du même document.
@@ -413,7 +438,7 @@ Ce fichier de transcription, ou @dfn{fichier journal}, contient des
informations sommaires telles que la liste des paquetages chargés. Il
contient aussi des messages de diagnostic
@c - 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.
@item .aux
@@ -425,12 +450,12 @@ erreurs.
De l'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 --- une double référence à
-quelque-chose qui n'est pas encore apparu dans le code source --- il
+quelque chose qui n'est pas encore apparu dans le code source --- il
apparaîtra dans la sortie comme un double point d'interrogation
@code{??}. Quand l'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 @code{.aux}. À l'invocation suivante,
-@LaTeX{} lit l'inforlation de localisation à partir de ce fichier et
+@LaTeX{} lit l'information de localisation à partir de ce fichier et
l'utilise pour résoudre le renvoi, en remplaçant le double point
d'interrogation avec la localisation mémorisée.
@@ -464,9 +489,9 @@ fin définie.
@cindex entrée Unicode, native
@cindex polices TrueType
@cindex polices OpenType
-@LaTeX{} est défini comme un ensemble de commande qui sont exécutées par
+@LaTeX{} est défini comme un ensemble de commandes qui sont exécutées par
une implémentation @TeX{} (@pxref{Overview}). Cette section donne une
-vue d'ensemble laconique des principaux programmes.
+brève vue d'ensemble des principaux programmes.
@table @code
@item latex
@@ -487,7 +512,7 @@ original de Knuth (@url{http://ctan.org/pkg/etex}), ce qui inclut des
caractéristiques supplémentaires de programmation et la composition
bi-directionnelle, et a lui-même de nombreuses extentions. e-@TeX{} est
lui-même disponible par la commande système @command{etex}, mais le
-langage du fichier d'entrée est du @TeX{} de base (et le fichier produit
+langage du fichier d'entrée est du @value{PlainTeX} (et le fichier produit
est un @file{.dvi}).
Dans d'autres distributions @TeX{}, @command{latex} peut invoquer
@@ -500,9 +525,9 @@ l'hyptohèse que les extension e-@TeX{} sont disponibles en @LaTeX{}.
Si @LaTeX{} est invoqué avec la commandes systèmes @command{lualatex},
alors le moteur Lua@TeX{} est exécuté
(@url{http://ctan.org/pkg/luatex}). Ce programme permet que du code
-écrit dans le langage script Lua (@url{http://luatex.org}) intéragisse
+écrit dans le langage script Lua (@url{http://luatex.org}) interagisse
avec la compostion faite par @TeX{}. Lua@TeX{} traite nativement
-l'entrée en Unicode UTF-8, peut traiter les polices OpenType et
+l'entrée en codage Unicode UTF-8, peut traiter les polices OpenType et
TrueType, et produit un fichier @file{.pdf} par défaut. Il y a aussi
@command{dvilualatex} pour produire un fichier @file{.dvi}, mais cela
est rarement utilisé.
@@ -514,10 +539,10 @@ est rarement utilisé.
@findex xdvipdfmx
Si @LaTeX{} est invoqué avec la commandes système @command{xelatex}, le
moteur Xe@TeX{} est exécuté (@url{http://tug.org/xetex}). Comme
-Lua@TeX{}, Xe@TeX{} prend en charge nativement UTF-8 Unicode et les
-polices TrueType et OpenType, bien que l'implementation soit
-complètement différente, utilisant principalement des bibliothèque
-externe plutôt que du code interne. Xe@TeX{} produit un fichier @file{.pdf}
+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 @file{.pdf}
en sortie ; il ne prend pas en charge la sortie DVI.
En interne, Xe@TeX{} crée un fichier @code{.xdv} file, une variante de
@@ -527,8 +552,8 @@ Le fichier @code{.xdv} n'est utile que pour le débogage.
@end table
-D'autres vairantes de @LaTeX{} et @TeX{} existent, par ex. pour fournir
-une prise en charge supplémentaires du japonais des d'autres langages
+D'autres variantes de @LaTeX{} et @TeX{} existent, par exemple pour fournir
+une prise en charge supplémentaire du japonais et d'autres langages
([u]p@TeX{}, @url{http://ctan.org/pkg/ptex},
@url{http://ctan.org/pkg/uptex}).
@@ -541,47 +566,55 @@ une prise en charge supplémentaires du japonais des d'autres langages
@findex [...] @r{pour les arguments optionnels}
@findex @{...@} @r{pour les arguments obligatoires}
Dans le fichier d'entrée @LaTeX{}, un nom de commande commence avec une
-contr'oblique, @code{\}. Le nom lui-même consiste soit en (a) une
-chaîne de lettres ou (b) une unique non-lettre.
+contre-oblique, @code{\}. 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'est pas une lettre.
Les noms de commandes @LaTeX{} sont sensibles à la casse de sorte que
@code{\pagebreak} diffère de @code{\Pagebreak} (ce dernier n'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.
Une commande peut être suivie de zéro, un ou plus d'arguments. Ces
arguments peuvent être soit obligatoires, soit optionnels. Les
arguments obligatoires sont entre accolades, @code{@{...@}}. Les
-arguments optionnels sont entre crochets, @code{[...]}. En général,
-mais ce n'est pas universel, si la commande prend un argument optionnel,
+arguments optionnels sont entre crochets, @code{[...]}. En général
+(mais ce n'est pas universel), si la commande prend un argument optionnel,
il vient en premier, avant tout argument obligatoire.
Au sein d'un argument optionnel, pour utiliser le crochet
-fermant (@code{]}) cachez le au sein d'accolades, comme
+fermant (@code{]}) cachez-le au sein d'accolades, comme
dans @code{\item[crochet fermant @{]@}]}. 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.
-@LaTeX{} a la convetion que certaines commandes ont une forme en a
-@code{*} qui est en relation avec la forme sans le @code{*}, telles que
+@LaTeX{} obéit à la convention selon laquelle certaines commandes ont une forme étoilée
+(@code{*}) qui est en relation avec la forme sans le @code{*}, telles que
@code{\chapter} et @code{\chapter*}. La différence exacte de
comportement dépend de la commande.
-Ce manuel décrit toutes les options accepté et les formes en @code{*}
-pour les commandes dont il traite (à l'exeption des omissions
-involontaires, ou bogues de ce manuel).
+Ce manuel décrit toutes les options acceptées et les formes en @code{*}
+pour les commandes dont il traite (à l'exception des omissions
+involontaires ou bogues de ce manuel).
+@c xxx Revoir le menu
@menu
-* Environnement: Environment. Zone du code source avec un comportement distinct.
* Déclaration: Declaration. Changer la valeur ou la signification d'une commande.
-* \makeatletter et \makeatother: \makeatletter and \makeatother. Change la catégorie du caractère arobe.
@end menu
+
+@node Declaration
+@subsection Les déclarations de commandes
+
+Certaines commandes changent la valeur ou la signification d'une
+autre commande ou d'un paramètre. Par exemple, la commande @code{\mainmatter}
+change le réglage de la numérotation des pages en passant de chiffres
+romains à des chiffres arabes.
+
@node Environment
-@subsection Les environnements
+@section Les environnements
Synopsis :
@@ -597,23 +630,23 @@ les lignes entre @code{\begin@{verse@}} et @code{\end@{verse@}}.
@example
\begin@{verse@}
- There once was a man from Nantucket \\
+ Plus ne suis ce que j'ai été \\
...
\end@{verse@}
@end example
Voir @ref{Environments} pour une liste des environnements.
-Le @var{nom environnement} au début doit s'accorder exactement avec
-celui à la fin. Ceci comprend le cas où @var{nom environnement} se
-termine par une étoile(@code{*}) ; l'argument à la fois de
+Le @var{nom environnement} du début doit s'accorder exactement avec
+celui de la fin. Cela vaut aussi dans le cas où @var{nom environnement} se
+termine par une étoile (@code{*}) ; l'argument à la fois de
@code{\begin} et @code{\end} doit comprendre l'étoile.
Les environnements peuvent avoir des arguments, y compris des arguments
optionnels. L'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).
@example
\begin@{tabular@}[t]@{r|l@}
@@ -621,378 +654,41 @@ obligatoire (il spécifie le format des colonnes).
\end@{tabular@}
@end example
+@node CTAN
+@section CTAN : The Comprehensive @TeX{} Archive Network
-@node Declaration
-@subsection Les déclarations de commandes
-
-Une commande qui change la valeur, ou change la signification, d'une
-autre commande ou paramètre. Par exemple, la commande @code{\mainmatter}
-change le réglage de la numérotation des pages en passant de numéros
-romains à des numéros arabes.
-
-@node \makeatletter and \makeatother
-@subsection @code{\makeatletter} et @code{\makeatother}
-
-Synopsis :
-
-@example
-\makeatletter
- ... définition de commande comprenant @@ dans leur nom ..
-\makeatother
-@end example
-
-Utilisé pour redéfinir des commandes internes de @LaTeX{}.
-@code{\makeatletter} a pour effet que le caractère arobe @code{@@} ait
-le code de catégorie des lettres, c.-à-d.@: 11. @code{\makeatother}
-règle de code de catégorie de @code{@@} à 12, sa valeur d'origine.
-
-À mesure que chaque caractère est lu par @TeX{} pour @LaTeX{}, un code
-de catégorie lui est assigné. On appelle aussi ce code
-@cindex catcode
-@cindex code de catégorie de caractère
-@cindex catégorie, code de @dots{} de caractère
-@dfn{catcode} pour faire court. Par exemple, la contr'oblique @code{\}
-reçoit le catcode 0, qui correspond aux catactères qui commencent une
-commande. Ces deux commandes altèrent le catcode assigné à @code{@@}.
-
-Cette altération est nécessaire parce que beaucoup des commandes de
-@LaTeX{} utilisent @code{@@} dans leur nom, de sorte à empécher les
-utilisateurs de définir accidentellement une commande qui remplacerait
-l'une des commandes privées de @LaTeX{}. Les noms de commandes
-consistent en un caractère de catégorie 0, d'ordinaire une
-contr'oblique, suivi de lettres, c.-à-d.@: des caractères de
-catégorie 11 (à ceci près q'un nom de commande peut aussi consister d'un
-catactère de catégorie 0 suivi d'un seul symbole non-lettre). Ainsi sous
-le régime par défaut de codes de catégorie, les commandes définies par
-l'utilisateur ne peuvent pas contenir de @code{@@}. Mais
-@code{\makeatletter} et @code{\makeatother} permettent aux utilisateurs
-de définir et re-définir des commandes dont le nom comprend un
-@code{@@}.
-
-À utiliser dans un fichier @file{.tex}, dans le préambule. Ne pas
-utiliser dans des fichiers @file{.sty} ou @file{.cls} puisque les
-commandes @code{\usepackage} et @code{\documentclass} règlent le code de
-catégorie de l'arobe à celui d'une lettre.
-
-@PkgIndex{macros2e}
-Pour une liste complète des macros contenant un arobe dans leur nom,
-voir le document @url{http://ctan.org/pkg/macros2e}. Ces macros sont
-surtout à l'intention des auteurs de classes et de paquetages.
-
-@c xxxx TODO : ajouter une avertissement sur cet exemple.
-L'exemple ci-après est typique. Une commande
-@code{\these@@nomuniversite} se trouve dans le fichier de classe de
-l'utilisateur. L'utilisateur veut changer sa définition. Pour cela, il
-suffit d'insérer les trois lignes suivantes dans le préambule, avant le
-@code{\begin@{document@}} :
-
-@example
-\makeatletter
-\renewcommand@{\these@@nomuniversite@}@{Université Lyon III Jean Moulin@}
-\makeatother
-@end example
-
+@cindex CTAN
-@menu
-* \@@startsection:: Redéfinir les commandes de rubricage.
-* \@@ifstar:: Définir vos propres commandes étoilées.
-@end menu
+Le @guillemetleft{}Comprehensive @TeX{} Archive
+Network@guillemetright{}, ou CTAN, est le dépôt de matériel libre de la
+communauté @TeX{} et @LaTeX{}. C'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'adresse
+@url{https://ctan.org}.
+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'organismes d'édition on un paquetage qui permet aux auteurs de
+formater leurs articles conformément aux spécification de cet organisme.
-@node \@@startsection
-@subsubsection @code{\@@startsection}
+En plus des resources massives, le site @code{ctan.org} offre des fonctions telles que
+la recherche par nom ou par fonctionalité.
-Synopsis :
-
-@example
-\@@startsection@{@var{nom}@}@{@var{niveau}@}@{@var{retrait}@}@{@var{avant}@}@{@var{après}@}@{@var{style}@}
-@end example
-
-Cette commande permet de redéfinir les commandes de rubricage telles que @code{\section} ou @code{\subsection}.
-
-Notez que le paquetage @file{titlesec} rend la manipulation du rubricage
-plus facile. De plus, bien que la plupart des exigences concernant les
-commandes de rubricage peuvent être remplies avec
-@code{\@@startsection}, ce n'est pas le cas de toutes. Par exemple,
-dans les classes @LaTeX{} standardes @code{book} et @code{report} les
-commandes @code{\chapter} et @code{\report} ne sont pas construite de
-cette manière. Pour fabriquer une telle commande il est possible
-d'utiliser la commande @code{\secdef}.
-@c xx define, and make a cross reference to, secdef.
-
-Techniquement, cette commande a la forme :
-@example
-\@@startsection@{@var{nom}@}@{@var{niveau}@}@{@var{retrait}@}@{@var{avant}@}@{@var{après}@}@{@var{style}@}
- *[@var{titretdm}]@{@var{titre}@}
-@end example
-@noindent de sorte que faire :
-@example
-\renewcommand@{\section@}@{\@@startsection@{@var{nom}@}@{@var{niveau}@}@{@var{retrait}@}%
- @{@var{avant}@}@{@var{après}@}@{@var{style}@}@}
-@end example
-@noindent redéfinit @code{\section} en gardant sa forme standarde d'appel
-@code{\section*[@var{titretdm}]@{@var{titre}@}}. @xref{Sectioning} et
-les exemples plus bas.
-
-
-@table @var
-
-@item nom
-@anchor{\@@startsection/name} 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 @code{section}, @code{subsection}, ou
-@code{paragraph}. 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'est pas
-exigé.
-
-Alors @code{\the}@var{name} affiche le numéro de titre, et
-@code{\}@var{name}@code{mark} sert aux en-têtes de page.
-
-@item niveau
-@anchor{\@@startsection/level} Un entier donnant la profondeur de la
-commande de rubricage, par ex.@: 0 pour @code{chapter} (ceci ne
-s'applique qu'aux classes standardes @code{book} et @code{report}), 1
-pour @code{section}, 2 pour @code{subsection}, 3 pour
-@code{subsubsection}, 4 pour @code{paragraph} et 5 pour
-@code{subparagraph}. Dans les classes @code{book} et @code{report},
-@code{part} a pour niveau -1, alors que dans la classe @code{article},
-@code{part} a pour niveau 0.
-
-Si @var{niveau} est inférieur ou égal à la valeur de @code{secnumdepth}
-alors les titres pour cette commande de rubricage sont numérotés. Par
-ex.@: dans un @code{article}, si @code{secnumdepth} vaut 1 alors une
-commande @code{\section@{Introduction@}} produira en sortie quelque
-chose du genre de @code{1 Introduction} alors que
-@code{\subsection@{Historique@}} produit en sortie quelque chose du
-genre de @code{Historique}, sans numéro en
-préfixe. @xref{Sectioning/secnumdepth}.
-
-Si @var{niveau} est inférieur ou égal à la valeur de @code{secnumdepth}
-alors la table des matières aura un article pour cette rubrique. Par
-exemple, dans un @code{article}, si @code{tocdepth} vaut 1 alors la
-table des matières listera les @code{section}s, mais pas les
-@code{subsection}s.
-
-
-@item retrait
-@anchor{\@@startsection/indent}Une longueur donnant le renfoncement de
-toutes les lignes du titre relativement à la marge. Pour un
-renfoncement nul, utilisez @code{0pt}.
-@c vous pouvez utiliser la macro @code{\z@@} définie à @code{0pt} pour
-@c que le code soit plus efficace
-Une valeur négative telle que @code{-1em} cause un débord du titre dans
-la marge.
-
-@item avant
-@anchor{\@@startsection/beforeskip} Longueur dont la valeur absolue est
-la longueur de l'espace vertical à insérer avant le titre de la
-rubrique. Cet espacement est ignoré si la rubrique commence au début
-d'une page. Si en plus @var{avant} est négatif, alors le premier
-paragraphe suivant immédiatement le titre n'est pas renfoncé, s'il est
-positif ou nul il l'est. (Notez que l'opposé de @code{1pt plus 2pt
-minus 3pt} est @code{-1pt plus -2pt minus -3pt}).
-
-Par exemple si @var{avant} vaut @code{-3.5ex plus -1ex minus -0.2ex}
-alors pour commencer la nouvelle rubrique, @LaTeX{} ajoute environ 3,5
-fois la hauteur d'une lettre x en espace veritical, et le premier
-paragraphe de la rubrique n'est pas renfoncé. Utiliser une longueur
-élastique, c.-à-d.@: comprenant @code{plus} et @code{minus}, est une
-bonne pratique ici car cela donne à @LaTeX{} plus de latitude lors de la
-fabrication de la page.
-
-La quantité totale d'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 @code{\parskip} dans la police du corps de texte, du
-@code{\baselineskip} de la police du titre, et de la valeur absolue de
-l'argument @var{avant}. Cet espace est typiquement élastique et peut se
-dilater ou se contracter. (Si la rubrique commence en début d'une page
-de sorte que cet espace soit ignoré, alors la ligne de base du titre
-correspond à la ligne de base qu'aurait la première ligne de texte sur
-cette page si celle-ci commençait par du texte).
-
-@item après
-@anchor{\@@startsection/afterskip} Longueur. Lorsque elle est positive
-ou nulle, il s'agit de l'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'espace horizontal entre la fin du titre et le début
-du paragraphe suivant. (Notez que l'opposé de @code{1pt plus 2pt minus
-3pt} est @code{-1pt plus -2pt minus -3pt}).
-
-Comme c'est le cas avec @var{avant}, utiliser une longueur élastique
-avec des composantes @code{plus} et @code{minus} est une bonne pratique
-ici puisque elle donne à @LaTeX{} plus de latitude pour assembler la
-page.
+@cindex DANTE e.V.
+CTAN n'est pas un site unique, mais au lieu de cela un ensemble de
+sites. L'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.
-Si @var{après} est positif ou nul alors la quantité totale d'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
-@code{\parskip} de la police du titre, de @code{\baselineskip} de la
-police du corps de texte, et de la valeur de @var{après}. Cet espace est
-typiquement élastique de sorte qu'il puisse se dilater ou se
-contracter. (Notez que du fait que le signe d'@var{après} contrôle que
-le titre soit indépendant du texte le suivant, ou fasse corps avec lui,
-vous ne pouvez pas utiliser un @var{après} négatif pour annuler une
-partie du @code{\parskip}).
-
-@item style
-@anchor{\@@startsection/style} Contrôle le style du titre, voir les
-exemples plus bas. Les commandes typiquement utilisées ici sont
-@code{\centering}, @code{\raggedright}, @code{\normalfont},
-@code{\hrule}, ou @code{\newpage}. La dernière commande au sein de
-@var{style} peut être une commande prenant un argument, telle que
-@code{\MakeUppercase} ou @code{\fbox}. Le titre de la rubrique est passé
-en argument à cette commande. Par exemple régler @var{style} à
-@code{\bfseries\MakeUppercase} a pour effet de produire des titres gras
-et en capitales.
-@end table
-
-Voici des exemples. Pour les utiliser mettez les soit au sein d'un
-fichier de paquetage ou de classe, ou placez les dans le préambule d'un
-document @LaTeX{} entre des commandes @code{\makeatletter} et
-@code{\makeatother}. (Le message d'erreur @code{You can't use
-`\spacefactor' in vertical mode.} est le plus probable lorsque on
-oublie de faire cela). @xref{\makeatletter and \makeatother}.
-
-L'exemple suivant redéfinit la commande de rubricage @code{\section}
-pour qu'elle centre le titre et le mette en gras :
-
-@example
-\renewcommand\section@{%
- \@@startsection@{section@}% @ref{\@@startsection/name,@var{nom},@var{nom}}.
- @{1@}% @ref{\@@startsection/level,@var{niveau},@var{niveau}}.
- @{0pt@}% @ref{\@@startsection/indent,@var{retrait},@var{retrait}}.
- @{-3.5ex plus -1ex minus -.2ex@}% @ref{\@@startsection/beforeskip,@var{avant},@var{avant}}.
- @{2.3ex plus.2ex@}% @ref{\@@startsection/afterskip,@var{après},@var{après}}.
- @{\centering\normalfont\Large\bfseries@}@}% @ref{\@@startsection/style,@var{style},@var{style}}.
-@end example
-
-Cet exemple met les titres de @code{subsection} en petites capitales, et
-leur fait faire corps avec le paragraphe suivant.
-
-@example
-\renewcommand\subsection@{%
- \@@startsection@{subsection@}% @ref{\@@startsection/name,@var{nom},@var{nom}}.
- @{2@}% @ref{\@@startsection/level,@var{niveau},@var{niveau}}.
- @{0em@}% @ref{\@@startsection/indent,@var{retrait},@var{retrait}}.
- @{-1ex plus 0.1ex minus -0.05ex@}% @ref{\@@startsection/beforeskip,@var{avant},@var{avant}}.
- @{-1em plus 0.2em@}% @ref{\@@startsection/afterskip,@var{après},@var{après}}.
- @{\scshape@}% @ref{\@@startsection/style,@var{style},@var{style}}.
- @}
-@end example
-
-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'un compteur et de macros pour son affichage.
-
-@c From https://groups.google.com/forum/#!searchin/comp.text.tex/startsection%7Csort:relevance/comp.text.tex/sB-nTS-oL08/ZZeKYdG0llMJ
-@example
-\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
-@end example
-
-
-
-@node \@@ifstar
-@subsubsection @code{\@@ifstar}
-
-@findex \@@ifstar
-@cindex commandes, variantes étoilées
-@cindex étoilées, variantes de commandes
-
-
-@c Inpirée des trucs & astuces de Manuel Pégourié-Gonnard
-@c (https://elzevir.fr/imj/latex/tips.html#stared)
-
-Vous l'avez sans doute remarqué, beaucoup d'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.
-
-Si vous avez lu @ref{\newenvironment & \renewenvironment}, vous aurez compris
-que c'est immédiat pour les environnements car l'étoile est un caractère
-autorisé dans les noms d'environnements. Il vous suffit donc de faire
-@code{\newenvironment@{@var{monenv}@}} et
-@code{\newenvironment@{@var{monenv}*@}} avec les définitions souhaitées.
-
-Pour les commandes, c'est plus compliqué car l'é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'une étoile et d'adapter son
-comportement en conséquence. Cette première commande ne pourra pas accepter
-d'argument, mais pourra faire appel à des commandes qui en acceptent. Par
-ailleurs, on utilise la commande @code{\@@ifstar} interne du noyau @LaTeX{} et
-vous pouvez vous reportez à « @ref{\makeatletter and \makeatother} » pour
-comprendre pourquoi cela implique l'usage d'un bloc
-@code{\makeatletter...\makeatother}.
-
-Dans cet exemple, on définit @code{\ciel} comme une commande avec un
-argument obligatoire et admettant une variante étoilée @code{\ciel*}
-également avec un argument obligatoire :
-
-@example
-\makeatletter
-\newcommand*\ciel@@starred[1]@{ciel #1 étoilé@}
-\newcommand*\ciel@@unstarred[1]@{ciel #1 non étoilé@}
-\newcommand\ciel@{\@@ifstar@{\ciel@@starred@}@{\ciel@@unstarred@}@}
-\makeatother
-@end example
-
-@noindent ainsi, @code{\ciel@{bleu@}} composera « ciel bleu non étoilé » tandis que
-@code{\ciel*@{nocturne@}} composera « ciel nocturne étoilé ».
-
-Notez que les commandes intermédiaires @code{\ciel@@starred} et
-@code{\ciel@@unstarred} comportent un @code{@@} dans leur nom ce qui est
-possible puisque elles apparaissent au sein d'un bloc
-@code{\makeatletter...\makeatother}. Ceci assure qu'elles ne puissent pas être
-utilisées directement dans le document. L'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
-@code{\newcommand*@{\@var{cmd}@}} vérifie que si la commande @code{\@var{cmd}}
-n'est pas déjà définie et génère une erreur si c'est le cas.
-
-Voici un autre exemple où la commande @code{\agentsecret} comporte deux
-arguments et sa variante étoilée @code{\agentsecret*} un seul :
-
-@example
-\makeatletter
-\newcommand*\agentsecret@@starred[1]@{\textsc@{#1@}@}
-\newcommand*\agentsecret@@unstarred[2]@{\textit@{#1@} \textsc@{#2@}@}
-\newcommand\agentsecret@{\@@ifstar@{\agentsecret@@starred@}@{\agentsecret@@unstarred@}@}
-\makeatother
-@end example
-
-@noindent Avec cette définition la célèbre réplique de l'agent 007 :
-
-@example
-Je m'appelle \agentsecret*@{Bond@}, \agentsecret@{James@}@{Bond@}.
-@end example
-
-@noindent est équivalente à :
-
-@example
-Je m'appelle \textsc@{Bond@}, \textit@{James@} textsc@{Bond@}.
-@end example
-
-Un dernier mot : contrairement aux noms d'environnement où l'étoile fait partie
-du nom lui-même, et pourrait donc être à n'importe quelle position, dans le nom
-d'une commande l'étoile est comme une sorte d'argument optionnel. D'un point de
-vue purement @TeX{}nique il est donc possible de mettre un nombre indéfini
-d'espaces entre la commande et l'étoile. Ainsi @code{\agentsecret*@{Bond@}} et
-@code{\agentsecret *@{Bond@}} sont équivalents. Toutefois la pratique commune
-est de ne jamais insérer de tels espaces.
+@cindex mirrors of CTAN
+D'autres sites autour du monde apportent leur aide en miroitant, c'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 à @url{https://ctan.org/mirrors}.
@node Document classes
@chapter Classes de documents
@@ -1000,7 +696,8 @@ est de ne jamais insérer de tels espaces.
@cindex classes de documents
@findex \documentclass
-La classe d'un document donné est définie avec la commande:
+La classe globale d'un document est définie avec cette commande, c'est
+normalement la première commande dans une fichier source @LaTeX{}.
@example
\documentclass[@var{options}]@{@var{classe}@}
@@ -1015,16 +712,44 @@ fichier source @LaTeX{}.
@findex @r{classe} book
@findex @r{classe} letter
@findex @r{classe} slides
-Les noms de @var{classe} @LaTeX{} encastrés sont (beaucoup d'autres
-classes de documents sont disponibles en modules ; @pxref{Overview}):
+Les noms de @var{classe} de document incorporés à @LaTeX{}. (Beaucoup
+de classes de document sont disponibles dans des paquetages séparés ;
+@pxref{Overview}.)
-@example
-article report book letter slides
-@end example
+@table @code
+@item article
+@anchor{document classes article}
+Pour un article de journal, une présentation, et diverses utilisations
+générales.
+
+@item book
+@anchor{document classes book}
+
+Des livres complets, y compris des chapitres et possiblement incluant
+des pièces préliminaires telles qu'une préface, et postliminaires telles
+qu'un appendice (@pxref{Front/back matter}).
+
+@item letter
+@anchor{document classes letter}
+Courrier, incluant optionnellement des étiquettes pour enveloppes
+(@pxref{Letters}).
+
+@item report
+@anchor{document classes report}
+Pour des documents de longueur entre celle d'un @code{article} et celle
+d'un @code{book}, tels que des rapports techniques ou des thèses, et qui
+peuvent contenir plusieurs chapitres.
+
+@item slides
+@anchor{document classes slides}
+Pour des présentations de diapositive --- rarement utilisé de nos jours.
+À sa place la classe @code{beamer} est sans doute celle dont l'usage est
+le plus répendu (@url{https://ctan.org/pkg/beamer}). @xref{beamer
+template}, pour un petit partron de document beamer.
-@c xx décrire brièvement chacun
+@end table
-Les @var{options} standardes sont décrites ci-dessous.
+Les @var{options} standardes sont décrites dans les rubriques suivantes.
@menu
* Options de classe de document: Document class options. Options globales
@@ -1100,6 +825,7 @@ que @code{letterpaper} règlent la zone d'impression mais vous devez
également régler la taille du papier physique. Un méthode pour faire
cela est de placer @code{\pdfpagewidth=\paperwidth} et
@code{\pdfpageheight=\paperheight} dans le préambule de votre document.
+@PkgIndex{geometry}
Le paquetage @code{geometry} fournit des méthodes flexibles pour régler
la zone d'impression et la taille du papier physique.
@@ -1209,7 +935,7 @@ pourriez créer une nouvelle classe @code{cmsnote.cls} et commencer vos
documents par @code{\documentclass@{cmsnote@}}.
Ce qui distingue un paquetage d'une classe de document c'est que les
-commandes d'une paquatage sont utilisables pour différentes classes
+commandes d'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'une commande intitulant en-têtes de
@@ -1218,10 +944,10 @@ une classe.
@cindex classe et paquetage, différence
@cindex différence entre classe et paquetage
-Au sein d'un fichier classe pour paquetate on peu utiliser l'arobe
+Au sein d'un fichier classe ou paquetage on peut utiliser l'arobe
@code{@@} comme un caractère dans les noms de commande sans avoir à
entourer le code contenant la commande en question par
-@code{\makeatletter} et @code{\makeatother}. @xref{\makeatletter and
+@code{\makeatletter} et @code{\makeatother}. @xref{\makeatletter &
\makeatother}. 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
@@ -1398,10 +1124,10 @@ uniquement être utilisé au sein de l'argument @var{code} soit de
@item \DeclareOption*@{@var{option}@}@{@var{code}@}
@findex \DeclareOption
@findex \DeclareOption*
-@cindex class options
-@cindex package options
-@cindex options, class
-@cindex options, package
+@cindex classe, options
+@cindex paquetage, options
+@cindex options de classe
+@cindex options de paquetage
Rend un option @var{option} disponible pour l'utilisateur, de sorte à ce
qu'il puisse la passer à leur commande @code{\documentclass}. Par
exemple, la classe @code{notecms} pourrait avoir une option @code{logo}
@@ -1463,7 +1189,7 @@ au sein d'un argument mouvant, utilisez @code{\newcommand}.
@code{\providrobustcmd*} qui sont similaire aux commandes standardes
@code{\newcommand}, @code{\newcommand*}, @code{\renewcommand},
@code{\renewcommand*}, @code{\providecommand}, et
-@code{\providcommand*}, mais définissent une commande @var{cmd} robuste
+@code{\providecommand*}, mais définissent une commande @var{cmd} robuste
avec deux advanges par rapport à @code{\DeclareRobustCommand} :
@enumerate
@item
@@ -1547,7 +1273,7 @@ et le plus souvent elle est utilisée de cette façon :
classe est traité, le nom du format donné ici doit s'accorder avec le
format qui est en cours d'exécution (y compris le fait que la chaîne
@var{format} est sensible à la casse). Si il ne s'y accorde pas alors
-l'exécution est interrompue par une erruer du genre de @samp{This file
+l'exécution est interrompue par une erreur du genre de @samp{This file
needs format `LaTeX2e' but this is `xxx'.}
Pour spécifier une version du format dont vous savez qu'elle prend en
@@ -1614,9 +1340,9 @@ option. L'utilisateur peut commencer son fichier @LaTeX{} avec
@item \ProcessOptions*@var{\@@options}
@findex \ProcessOptions
@findex \ProcessOptions*
-Exécute le code associé à chaque option que l'utilisateur a invoquée. À
-include dans le fichier classe sous la forme
-@code{\ProcessOptions\relax} (à cause de l'existance de la variant
+Exécute le code pour chaque option que l'utilisateur a invoquée. À
+inclure dans le fichier classe sous la forme
+@code{\ProcessOptions\relax} (à cause de l’existence de la variante
étoilée de la commande).
Les options tombent dans deux catégories. Les @dfn{options locales}
@@ -1720,7 +1446,7 @@ Charge un paquetage, comme la commande @code{\usepackage} pour les
auteurs de documents. @xref{Additional packages}. Voici un exemple :
@code{\RequirePackage[landscape,margin=1in]@{geometry@}}. Notez que
l'équipe de développement de @LaTeX{} recommande fortement l'utilisation
-de ces commande de préférence à l'@code{\input} de Plain@tie{}@TeX{} ;
+de ces commandes de préférence à l'@code{\input} de @value{PlainTeX} ;
voir le « Class Guide ».
La @var{liste d'options}, si présente, est une liste ponctuée de
@@ -1839,7 +1565,7 @@ Petites capitales.
@item \texttt (\ttfamily)
@findex \texttt
@findex \ttfamily
-Machine à écrire.
+Tapuscrit, encore appelé « machine à écrire ».
@item \textnormal (\normalfont)
@findex \textnormal
@@ -1860,7 +1586,7 @@ Sans serif, pour une utilisation en mode mathématique.
@item \mathtt
@findex \mathtt
-Machine à écrire, pour une utilisation en mode mathématique.
+Tapuscrit, pour une utilisation en mode mathématique.
@item \mathit
@itemx (\mit)
@@ -1944,8 +1670,9 @@ Incliné (oblique).
@item \tt
@cindex police machine à écrire
+@cindex police tapuscrit
@cindex police de largeur fixe
-Machine à écrire (largeur fixe).
+Tapuscrit, encore appelé « Machine à écrire » (largeur fixe).
@end ftable
@@ -1964,7 +1691,7 @@ ensembles de commandes ont leur place.
@cindex tailles des polices de caractères
@cindex tailles de texte
-Les commandes de type de taille standard suivants sont pris en charge
+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 @samp{10pt}, @samp{11pt}, et @samp{12pt} de classe de document,
@@ -2006,12 +1733,39 @@ respectivement (@pxref{Document class options}).
@tab 24.88 @tab 24.88 @tab 24.88
@end multitable
-Les commandes énumérées ici sont des ``forme déclaratives''. La portée
-d'une forme déclarative s'étend jusqu'à la prochaine la commande de type
-style ou la fin du groupe courant. Vous pouvez également utiliser la
-``forme d'environnement'' de ces commandes ; par exemple,
-@code{\begin@{tiny@} ... \end@{tiny@}}.
+@cindex déclarative, forme des commandes de contrôle de la taille de police
+@cindex forme déclarative des commandes de contrôle de la taille de police
+Les commandes énumérées ici sont des @dfn{formes déclaratives}. On est
+utilise en les déclarant comme dans l'exemple qui suit :
+@example
+\begin@{quotation@} \small
+ Le Tao que l'on peut nommer n'est pas le Tao.
+\end@{quotation@}
+@end example
+
+@noindent
+Dans ce qui précède, la portée de @code{\small} s'étend jusqu'à la fin
+de l'environnement @code{quotation}. Elle s'arrêterait également à la
+prochaine commande de style ou à la fin du groupe courant, de sorte
+qu'on aurait pu la mettre entre accolades @code{@{\small Ce texte est en
+petits caractères.@}}.
+
+@cindex forme par environnement des commandes
+Une @dfn{forme par environnement} de chacune de ces commandes est également
+définie ; par exemple, @code{\begin@{tiny@}...\end@{tiny@}}. Toutefois,
+en pratique cette forme peut aisément mener à des espaces indésirables au
+début et/ou à la fin de d'environnement si on n'y prête pas attention,
+ainsi on risque en général moins de faire d'erreur si on s'en tient à la
+forme déclarative.
+
+(Digression : techniquement, vu la façon dont @LaTeX{} définit
+@code{\begin} et @code{\end}, presque toutes les commandes qui ne
+prennent pas d'argument on une forme par environnement. Mais dans
+presque tous les cas ce serait juste une source de confusion de
+l'utiliser. La raison pour mentionner en particulier la forme par
+environnement des déclarations de taille de police est que leur
+utilisation s'avère assez courante, en dépit des problèmes qu'il pose).
@node Low-level font commands
@section commandes de fontes de bas niveau
@@ -2021,96 +1775,235 @@ style ou la fin du groupe courant. Vous pouvez également utiliser la
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.
+@c xx but it should be complete
+@c xx something about ultimately reading ENCFAM.fd?
@table @code
@item \fontencoding@{codage@}
@findex \fontencoding
-Sélectionnez le codage de police. Les codages valides comprennent @code{OT1} et @code{T1}.
-
-@item \fontfamily@{famille@}
+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
+@code{OT1}, le codage original de D.@: Knuth pour la police Computer
+Modern (la police par défaut), et @code{T1}, é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'autres encore), ce qui permet à @TeX{} de faire la césure
+des mots contenant des lettres accentuées. Pour plus d'information, voir
+@url{https://ctan.org/pkg/encguide}.
+
+@item \fontfamily@{@var{famille}@}
@findex \fontfamily
-Sélectionnez la famille de polices. Familles valides sont :
+@cindex famille de polices
+@cindex polices, catalogue
+Sélectionne la famille de polices. La page web
+@url{https://www.tug.dk/FontCatalogue/} 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 :
+
+@multitable {font} {Computer Modern Typewriter XXXX}
+@item @code{pag}
+@tab Avant Garde
+@item @code{fvs}
+@tab Bitstream Vera Sans
+@item @code{pbk}
+@tab Bookman
+@item @code{bch}
+@tab Charter
+@item @code{ccr}
+@tab Computer Concrete
+@item @code{cmr}
+@tab Computer Modern
+@item @code{cmss}
+@tab Computer Modern Sans Serif
+@item @code{cmtt}
+@tab Computer Modern Typewriter
+@item @code{pcr}
+@tab Courier
+@item @code{phv}
+@tab Helvetica
+@item @code{fi4}
+@tab Inconsolata
+@item @code{lmr}
+@tab Latin Modern
+@item @code{lmss}
+@tab Latin Modern Sans
+@item @code{lmtt}
+@tab Latin Modern Typewriter
+@item @code{pnc}
+@tab New Century Schoolbook
+@item @code{ppl}
+@tab Palatino
+@item @code{ptm}
+@tab Times
+@item @code{uncl}
+@tab Uncial
+@item @code{put}
+@tab Utopia
+@item @code{pzc}
+@tab Zapf Chancery
+@end multitable
-@itemize @bullet
-@item @code{cmr} pour Computer Modern Roman
-@item @code{cmss} pour Computer Modern Sans Serif
-@item @code{cmtt} pour Computer Modern Typewriter
-@end itemize
+@item \fontseries@{@var{série}@}
+@findex \fontseries
+@cindex séries de polices
+Sélectionne une série de police. Une @dfn{série} combine une
+@dfn{graisse} et une @dfn{largeur}. Typiquement, une police prend en
+charge seulement quelques-unes des combinaisons possibles. Les
+combinaisons de valeurs de séries comprennent notamment :
+
+@multitable {xx} {Moyen (normal)xx}
+@item @code{m}
+@tab Moyen (normal)
+@item @code{b}
+@tab Gras
+@item @code{c}
+@tab Condensé
+@item @code{bc}
+@tab Condensé Gras
+@item @code{bx}
+@tab Gras étendu
+@end multitable
-et de nombreuses autres.
-@item \fontseries@{série@}
-@findex \fontseries
-Sélectionnez série de police. Les séries valides sont :
+@cindex graisses de police
+Les valeurs possibles de graisses, considérées individuellement, sont :
+
+@multitable {xx} {Demi-gras (Medium, normal)xx}
+@item @code{ul}
+@tab Ultra maigre
+@item @code{el}
+@tab Extra maigre
+@item @code{l}
+@tab Maigre (@b{L}ight)
+@item @code{sl}
+@tab Semi maigre
+@item @code{m}
+@tab Demi-gras (@b{M}edium, normal)
+@item @code{sb}
+@tab Semi gras
+@item @code{b}
+@tab Gras (@b{B}old)
+@item @code{eb}
+@tab Extra gras
+@item @code{ub}
+@tab Ultra gras
+@end multitable
-@itemize @bullet
-@item @code{m} Moyen (normal)
-@item @code{b} Gras
-@item @code{c} condensé
-@item @code{bc} condensé Gras
-@item @code{bx} Gras étendu
-@end itemize
+
+@cindex Largeurs de police
+La valeurs possibles de largeur, considérées individuellement sont :
+
+@multitable {xx} {Extra contendéxx}
+@item @code{uc}
+@tab Ultra condensé
+@item @code{ec}
+@tab Extra condensé
+@item @code{c}
+@tab Condensé
+@item @code{sc}
+@tab Semi condensé
+@item @code{m}
+@tab Moyen
+@item @code{sx}
+@tab Semi étendu
+@item @code{x}
+@tab étendu
+@item @code{ex}
+@tab Extra étendu
+@item @code{ux}
+@tab Ultra étendu
+@end multitable
-et diverses autres combinaisons.
+Quand Lorsqu'on forme la chaîne de caractères @var{série} à partir de la
+graisse et de la largeur, on laisse tomber le @code{m} qui signifie
+medium concernant la graisse ou la largeur, auquel cas on en utilise
+juste un (@samp{@code{m}}).
-@item \fontshape@{forme@}
+@item \fontshape@{@var{allure}@}
@findex \fontshape
-Sélectionnez l'allure de police. Les allures valides sont :
-
-@itemize @bullet
-@item @code{n} Droit (normal)
-@item @code{it} Italique
-@item @code{sl} Incliné (oblique)
-@item @code{sc} Petites capitales
-@item @code{ui} Italique droit
-@item @code{ol} Plan
-@end itemize
+@cindex allure de police
+Sélectionne l'allure de police. Les allures valides sont :
+
+@multitable {xx} {Incliné (oblique)xx}
+@item @code{n}
+@tab Droit (normal)
+@item @code{it}
+@tab Italique
+@item @code{sl}
+@tab Incliné (oblique)
+@item @code{sc}
+@tab Petites capitales
+@item @code{ui}
+@tab Italique droit
+@item @code{ol}
+@tab Plan
+@end multitable
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.
-@item \fontsize@{taille@}@{interligne@}
+@item \fontsize@{@var{taille}@}@{@var{interligne}@}
@findex \fontsize
@findex \baselineskip
-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'espacement d'interligne ; ceci
-est stocké dans un paramètre nommé @code{\baselineskip}. L'unité des
-deux paramètres est par défaut le @code{pt}. La valeur par défaut de
-@code{\baselineskip} pour la police Computer Modern est 1,2 fois le
-@code{\fontsize}.
-
+Réglage de la taille de police et de l'espacement d'interligne. L'unité
+des deux paramètres est par défaut le point (@code{pt}). L'espaceement
+d'interligne est l'espace vertiical nominal entre ligne, de ligne de
+base à ligne de base. Il est stocké dans le paramètre
+@code{\baselineskip}. La valeur par défaut de @code{\baselineskip} pour
+la police Computer Modern est 1,2 fois le @code{\fontsize}. Changer
+directement @code{\baselineskip} est déconseillé dans la mesuure où sa
+valeur est réinitialisée à chaque fois qu'un changement de taille se
+produit ; voir ensuite @code{\baselinestretch}.
+
+@item \baselinestretch
@findex \baselinestretch
+L'espacement des lignes est également multiplié par la valeur du
+paramètre @code{\baselinestretch} ; la valeur par défaut est 1. Tout
+changement prend effet losque @code{\selectfont} (voir plus bas) est
+appelé. Vous pouvez modifier l'interligne pour tout le document en
+faisant, par ex.@: pour le doubler,
+@code{\renewcommand@{\baselinestretch@}@{2.0@}} dans le préambule,
+
@PkgIndex{setspace}
@cindex interligne double
+Cependant, la meilleure façon de mettre un document en « espacement
+double » est d'utiliser le paquetage @code{setspace}. En plus de
+proposer une pluralité d'options d'espacement, ce paquetage conserve un
+interligne simple là où c'est typiquement désirable, comme dans les
+notes de bas de page et dans les légendes de figure. Voir la
+documentation du paquetage.
-L'espacement des lignes est également multiplié par la valeur du
-paramètre @code{\baselinestretch} en cas de changement de taille de
-type ;@c 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 ``espacement double'', si vous avez la malchance d'avoir
-à produire une telle chose, est d'utiliser le paquetage
-@code{setspace} ; voir
-@url{http://www.tex.ac.uk/cgi-bin/texfaq2html?label=linespace}.
-
-@findex \linespread
@item \linespread@{@var{facteur}@}
+@findex \linespread
Est équivalent à
@code{\renewcommand@{\baselinestretch@}@{@var{facteur}@}}, et doit donc
être suivie par @code{\selectfont} pour avoir un effet. Il vaut mieux
que ce soit dans le préambule, ou utiliser le paquetage @code{setspace},
-comme décrit juste au-dessus.
+comme on vient de le décrire.
+@item \selectfont
@findex \selectfont
Les modifications apportées en appelant les commandes de polices
décrites ci-dessus n'entrent en vigueur qu'après que @code{\selectfont}
-est appelé.
+est appelé, comme dans
+@code{\fontfamily@{@var{nomfamille}@}\selectfont}. La plupart du temps
+il est plus pratique de mettre cela dans une macro :
+@code{\newcommand*@{\mapolice@}@{\fontfamily@{@var{nomfamille}@}\selectfont@}}@*
+(@pxref{\newcommand & \renewcommand}).
+
-@item \usefont@{codage@}@{famille@}@{série@}@{forme@}
+@item \usefont@{@var{codage}@}@{@var{famille}@}@{@var{série}@}@{@var{allure}@}
@findex \usefont
Revient à la même chose que d'invoquer @code{\fontencoding},
@code{\fontfamily}, @code{\fontseries} et @code{\fontshape} avec les
-paramètres donnés, suivi par @code{\selectfont}.
+paramètres donnés, suivi par @code{\selectfont}. Par exemple :
+
+@example
+\usefont@{ot1@}@{cmr@}@{m@}@{n@}
+@end example
@end table
@@ -2119,7 +2012,7 @@ paramètres donnés, suivi par @code{\selectfont}.
@chapter Mise en page
@cindex commandes de mise en page
-Diverses commandes pour contrôler la disposition générale de la page.
+Commandes pour contrôler la disposition générale de la page.
@menu
* \onecolumn :: Utiliser la disposition à une colonne.
@@ -2509,125 +2402,1121 @@ infuence the position of float environments like figure and table in
@LaTeX{}? » (@url{http://latex-project.org/papers/tb111mitt-float.pdf}).
@node Sectioning
-@chapter Des rubriques
+@chapter Rubricage
+
+@cindex rubricage, commandes
+@cindex commandes de rubricage,
+@cindex @code{part}
+@cindex partie
+@cindex @code{chapter}
+@cindex chapitre
+@cindex section
+@cindex @code{subsection}
+@cindex sous-section
+@cindex @code{subsubsection}
+@cindex sous-sous-section
+@cindex @code{paragraph}
+@cindex paragraphe
+@cindex @code{subparagraph}
+@cindex sous-paragraphe
+@findex \part
+@findex \chapter
+@findex \section
+@findex \subsection
+@findex \subsubsection
+@findex \paragraph
+@findex \subparagraph
+
+Structure votre texte en rubriques : parties, chapitres, sections,
+etc. Toutes les commandes de rubricage ont la même forme, l'une parmi :
+
+@example
+@var{cmd-de-rubricage}@{@var{titre}@}
+@var{cmd-de-rubricage}*@{@var{titre}@}
+@var{cmd-de-rubricage}[@var{titre-tdm}]@{@var{titre}@}
+@end example
-@cindex rubricage
+@noindent
+Par exemple, déclarez le début d'une sous-section comme dans
+@code{\subsection@{Motivation@}}.
+
+Le tableau suivant comprend chacune des commandes @var{cmd-de-rubricage}
+de @LaTeX{}. Toutes sont disponibles dans toutes les classes de
+document standardes de @LaTeX{} @code{book}, @code{report},
+et @code{article}, à ceci près que @code{\chapter} n'est pas disponible
+dans @code{article}.
+
+@multitable @columnfractions .25 .25 .40
+@headitem Type de rubrique @tab Commande @tab Niveau
+@item Part
+@tab @code{\part} @tab -1 (@code{book}, @code{report}), 0 (@code{article})
+@item Chapter
+@tab @code{\chapter} @tab 0
+@item Section
+@tab @code{\section} @tab 1
+@item Subsection
+@tab @code{\subsection} @tab 2
+@item Subsubsection
+@tab @code{\subsubsection} @tab 3
+@item Paragraph
+@tab @code{\paragraph} @tab 4
+@item Subparagraph
+@tab @code{\subparagraph} @tab 5
+@end multitable
-Les commandes de rubricage fournissent les moyens de structurer
-votre texte en unités sectionnelles, ou rubriques :
+
+@cindex @code{*}, forme en @code{*} des commandes de rubricage
+@cindex étoilée, forme des commandes de rubricage
+@cindex forme étoilée de commandes de rubricage
+@cindex forme en * de commandes de rubricage
+Toutes ces commandes ont une forme en @code{*}, aussi appelée étoilée,
+qui imprime @var{titre} comme d'habitude mais sans le numéroter et sans
+fabriquer une entrée dans la table des matières. Un exemple
+d'utilisation est pour un appendice dans un @code{article}. Entrer le
+code @code{\appendix\section@{Appendice@}} donne en sortie @samp{A
+Appendix} (@pxref{\appendix}). Vous pouvez ôter le numéro @samp{A} en
+entrant à la place @code{\section*@{Appendice@}} (les articles omettent
+couramment d'avoir une table des matières et ont des en-têtes de pages
+simples alors les autres différences de la commande @code{\section}
+peuvent être négligées).
+
+Le titre @var{titre} 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 (@pxref{Page styles}). Vous pourriez
+désirer un texte différent à ces endroits que dans le texte principal.
+Toute ces commandes ont un argument optionnel @var{tdm-titre} destiné à
+ces autres endroits.
+
+Le numéro dans la colonne @guillemetleft{}Niveau@guillemetright{} de la
+table ci-dessus détermine quelles rubriques sont numérotées, et
+lesquelles apparaissent dans la table des matières. Si le @var{niveau}
+de la commande de rubricage est inférieur ou égal à la valeur du
+compteur @code{secnumdepth} alors les rubriques correspondant à ces
+commandes de rubricage sont numérotées (@pxref{Sectioning/secnumdepth}).
+Et, si @var{niveau} est inférieur ou égal à la valeur du compteur
+@code{tocdepth} alors la table des matières comprend une entrée pour
+cette rubrique (@pxref{Sectioning/tocdepth}).
+
+@LaTeX{} s'attend que avant d'avoir une @code{\subsection} vous ayez une
+ @code{\section} et, dans un document de classe @code{book}, qu'avant
+ une @code{\section} vous ayez un @code{\chapter}. Autrement vous
+ pourriez obtenir quelque-chose comme une sous-sesction numérotée
+ @samp{3.0.1}.
+
+@PkgIndex{titlesec}
+@LaTeX{} vous permet de changer l'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
+@code{\renewcommand\thesection@{\Alph@{section@}@}} dans le préambule
+(@pxref{\alph \Alph \arabic \roman \Roman \fnsymbol}). Le CTAN a
+beaucoup de paquetages rendant ce genre d'ajustement plus facile,
+notamment @file{titlesec}.
+
+Deux compteurs sont en relation avec l'apparence des rubriques fabriquées
+par les commandes de rubricage.
@ftable @code
-@item \part
-@item \chapter (seulement pour classes @code{report} et @code{book})
-@item \section
-@item \paragraph
-@item \subsubsection
-@item \paragraph
-@item \alinea
+@item secnumdepth
+@findex secnumdepth @r{compteur}
+@cindex numéros de rubrique, composition
+@anchor{sectioning secnumdepth}
+@anchor{Sectioning/secnumdepth}
+Le compteur @code{secnumdepth} contrôle quels titres de rubriques sont
+numérotés. Régler le compteur avec
+@code{\setcounter@{secnumdepth@}@{@var{niveau}@}} supprime la
+numérotation des rubriques à toute profondeur supérieure à @var{niveau}
+(@xref{\setcounter}). Voir la table plus haut pour la valeur des
+niveaux. Par exemple, si le @code{secnumdepth} vaut 1 dans un
+@code{article} alors la commande @code{\section@{Introduction@}} produit
+en sortie quelque-chose comme @samp{1 Introduction} alors que
+@code{\subsection@{Discussion@}} produit quelque-chose comme
+@samp{Discussion}, sans numéro. La valeur par défaut de @LaTeX{} pour
+@code{secnumdepth} vaut 3 dans la classe @file{article} et 2 dans les
+classes @file{book} et @file{report}.
+
+@item tocdepth
+@findex tocdepth @r{counter}
+@cindex table des matières, impression des numéros de rubrique
+@anchor{sectioning tocdepth}
+@anchor{Sectioning/tocdepth}
+Contrôle quelles rubriques sont listées dans la table des matières.
+Régler @code{\setcounter@{tocdepth@}@{@var{niveau}@}} a pour effet que
+les rubriques au niveau @var{niveau} sont celles de plus petit niveau à
+être listées (@pxref{\setcounter}). Voir la table ci-dessus pour les
+numéros de niveau. Par exemple, if @code{tocdepth} vaut 1 alors la table
+des matières contiendra les rubriques issues de @code{\section}, mais pas
+celles de @code{\subsection}. La valeur par défaut de @LaTeX{} pour
+@code{tocdepth} vaut 3 dans la classe @file{article} et 2 dans les
+classes @file{book} et @file{report}.
@end ftable
-Toutes les commandes ont la même forme générale, par exemple,
+
+@menu
+* \part:: Commence une partie.
+* \chapter:: Commence un chapitre.
+* \section:: Commence une section.
+* \subsection:: Commence une sous-ection.
+* \subsubsection & \paragraph & \subparagraph:: Subdivisions inférieures.
+* \appendix:: Commence un appendice.
+* \frontmatter & \mainmatter & \backmatter:: Les trois parties d'un livre.
+* \@@startsection:: Composer les rubriques.
+@end menu
+
+
+@node \part
+@section @code{\part}
+
+@findex \part
+@cindex part
+@cindex rubricage, part
+
+Synopsis, l'un parmi :
@example
-\chapter[@var{titretdm}]@{@var{titre}@}
+\part@{@var{titre}@}
+\part*@{@var{titre}@}
+\part[@var{tdm-titre}]@{@var{titre}@}
@end example
-En plus de fournir le titre de rubrique @var{titre} dans le texte
-principal, le titre peut apparaître dans deux autres endroits :
+Début une partie de document. Les classes standarde @LaTeX{}
+@code{book}, @code{report}, et @code{article} offrent toutes cette
+commande.
-@enumerate
-@item
-La table des matières.
-@item
-L'en-tête en cours de traitement en haut de la page.
-@end enumerate
+L'exemple suivant produit une partie de document dans un livre :
-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 @var{titretdm} qui, lorsqu'il est fourni, précise
-le texte de ces autres endroits.
+@c xxx à traduire
+@example
+\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.
+@end example
-@cindex forme étoilée de commandes de rubricage
-@cindex forme en * de commandes de rubricage
-En outre, toutes les commandes de rubricage ont des formes en
-@code{*}, aussi appelée étoilée, qui compose @var{titre} comme
-d'habitude, mais ne comprennent pas de numéro et ne produisent pas
-d'entrée dans la table des matières. Par exemple :
+Dans chaque classe standarde la commande @code{\part} produit en sortie
+un numéro de partie tel que @samp{Première partie}, seul sur sa ligne,
+en caractère gras, et en gros caractères. Ensuite @LaTeX{} produit en
+sortie @var{titre}, également seule sur sa ligne, en caractère gras et
+en caractères encore plus gros.
+Dans la classe @code{book}, 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
+@code{report} il est également seul sur une page, mais @LaTeX{} ne force
+pas qu'elle soit de numéro impair. Dans un @code{article} @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.
+
+La forme en @code{*} imprime @var{titre} mais n'imprime pas le numéro de
+partie, et n'incrémente pas le compteur @code{part}, et ne produit
+aucune entrée dans la table des matières.
+
+L'argument optionnel @var{tdm-titre} apparaît comme le titre de la
+partie dans la table des matières (@pxref{Table of contents etc.}) et
+dans les hauts de pages (@pxref{Page styles}). S'il n'est pas présent
+alors @var{titre} est utilisé à sa place. Dans l'exemple suivante on met
+un saut de ligne dans @var{titre} mais on l'enlève dans la table des
+matière.
+
+@example
+\part[Up from the bottom; my life]@{Up from the bottom\\ my life@}
+@end example
+
+Pour déterminer quelles rubrique sont numéroté et lesquelles
+apparaissent dans la table des matières, le numéro de niveau d'une
+partie vaut -1 (@pxref{Sectioning/secnumdepth} et
+@pxref{Sectioning/tocdepth}).
+
+@PkgIndex{indentfirst}
+
+Dans la classe @code{article}, si un paragraphe suit immédiatement le
+titre de partie alors il n'est pas renfoncé. Pour obtenir un
+renfoncement vous pouvez utiliser le paquetage @file{indentfirst}.
+
+@PkgIndex{titlesec}
+Un paquetage pour changer le comportement de @code{\part} est
+@file{titlesec}. Voir sa documentation sur le CTAN.
+
+
+@node \chapter
+@section @code{\chapter}
+
+@findex \chapter
+@cindex chapitre
+
+Synopsis, l'un parmi :
+
+@example
+\chapter@{@var{titre}@}
+\chapter*@{@var{titre}@}
+\chapter[@var{tdm-titre}]@{@var{titre}@}
+@end example
+
+Commence un chapitre. Les classes standardes @LaTeX{} @code{book} et
+@code{report} ont cette commande, mais @code{article} non.
+
+L'exemple suivant produit un chapitre.
+
+@example
+\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.
+@end example
+
+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 @samp{Chapitre 1}
+en gros caractère gras (la taille est @code{\huge}). Ensuite il place le
+@var{titre} sur une nouvelle ligne, en caractère gras encore plus gros
+(taille @code{\Huge}). Il incrémente également le compteur
+@code{chapter}, ajoute une entrée à la table des matières (@pxref{Table
+of contents etc.}), et règle l'information de haut de page (@pxref{Page
+styles}).
+
+La forme étoilée, ou forme en @code{*}, affiche @var{titre} sur une
+nouvelle ligne, en caractère gras. Mais elle n'affiche pas le numéro de
+chapitre, ni n'incrément le compteur @code{chapter}, et ne produit
+aucune entrée dans la table des matières, et n'affecte pas le haut de
+page. (Si vous utilise le style de page @code{headings} dans un
+document recto-version alors le haut de page sera dérivé du chapitre
+précédent). Voici un exemple illustrant cela :
+
+@example
+\chapter*@{Préambule@}
+@end example
+
+L'argument optionnel @var{tdm-titre} apparaît comme titre de chapitre
+dans la tabvle des matières (@pxref{Table of contents etc.}) et dans les
+hauts de page (@pxref{Page styles}). Si il n'est pas présent alors
+@var{titre} sera à la place. L'exemple suivant montre le nom complet
+dans le titre de chapitre,
+
+@example
+\chapter[Weyl]@{Hermann Klaus Hugo (Peter) Weyl (1885--1955)@}
+@end example
+
+@noindent
+mais seulement @samp{Weyl} sur la page de table des matières. L'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
+
+@example
+\chapter[J'ai tout donné ; mon histoire]@{J'ai tout donné\\ mon histoire@}
+@end example
+
+Pour déterminer quelles rubriques sont numérotées et lesquelles
+apparaissent dans la table des matières, le numéro de niveau d'un
+chapitre est 0 (@pxref{Sectioning/secnumdepth} et
+@pxref{Sectioning/tocdepth}).
+
+@PkgIndex{indentfirst}
+@c French version only
+Lorsque chargez un paquetage d'internationalisation tel que
+@file{babel}, @file{mlp} ou @file{polyglossia}, et que la langue
+sélectionnée est le français, alors le premier paragraphe après le titre
+est normalement renfoncé, comme c'est la convention en typographie
+française. Par contre, si vous restez en langue par défaut,
+c-à-d.@: en anglo-américain,
+@c End French version only
+le paragraphe qui suit le titre de chapitre n'est pas renfoncé, étant donné que c'est
+@c French version only
+pour l'anglo-américain
+@c End French version only
+une pratique typographique standarde. Pour obtenir un renfoncement
+@c French version only
+dans ce cas
+@c End French version only
+utilisez le paquetage @file{indentfirst}.
+
+Vous pouvez changer ce qui est affiché pour le numéro de chapitre. Pour
+le changer en quelque-chose du genre de @samp{Cours 1}, placez dans le
+préambule soit @code{\renewcommand@{\chaptername@}@{Cours@}}, soit
+cela (@pxref{\makeatletter & \makeatother}) :
+
+@example
+\makeatletter
+\renewcommand@{\@@chapapp@}@{Cours@}
+\makeatother
+@end example
+
+@PkgIndex{babel}
+@noindent Pour que cela soit fonction de la langue principale du document, voir le paquetage @file{babel}.
+
+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'exception d'un éventuel haut de page. Pour que cette
+page soit complètement blanche, voir @ref{\clearpage &
+\cleardoublepage}.
+
+@PkgIndex{titlesec}
+Pour changer le comportement de la commande @code{\chapter}, 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'un d'eux est @file{titlesec}. Voir sa
+documentation, mais l'exemple ci-dessous donne un aperçu de ce qu'il
+peut faire.
+
+@example
+\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
+@end example
+
+@noindent
+Ceci omet le numéro de chapitre @samp{Chapitre 1} de la page, mais
+contrairement à @code{\chapter*} cela conserve le chapitre dans la table
+des matière et dans les hauts de page.
+
+
+@node \section
+@section @code{\section}
+
+@findex \section
+@cindex section
+
+Synopsis, l'un parmi :
+
+@example
+\section@{@var{titre}@}
+\section*@{@var{titre}@}
+\section[@var{tdm-titre}]@{@var{titre}@}
+@end example
+
+Commence une section. Les classes @LaTeX{} standardes @code{article},
+@code{book}, et @code{report} ont toutes cette commande.
+
+L'exemple suivant produit une section :
+
+@example
+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.
+@end example
+
+Pour les classes standardes @LaTeX{} @code{book} et @code{report} la
+sortie par défaut est du genre de @samp{1.2 @var{titre}} (pour
+chapitre 1, section 2), seul sur sa ligne et fer à gauche, en caractères
+gras et plus gros (la taille de police est @code{\Large}). La même
+chose vaut pour @code{article} à ceci près qu'il n'y a pas de chapitre
+dans cette classe, et donc cela ressemble à @samp{2 @var{titre}}.
+
+La forme en @code{*} affiche @var{titre}. Mais elle n'affiche pas le
+numéro de section, ni n'incrémente le compteur @code{section}, ne
+produit aucune entrée dans la table des matière, et n'affecte pas le
+haut de page. (Si vous utilisez le style de page @code{headings} dans
+un document recto-verso, alors le titre de haut de page sera celui de la
+rubrique précédente).
+
+L'argument optionnel @var{tdm-titre} apparaît comme titre de section
+dans la table des matières (@pxref{Table of contents etc.}) et dans les
+titres de haut de page (@pxref{Page styles}). S'il n'est pas présent
+alors @var{titre} est à la place. L'exemple suivant montre le nom
+complet dans le titre de la section,
+
+@example
+\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.@}
+@end example
+
+@noindent
+mais seulement @samp{Elisabeth II} dans la table de matière et sur les
+hauts de page. Dans l'exemple suivant il y a un saut de ligne dans
+@var{titre} 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.
+
+@example
+\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@}
+@end example
+
+Pour déterminer quelles rubriques sont numérotées et lesquelles
+apparaissent dans la table des matières, le numéro de niveau d'une
+section est 1 (@pxref{Sectioning/secnumdepth} et
+@pxref{Sectioning/tocdepth}).
+
+@PkgIndex{indentfirst}
+@c French version only
+Lorsque chargez un paquetage d'internationalisation tel que
+@file{babel}, @file{mlp} ou @file{polyglossia}, et que la langue
+sélectionnée est le français, alors le premier paragraphe après le titre
+est normalement renfoncé, comme c'est la convention en typographie
+française. Par contre, si vous restez en langue par défaut,
+c-à-d.@: en anglo-américain,
+@c End French version only
+le paragraphe qui suit le titre de section n'est pas renfoncé, étant donné que c'est
+@c French version only
+pour l'anglo-américain
+@c End French version only
+une pratique typographique standarde. Pour obtenir un renfoncement
+@c French version only
+dans ce cas
+@c End French version only
+utilisez le paquetage @file{indentfirst}.
+
+@PkgIndex{titlesec}
+En général, pour changer le comportement de la commande @code{\section},
+il y a diverses options. L'une d'elles et la commande
+@code{\@@startsection} (@pxref{\@@startsection}). Il y a aussi un grand
+nombre de paquetages sur le CTAN traitant de cela, dont
+@file{titlesec}. Voir sa
+documentation, mais l'exemple ci-dessous donne un aperçu de ce qu'il
+peut faire.
+
+@c credit: egreg https://groups.google.com/forum/#!topic/comp.text.tex/tvc8oM5P4y4
+@example
+\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]
+@end example
+
+@noindent
+Cela met le numéro de section dans la marge.
+
+
+@node \subsection
+@section @code{\subsection}
+
+@findex \subsection
+@cindex subsection
+
+Synopsis, l'un parmi :
+
+@example
+\subsection@{@var{titre}@}
+\subsection*@{@var{titre}@}
+\subsection[@var{tdm-titre}]@{@var{titre}@}
+@end example
+
+Commence une sous-section. Les classes @LaTeX{} standardes @code{article},
+@code{book}, et @code{report} ont toutes cette commande.
+
+L'exemple suivant produit une sous-section :
+
+@example
+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.
+@end example
+
+Pour les classes @LaTeX{} standardes @code{book} et @code{report} la
+sortie par défaut est du genre de @samp{1.2.3 @var{titre}} (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
+@code{\large}). La même chose vaut dans @code{article} à ceci près
+qu'il n'y a pas de chapitre dans cette classe, alors cela ressemble à
+@samp{2.3 @var{titre}}.
+
+La forme en @code{*} affiche @var{titre}. Mais elle n'affiche pas le
+numéro de sous-section, ni n'incrémente le compteur @code{subsection},
+et ne produit aucune entrée dans la table des matières.
+
+@c continuer la trad.
+L'argument optionnel @var{tdm-titre} apparaît comme le titre de
+sous-section dans la table des matières (@pxref{Table of contents
+etc.}). S'il n'est pas présent alors @var{titre} est à la place.
+L'exemple suivant montre le texte complet dans le titre de sous-section,
+
+@example
+\subsection[$\alpha,\beta,\gamma$ paper]@{\textit@{The Origin of
+ Chemical Elements@} by R.A.~Alpher, H.~Bethe, and G.~Gamow@}
+@end example
+
+@noindent
+mais seulement @samp{@BES{03B1,\alpha},@BES{03B2,\beta},@BES{03B3,\gamma}
+paper} dans la table des matières.
+
+Pour déterminer quelles rubriques sont numérotées et lesquelles
+apparaissent dans la table des matières, le numéro de niveau d'une
+sous-section est 2 (@pxref{Sectioning/secnumdepth} et
+@pxref{Sectioning/tocdepth}).
+
+@PkgIndex{indentfirst}
+@c French version only
+Lorsque chargez un paquetage d'internationalisation tel que
+@file{babel}, @file{mlp} ou @file{polyglossia}, et que la langue
+sélectionnée est le français, alors le premier paragraphe après le titre
+est normalement renfoncé, comme c'est la convention en typographie
+française. Par contre, si vous restez en langue par défaut,
+c-à-d.@: en anglo-américain,
+@c End French version only
+le paragraphe qui suit le titre de sous-section n'est pas renfoncé, étant donné que c'est
+@c French version only
+pour l'anglo-américain
+@c End French version only
+une pratique typographique standarde. Pour obtenir un renfoncement
+@c French version only
+dans ce cas
+@c End French version only
+utilisez le paquetage @file{indentfirst}.
+
+@PkgIndex{titlesec}
+@c
+Il y a diverses façon de changer le comportement de la commande
+@code{\subsection}. L'une d'elles et la commande @code{\@@startsection}
+(@pxref{\@@startsection}). Il y a aussi divers paquetages sur le CTAN
+traitant de cela, dont @file{titlesec}. Voir sa documentation, mais
+l'exemple ci-dessous donne un aperçu de ce qu'il peut faire.
+
+@example
+\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
+@end example
+
+@noindent
+Cela place le numéro de sous-section et @var{titre} sur la première
+ligne de texte.
+
+
+@node \subsubsection & \paragraph & \subparagraph
+@section @code{\subsubsection}, @code{\paragraph}, @code{\subparagraph}
+
+@findex \subsubsection
+@cindex subsubsection
+@findex \paragraph
+@cindex paragraph
+@findex \subparagraph
+@cindex subparagraph
+
+Synopsis, l'un parmi les suivant :
+
+@example
+\subsubsection@{@var{titre}@}
+\subsubsection*@{@var{titre}@}
+\subsubsection[@var{titre-tdm}]@{@var{titre}@}
+@end example
+
+@noindent
+ou l'un parmi :
@example
-\section*@{Préambule@}
+\paragraph@{@var{titre}@}
+\paragraph*@{@var{titre}@}
+\paragraph[@var{titre-tdm}]@{@var{titre}@}
@end example
+@noindent
+ou l'un parmi :
+
+@example
+\subparagraph@{@var{titre}@}
+\subparagraph*@{@var{titre}@}
+\subparagraph[@var{titre-tdm}]@{@var{titre}@}
+@end example
+
+Débute une rubrique de type sous-sous-section, paragraphe, ou
+sous-paragraphe. Les classes @LaTeX{} standardes @code{article},
+@code{book}, et @code{report} disposent toutes de ces commandes, bien
+que leur utilisation n'est pas courante.
+
+L'exemple suivant produit une sous-sous-section :
+
+@c xxx À traduire
+@example
+\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.
+@end example
+
+La sortie produite par défaut de chacune de ces trois commande est la
+même pour les classes @LaTeX{} standarde @code{article}, @code{book}, et
+@code{report}. Pour @code{\subsubsection} le @var{titre} est seul sur
+sa ligne, en caractères gras avec la taille normale de police. Pour
+@code{\paragraph} le @var{titre} est sur la même ligne que le texte qui
+suit, sans renfoncement, en caractères gras avec la taille normale de
+police. Pour @code{\subparagraph} le @var{titre} 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
+@code{article} n'ont pas de chapitre, leurs sous-sous-sections sont
+numérotées et donc cela ressemble à @samp{1.2.3 @var{titre}}, pour
+section 1, sous-section 2, et sous-sous-section 3. Les deux autres
+subdivisions ne sont pas numérotées).
+
+La forme en @code{*} affiche @var{titre}. Mais elle n'incrémente pas le
+compteur associé et ne produit pas d'entrée dans la table des matières
+(et le titre produit pas @code{\subsubsection} n'a pas de numéro).
+
+L'argument optionnel @var{titre-tdm} apparaît comme le titre de la
+rubrique dans la table des matières (@pxref{Table of contents etc.}).
+S'il est omis, alors @var{titre} est utilisé à la place.
+
+Pour déterminer quelles rubriques sont numérotées et lesquelles
+apparaissent dans la table des matières, le numéro de nuveau d'une
+sous-sous-section est 3, celui d'un paragraphe est 4, et celui d'un
+sous-paragraphe est 5 (@pxref{Sectioning/secnumdepth} et
+@pxref{Sectioning/tocdepth}).
+
+@PkgIndex{indentfirst}
+@c French version only
+Lorsque chargez un paquetage d'internationalisation tel que
+@file{babel}, @file{mlp} ou @file{polyglossia}, et que la langue
+sélectionnée est le français, alors le premier paragraphe après le titre
+est normalement renfoncé, comme c'est la convention en typographie
+française. Par contre, si vous restez en langue par défaut,
+c-à-d.@: en anglo-américain,
+@c End French version only
+le paragraphe qui suit le titre de chapitre n'est pas renfoncé, étant donné que c'est
+@c French version only
+pour l'anglo-américain
+@c End French version only
+une pratique typographique standarde. Une façon d'obtenir un renfoncement
+@c French version only
+dans ce cas
+@c End French version only
+est d'utiliser le paquetage @file{indentfirst}.
+
+@PkgIndex{titlesec}
+Il y a de nombreuses manières de changer le comportement de ces
+commandes. L'une est la commande @code{\@@startsection}
+(@pxref{\@@startsection}). Il y a aussi un grand nombre de paquetages
+sur le CTAN traitant de cela, dont @file{titlesec}. Voir sa
+documentation sur le CTAN.
+
+@node \appendix
+
+@section @code{\appendix}
+
@findex \appendix
-@cindex annexe, création
-La commande @code{\appendix} modifie la façon dont les unités
-sectionnelles suivantes sont numérotées. La commande @code{\appendix}
-elle-même ne génère aucun texte et n'affecte pas la numérotation des
-parties. L'utilisation normale de cette commande est quelque chose comme
-cela :
+@cindex appendix
+@cindex appendices
+
+Synopsis :
@example
-\chapter@{Un chapitre@}
-@dots{}
\appendix
-\chapter@{La première annexe @}
@end example
-@findex secnumdepth @r{counter}
-@cindex numéros de rubrique, composition
-@anchor{Sectioning/secnumdepth}
-Le compteur @code{secnumdepth} contrôle la composition des numéros de
-rubrique. le paramètre
+Ne produit pas directement quelque chose en sortie. Mais dans un
+document @code{book} ou @code{report} cela déclare que toute commande
+@code{\chapter} qui suit commence une annexe. Pour les documents
+@code{article} cela fait la même chose mais avec les commandes
+@code{\section}. Remet également à zéro les compteurs @code{chapter} et
+@code{section} dans un document @code{book} ou @code{report}, et dans un
+@code{article} les compteurs @code{section} et @code{subsection}.
+
+Dans ce document de classe @code{book} :
@example
-\setcounter@{secnumdepth@}@{@var{niveau}@}
+\chapter@{Un@} ...
+\chapter@{Deux@} ...
+ ...
+\appendix
+\chapter@{Trois@} ...
+\chapter@{Quatre@} ...
@end example
@noindent
-supprime le numéros de rubrique à n'importe quelle profondeur @math{> @var{niveau}}, où
-@code{chapter} est le niveau zéro. (@xref{\setcounter}.)
+les deux premières commandes produisent en sortie @samp{Chapitre 1} and
+@samp{Chapitre 2}. Après la commande @code{\appendix} la numérotation devient
+@samp{Annexe A} et @samp{Annexe B}. @xref{Larger book template}
+pour un autre exemple.
+
+@PkgIndex{appendix}
+Le paquetage @file{appendix} ajoute la commande @code{\appendixpage}
+pour créer une page de titre de partie intitulée @samp{Appendices} dans
+le corps du document avant la première annexe, ainsi que la
+commande @code{\addappheadtotoc} pour créer l'entrée correspondante dans
+la table des matières. On peut régler le nom @samp{Appendices} avec une
+commande comme @code{\renewcommand@{\appendixname@}@{Annexes@}}, et il y
+a plusieurs autres fonctions. Voir la documentation sur le CTAN.
+
+@node \frontmatter & \mainmatter & \backmatter
+@section @code{\frontmatter}, @code{\mainmatter}, @code{\backmatter}
+
+@findex \frontmatter
+@cindex book, pièces préliminaires
+@cindex livre, pièces préliminaires
+@findex \mainmatter
+@cindex book, pièces principales
+@cindex livre, pièces principales
+@findex \backmatter
+@cindex book, pièces postliminaires
+@cindex book, annexes
+@cindex livre, pièces postliminaires
+@cindex livre, annexes
+
+Synopsis, l'un parmi :
+
+@example
+\frontmatter
+\mainmatter
+\backmatter
+@end example
+
+Formate un document de classe @code{book} différemment selon la partie
+du document en cours de production. Les trois commandes sont toutes
+optionnelles.
+
+Traditionnellement, les pièces préliminaires (@code{\frontmatter}) d'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 (@code{\backmatter}) peuvent
+contenir des choses telles qu'un glossaire, une bibliographie, et un
+index.
+
+La déclaration @code{\frontmatter} 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'autres commandes de rubricage, alors utilisez
+la version en @code{*} (@pxref{Sectioning}). La commande
+@code{\mainmatter} permet de revenir au comportement attendu, et
+réinitialise le numéro de page. La commande @code{\backmatter}
+n'affecte pas la numérotation des pages, mais commute de nouveau les
+chapitres en mode sans numéros. @xref{Larger book template} pour un
+exemple d'usage des trois commandes.
+
+
+@node \@@startsection
+@section @code{\@@startsection}, composer les rubriques.
+
+@findex \@@startsection
+@cindex section, redéfinir
+
+Synopsis :
+
+@example
+\@@startsection@{@var{nom}@}@{@var{niveau}@}@{@var{retrait}@}@{@var{avant}@}@{@var{après}@}@{@var{style}@}
+@end example
+
+Utilisé pour aider à redéfinir le comportement des commandes de
+rubricage telles que @code{\section} ou @code{\subsection}.
+
+Notez que le paquetage @file{titlesec} rend la manipulation du rubricage
+plus facile. De plus, bien que la plupart des exigences concernant les
+commandes de rubricage peuvent être remplies avec
+@code{\@@startsection}, ce n'est pas le cas de certaines d'entre elles. Par exemple,
+dans les classes @LaTeX{} standardes @code{book} et @code{report}, les
+commandes @code{\chapter} et @code{\report} ne sont pas construites de
+cette manière. Pour fabriquer une telle commande, il est possible
+d'utiliser la commande @code{\secdef}.
+@c xx define, and make a cross reference to, secdef.
+
+Techniquement, cette commande a la forme suivante :
+@example
+\@@startsection@{@var{nom}@}
+ @{@var{niveau}@}
+ @{@var{retrait}@}
+ @{@var{avant}@}
+ @{@var{après}@}
+ @{@var{style}@}*[@var{titretdm}]@{@var{titre}@}
+@end example
+@noindent de sorte que faire :
+@example
+\renewcommand@{\section@}@{\@@startsection@{@var{nom}@}
+ @{@var{niveau}@}
+ @{@var{retrait}@}
+ @{@var{avant}@}
+ @{@var{après}@}
+ @{@var{style}@}@}
+@end example
+@noindent redéfinit @code{\section} en gardant sa forme standarde d'appel
+@code{\section*[@var{titretdm}]@{@var{titre}@}} (dans laquelle on
+rappelle que l'étoile @code{*} est optionnelle).
+@xref{Sectioning}. Ceci implique que quand vous écrivez une commande
+comme @code{\renewcommand@{\section@}@{...@}}, le
+@code{\@@startsection@{...@}} doit venir en dernier dans la définition.
+Voir les exemples ci-dessous.
+
+@table @var
+
+@item nom
+@anchor{startsection name}
+@anchor{\@@startsection/name}
+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 @code{section}, @code{subsection}, ou
+@code{paragraph}. 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'est
+pas obligatoire.
+
+Alors @code{\the}@var{name} affiche le numéro de titre, et
+@code{\}@var{name}@code{mark} sert aux en-têtes de page. Voir le
+troisième exemple plus bas.
+
+@item niveau
+@anchor{startsection level}
+@anchor{\@@startsection/level}
+Entier donnant la profondeur de la commande de
+rubricage. @xref{Sectioning} pour une liste des numéros standards de
+niveaux.
+
+Si @var{niveau} est inférieur ou égal à la valeur du compteur
+@code{secnumdepth}, alors les titres pour cette commande de rubricage
+sont numérotés (@pxref{Sectioning/secnumdepth}). Par exemple : dans un
+@code{article}, si @code{secnumdepth} vaut 1, alors une commande
+@code{\section@{Introduction@}} produira en sortie une chaîne du type
+« @code{1 Introduction} », alors que @code{\subsection@{Historique@}}
+produira en sortie une chaîne sans numéro de préfixe :
+« @code{Historique} ».
+
+Si @var{niveau} est inférieur ou égal à la valeur du compteur
+@code{tocdepth}, alors la table des matières aura un article pour cette
+rubrique. Par exemple, dans un @code{article}, si @code{tocdepth} vaut
+1, la table des matières listera les @code{section}s, mais pas les
+@code{subsection}s.
+
+@item retrait
+@anchor{startsection indent}
+@anchor{\@@startsection/indent}
+
+Une longueur donnant le renfoncement de toutes les lignes du titre par
+rapport à la marge de gauche. Pour un renfoncement nul, utilisez @code{0pt}.
+@c xx à insérer :
+@c vous pouvez utiliser la macro @code{\z@@} définie à @code{0pt} pour
+@c que le code soit plus efficace
+Une valeur négative telle que @code{-1em} cause un débord du titre dans
+la marge de gauche.
+
+@item avant
+@anchor{startsection beforeskip}
+@anchor{\@@startsection/beforeskip}
+Longueur dont la valeur absolue est la longueur de l'espace vertical
+inséré avant le titre de la rubrique. Cet espacement est ignoré si la
+rubrique commence au début d'une page. Si ce nombre est négatif, alors
+le premier paragraphe suivant le titre n'est pas renfoncé, s'il est
+positif ou nul il l'est. (Notez que l'opposé de @code{1pt plus 2pt minus
+3pt} est @code{-1pt plus -2pt minus -3pt}).
+
+Par exemple si @var{avant} vaut @code{-3.5ex plus -1ex minus -0.2ex}
+alors pour commencer la nouvelle rubrique, @LaTeX{} ajoute environ 3,5
+fois la hauteur d'une lettre x en espace vertical, et le premier
+paragraphe de la rubrique n'est pas renfoncé. Utiliser une longueur
+élastique, c.-à-d.@: comprenant @code{plus} et @code{minus}, est une
+bonne pratique ici car cela donne à @LaTeX{} plus de latitude lors de la
+fabrication de la page (@pxref{Lengths}).
+
+La quantité totale d'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 @code{\parskip} dans la police du corps de texte, du
+@code{\baselineskip} de la police du titre, et de la valeur absolue de
+l'argument @var{avant}. Cet espace est typiquement élastique de sorte à
+pouvoir se dilater ou se contracter. (Si la rubrique commence en début
+d'une page de sorte que cet espace soit ignoré, alors la ligne de base
+du titre correspond à la ligne de base qu'aurait la première ligne de
+texte sur cette page si celle-ci commençait par du texte).
+
+@item après
+@anchor{startsection afterskip}
+@anchor{\@@startsection/afterskip}
+Longueur. Lorsque @var{après} est positif ou nul, il s'agit de l'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'espace horizontal entre la fin du titre et le début du paragraphe
+suivant. (Notez que l'opposé de @code{1pt plus 2pt minus 3pt} est
+@code{-1pt plus -2pt minus -3pt}).
+
+Comme c'est le cas avec @var{avant}, utiliser une longueur élastique
+avec des composantes @code{plus} et @code{minus} est une bonne pratique
+ici puisque elle donne à @LaTeX{} plus de latitude pour assembler la
+page.
+
+Si @var{après} est positif ou nul, la quantité totale d'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 @code{\parskip} de
+la police du titre, de @code{\baselineskip} de la police du corps de
+texte, et de la valeur de @var{après}. Cet espace est typiquement
+élastique de sorte qu'il puisse se dilater ou se contracter. (Notez que,
+du fait que le signe d'@var{après} contrôle que le titre soit
+indépendant du texte qui le suit ou faisant corps avec lui, vous ne
+pouvez pas utiliser un @var{après} négatif pour annuler une partie du
+@code{\parskip}).
+
+@item style
+@anchor{startsection style}
+@anchor{\@@startsection/style}
+Contrôle le style du titre : voir les exemples plus bas. Les commandes
+typiquement utilisées ici sont @code{\centering}, @code{\raggedright},
+@code{\normalfont}, @code{\hrule}, ou @code{\newpage}. La dernière
+commande au sein de @var{style} peut être une commande prenant un
+argument, telle que @code{\MakeUppercase} ou @code{\fbox}. Le titre de
+la rubrique est passé en argument à cette commande. Par exemple régler
+@var{style} à @code{\bfseries\MakeUppercase} a pour effet de produire
+des titres gras et en capitales.
+@end table
+
+Voici les réglages par défaut de @LaTeX{} pour les trois premiers
+niveaux de rubricage qui sont définis par @code{\@@startsection}, pour
+les classes @file{article}, @file{book}, et @file{report}.
+@itemize
+@item
+Pour section, le @var{niveau} vaut 1, le @var{retrait} vaut 0@dmn{pt},
+le @var{avant} vaut @code{-3.5ex plus -1ex minus -0.2ex}, le @var{après}
+vaut @code{2.3ex plus 0.2ex}, et le @var{style} vaut
+@code{\normalfont\Large\bfseries}.
+@item
+Pour subsection, le @var{niveau}
+vaut 2, le @var{retrait} vaut 0@dmn{pt}, le @var{avant} vaut
+@code{-3.25ex plus -1ex minus -0.2ex}, le @var{après} vaut @code{1.5ex
+plus 0.2ex}, et le @var{style} vaut @code{\normalfont\large\bfseries}.
+@item
+Pour subsubsection, le @var{niveau} vaut 3, le @var{retrait} vaut
+0@dmn{pt}, le @var{avant} vaut @code{-3.25ex plus -1ex minus -0.2ex}, le
+@var{après} vaut @code{1.5ex plus 0.2ex}, et le @var{style} vaut
+@code{\normalfont\normalsize\bfseries}.
+@end itemize
+
+
+Voici des exemples. Pour les utiliser, mettez-les soit au sein d'un
+fichier de paquetage ou de classe, soit dans le préambule d'un document
+@LaTeX{}. Si vous les mettez dans le préambule, elle doivent être entre
+une commande @code{\makeatletter} et une commande @code{\makeatother}.
+(Le message d'erreur @code{You can't use `\spacefactor' in vertical
+mode.} est le plus probable lorsque on oublie de faire
+cela). @xref{\makeatletter & \makeatother}.
+
+L'exemple ci-dessous centre les titres de section et les met en gros
+caractères gras. Il le fait avec @code{\renewcommand} parce que les
+classes standardes de @LaTeX{} ont déjà une commande @code{\section} de
+définie. Pour la même raison il ne définit ni un compteur
+@code{section}, ni les commandes @code{\thesection} et
+@code{\l@@section}.
+
+@example
+\renewcommand\section@{%
+ \@@startsection@{section@}% @ref{\@@startsection/name,@var{nom},@var{nom}}.
+ @{1@}% @ref{\@@startsection/level,@var{niveau},@var{niveau}}.
+ @{0pt@}% @ref{\@@startsection/indent,@var{retrait},@var{retrait}}.
+ @{-3.5ex plus -1ex minus -.2ex@}% @ref{\@@startsection/beforeskip,@var{avant},@var{avant}}.
+ @{2.3ex plus.2ex@}% @ref{\@@startsection/afterskip,@var{après},@var{après}}.
+ @{\centering\normalfont\Large\bfseries@}@}% @ref{\@@startsection/style,@var{style},@var{style}}.
+@end example
+
+
+L'exemple ci-dessous met les titres de @code{subsection} en petites
+capitales, et leur fait faire corps avec le paragraphe suivant.
+
+@example
+\renewcommand\subsection@{%
+ \@@startsection@{subsection@}% @ref{\@@startsection/name,@var{nom},@var{nom}}.
+ @{2@}% @ref{\@@startsection/level,@var{niveau},@var{niveau}}.
+ @{0em@}% @ref{\@@startsection/indent,@var{retrait},@var{retrait}}.
+ @{-1ex plus 0.1ex minus -0.05ex@}% @ref{\@@startsection/beforeskip,@var{avant},@var{avant}}.
+ @{-1em plus 0.2em@}% @ref{\@@startsection/afterskip,@var{après},@var{après}}.
+ @{\scshape@}% @ref{\@@startsection/style,@var{style},@var{style}}.
+ @}
+@end example
+
+
+Les exemples précédents redéfinissaient les commandes de titre de
+rubriques existantes. L'exemple suivant définit une nouvelle commande,
+illustrant la nécessité d'un compteur et de macros pour son affichage.
+
+@c From https://groups.google.com/forum/#!searchin/comp.text.tex/startsection%7Csort:relevance/comp.text.tex/sB-nTS-oL08/ZZeKYdG0llMJ
+@example
+\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
+@end example
@node Cross references
-@chapter Des références croisées
-@cindex références croisées
+@chapter Des renvois
+@cindex renvois
Une des raisons pour numéroter des choses telles que les figures ou les
équations est d'indiquer au lecteur une référence vers elles, comme dans « Voir la
figure 3 pour plus de détails. »
@cindex étiquette
-Inclure le numéro de figure dans le code source est une mauvaise
-pratique puisque ce si ce noméro change avec l'évolution du document,
-alors on doit penser à mettre à jour cet référence manuellement. Au lieu
-de cela, @LaTeX{} vous fait écrire une @dfn{étiquette} du genre
-@code{\label@{eq:ThmGreens@}} et lui faire référence avec @code{Voir
-l'équation~\ref@{eq:ThmGreens@}}.
-
-@LaTeX{} écrit l'information provenant des étiquettes dans un fichier
-avec le même nom que le fichier conteant le @code{\label@{...@}} mais
-avec une extension @file{.aux}. (L'information a le format
+Souvent on désire écrire quelque chose du genre de @samp{Voir
+théorème~31}. Mais Inclure manuellement le numéro est une mauvaise
+pratique. Au lieu de cela, il vaut mieux écrire une @dfn{étiquette} du
+genre @code{\label@{eq:ThmGreens@}} puis lui @dfn{faire référence} avec
+@code{Voir l'équation~\ref@{eq:ThmGreens@}}. @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.
+
+@example
+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@}.
+@end example
+
+
+@LaTeX{} garde trace de l'information de renvoi dans un
+fichier avec le même nom de base que le fichier contenant le
+@code{\label@{...@}} mais avec une extension @file{.aux}. Ainsi si
+@code{\label} est dans @file{calcul.tex} alors cette information est
+dans @file{calcul.aux}. @LaTeX{} met cette information dans ce fichier à
+chaque fois qu'il rencontre un @code{\label}.
+
+@ignore
+(L'information a le format
@code{\newlabel@{@var{étiquette}@}@{@{@var{étiquette-courante}@}@{@var{numéro-de-page}@}@}}
où @var{étiquette-courante} est la valeur de la macro
@code{\@@currentlabel} qui est d'ordinaire mise à jour à chaque vous que
-that is vous appelez @code{\refstepcounter@{@var{compteur}@}}.)
+vous appelez @code{\refstepcounter@{@var{compteur}@}}.)
+@end ignore
@cindex référence déclarée en aval
@cindex aval, référence déclarée en
@cindex déclaration en aval de référence
L'effet secondaire le plus courant du paragraphe précédent se produit
lorsque votre document a une @dfn{référence déclarée en aval}, c.-à-d.@:
-un @code{\ref@{@var{clef}@}} qui apparaît avant le
-@code{\label@{@var{clef}@}} associé ; voir l'exemple dans la description
-de @code{\pageref@{...@}}. @LaTeX{} obtient les référence à partir du
-fichier @file{.aux}. Si c'est la première fois que vous compilez le
-document alors vous obtiendrez un message @code{LaTeX Warning: Label(s)
-may have changed. Rerun to get cross references right.} et dans la
-sortie la référence apparaîtra comme deux points
-d'interrogration @samp{??} 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'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 @code{\ref} qui apparaît avant le @code{\label} associé. Si c'est la
+première fois que vous compilez le document alors vous obtiendrez un
+message @code{LaTeX Warning: Label(s) may have changed. Rerun to get
+cross references right.} et dans la sortie la référence apparaîtra comme
+deux points d'interrogration @samp{??} 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'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.
+
+@PkgIndex{cleveref}
+
+Le paquetage @code{cleveref} élargit les possibilités de faire des
+renvois de @LaTeX{}. Vous pouvez faire en sorte que si vous saisissez
+@code{\begin@{thm@}\label@{th:Nerode@}...\end@{thm@}} alors
+@code{\cref@{th:Nerode@}} produit en sortie @samp{théorème 3.21}, sans
+que vous ayez à saisir le mot « théorème ».
+
@menu
* \label :: Attribuez un nom symbolique à un morceau de texte.
@@ -2700,8 +3589,8 @@ Voir Figure~\ref@{fig:test@}.
@node \pageref
@section @code{\pageref@{@var{clef}@}}
@findex \pageref
-@cindex référence croisée avec numéro de page
-@cindex numéro de page, référence croisée
+@cindex renvoi avec numéro de page
+@cindex numéro de page, renvoi
Synopsis :
@@ -2729,11 +3618,11 @@ page~\pageref@{eq:principale@}.
@node \ref
@section @code{\ref@{@var{clef}@}}
@findex \ref
-@cindex référence croisée, symbolique
-@cindex numéro de rubrique, référence croisée
-@cindex numéro d'équation, référence croisée
-@cindex numéro de figure, référence croisée
-@cindex numéro de note en bas de page, référence croisée
+@cindex renvoi, symbolique
+@cindex numéro de rubrique, renvoi
+@cindex numéro d'équation, renvoi
+@cindex numéro de figure, renvoi
+@cindex numéro de note en bas de page, renvoi
Synopsis :
@@ -2767,7 +3656,7 @@ Le format utilisé le plus largement est à l'item item numéro~\ref@{populaire@
@findex \begin
@findex \end
-@LaTeX{} fournit beacoup d'environnements pour baliser un certain texte.
+@LaTeX{} fournit beaucoup d'environnements pour baliser un certain texte.
Chaque environnement commence et se termine de la même manière :
@example
@@ -2796,11 +3685,11 @@ Chaque environnement commence et se termine de la même manière :
* math:: Math en ligne.
* minipage:: Page miniature.
* picture:: Image avec du texte, des flèches, des lignes et des cercles.
-* quotation et quote: quotation and quote. Citer du texte.
+* quotation et quote: quotation & quote. Citer du texte.
* tabbing:: Aligner du texte arbitrairement.
* table:: Tables flottante.
* tabular:: Aligner du texte dans les colonnes.
-* thebibliography:: Bibliographie ou liste de référence.
+* thebibliography:: Bibliographie ou liste de références.
* theorem:: Théorèmes, lemmes, etc.
* titlepage:: Pour des pages de titre sur mesure.
* verbatim:: Simuler un entrée tapuscrite.
@@ -3059,8 +3948,8 @@ Synopsis :
@example
\begin@{description@}
-\item [@var{étiquette1}] @var{article1}
-\item [@var{étiquette2}] @var{article2}
+\item [@var{étiquette du 1er article}] @var{texte du 1er article}
+\item [@var{étiquette du 2e article}] @var{texte du 2e article}
...
\end@{description@}
@end example
@@ -3068,29 +3957,60 @@ Synopsis :
@findex \item
L'environnement @code{description} est utilisé pour fabriquer des listes
d'articles étiquetés. Chaque @var{étiquette} d'article est composée en
-gras, alignée à gauche. Bien que les étiquettes sur les articles sont
-optionnelles il n'y a pas de valeur par défaut sensée, c'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'article. Il doit y avoir au moins un
+article ; sans cela provoque l'erreur @LaTeX{} @samp{Something's
+wrong--perhaps a missing \item}.
-@findex \item
-La liste consiste en au moins un article ; voir @ref{\item} (l'absence
-d'article cause l'erreur @LaTeX{} @samp{Something's wrong--perhaps a
-missing \item}). Chaque article est produit avec une commande
-@code{\item}.
+Cet exemple montre l'environnement utilisé pour une séquence de
+définitions. Les étiquettes @samp{lama} et @samp{llama} ressortent en
+gras avec leur bords gauches alignés sur la marge de gauche.
-@c où ça va ?=> Le texte @var{article} peut contenir plusieurs paragraphes.
+@example
+\begin@{definition@}
+ \item[lama] Un prêtre.
+ \item[lame] Une pièce coupante.
+@end example
+@findex \item
+Faites démarrer la liste d'articles avec la commande @code{\item}
+(@pxref{\item}). Utilisez l'étiquette optionnelle, comme dans
+@code{\item[Point principal]}, en effet il n'y a pas de valeur par
+défaut sensée. Après le @code{\item} se trouve du texte optionnel
+pouvant contenir plusieurs paragraphes.
+
+@cindex gras machine à écrire, éviter
@cindex gras tapuscrit, éviter
+@cindex étiquette machine à écrire dans les listes
@cindex étiquette tapuscrite dans les listes
-Une autre variation : puisque le style gras est appliqué aux étiquettes,
-si vous composez une étiquette en style tapuscrit avec @code{\texttt},
-vous obtiendrez du gras tapuscrit : @code{\item[\texttt@{gras et
-tapuscrit@}]}. C'est peut-être trop gras, entre autres problèmes. Pour
-obtenir juste le style tapuscrit, utilisez @code{\tt}, ce qui
-reinitialise toutes les autres variations de style : @code{\item[@{\tt
-tapuscrit de base@}]}.
+Comme les étiquettes sont en gras, si le texte de l'étiquette appelle un
+changement de police effectué dans la forme à argument (voir @ref{Font
+styles,styles des polices}) alors il ressortira en gras. Par exemple,
+si le texte de l'étiquette est en police machine à écrire comme dans
+@code{\item[\texttt@{texte étiquette@}]} 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'utiliser la forme
+déclarative : @code{\item[@{\tt texte étiquette@}]}. De la même façon,
+obtenez la police romaine standarde avec @code{\item[@{\rm texte
+étiquette@}]}.
+
+En ce qui concerne les autres principaux environnements de liste à
+étiquettes de @LaTeX{}, voir @ref{itemize} et @ref{enumerate}.
+Contrairement à ces environnements, imbriquer les environnement
+@code{description} ne change pas l'étiquette par défaut ; elle est en
+gras et alignée à gauche à tous les niveaux.
+
+Pour plus d'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 @ref{list}. Le paquetage @file{enumitem} est
+utile pour personnaliser les listes.
-Pour les détails concernant l'espacement des listes, voir @ref{itemize}.
+Cet exemple met les étiquettes de description en petites capitales.
+
+@example
+\renewcommand@{\descriptionlabel@}[1]@{%
+ @{\hspace@{\labelsep@}\textsc@{#1@}@}@}
+@end example
@node displaymath
@@ -3124,18 +4044,23 @@ plus vastes en matière d'affichage d'équations. Par exemple, il offre
plusieurs altenatives pour effectuer des sauts de lignes au sein de
texte en mode mathématique.
-La construction @code{\[@var{des maths}\]} est essentiellement un
-synonyme de @code{\begin@{displaymath@}@var{des
+@findex \[...\] @r{displaymath}
+La construction @code{\[@var{des maths}\]} est un synonyme de
+l'environnement @code{\begin@{displaymath@}@var{des
maths}\end@{displaymath@}}, mais ce dernier est plus pratique à
-manipuler dans le code source ; par exemple la recherche d'un caractère
-crochet @code{]} peut donner des faux positifs, alors qu'il est plus
-probable que le mot @code{displaymath} soit unique. (La construction
-@code{$$@var{des maths}$$} tirée du language @TeX{} de base est souvent
-utilisée à tort comme un synonyme de @code{displaymath}. Ce n'en est
-pas un, parce que l'environnement @code{displaymath} vérifie qu'il ne
-commence pas en mode mathérmatique, parce qu'il gère l'espacement
-verticial environment différemment, et parce qu'il honore l'option
-@code{fleqn}.)
+manipuler dans le fichier source ; par exemple la recherche d'un
+caractère crochet @code{]} peut donner des faux positifs, alors qu'il
+est plus probable que le mot @code{displaymath} soit unique.
+
+
+@findex $$...$$ @r{displaymath, forme approchée en @value{PlainTeX}}
+(Digression : la construction @code{$$@var{des maths}$$} tirée du
+language @value{PlainTeX} est souvent utilisée à tort comme un synonyme
+de @code{displaymath}. Elle n'en est pas un, et n'est pas du tout
+officiellement prise en charge par @LaTeX{} ; @code{$$} ne prend pas en
+charge @code{fleqn} (@pxref{Document class options}), gère l'espacement
+verticial environment différemment, et n'effectue pas de vérification de
+cohérence).
Le texte composé par cet exemple est centré et seul sur sa ligne.
@example
@@ -3390,7 +4315,7 @@ ou
@var{corpsfigure}
\caption[@var{titreldf}]@{@var{texte}@}
\label@{@var{étiquette@}}
-\end@{figure@}
+\end@{figure*@}
@end example
Une classe de flottant (@pxref{Floats}). Parce qu'elles ne peuvent pas
@@ -3417,7 +4342,7 @@ L'étiquette est optionnelle ; elle est utilisée pour les double renvois
La commande @code{\caption} spécifie la légende @var{texte} pour la
figure. La légende est numérotée par défaut. Si @var{titreldf} est
présent, il est utilisé dans la liste des figures au lieu de @var{texte}
-(@pxref{Tables of contents}).
+(@pxref{Table of contents etc.}).
Cet exemple fabrique une figure à partir d'un graphique. Il nécessite
l'un des paquetage @file{graphics} ou @file{graphicx}. Le graphique,
@@ -3443,37 +4368,64 @@ fin du document, sur une page de flottants.
Synopsis :
@example
-\begin@{filecontents@}@{@var{nomfichier}@}
+\begin@{filecontents@}[@var{option}]@{@var{nomfichier}@}
@var{texte}
\end@{filecontents@}
@end example
+@noindent
ou
@example
-\begin@{filecontents*@}@{@var{nomfichier}@}
+\begin@{filecontents*@}[@var{option}]@{@var{nomfichier}@}
@var{texte}
\end@{filecontents*@}
@end example
-Crée un fichier nommé @var{nomfichier} et le remplit de @var{texte}. La
-version non étoilée de l'environnement @code{filecontent} préfixe le
-contenu du ficher crée d'une en-tête ; voir l'exemple ci-dessous. La
-version étoilée @code{filecontent*} n'inclut par l'en-tête.
+Crée un fichier nommé @var{nomfichier} dans le répertoire courant (ou
+dans le répertoire de sortie s'il a été spécifié ; @pxref{output
+directory}) et y écrit @var{texte}. Par défaut un fichier déjà existant
+n'est pas écrasé.
+
+La version non étoilée de l'environnement @code{filecontent} préfixe le
+contenu du ficher créé d'une en-tête de commentaires @TeX{} ; voir
+l'exemple ci-dessous. La version étoilée @code{filecontent*} n'inclut
+par l'en-tête.
+
+Les options possibles sont :
+
+@table @code
+@item force
+@itemx overwrite
+@cindex @code{force}, option de @code{filecontents}
+@cindex @code{overwrite}, option de @code{filecontents}
+Écrase le fichier s'il existe.
+
+@item noheader
+@cindex @code{noheader}, option de @code{filecontents}
+Omet l'en-tête. Équivalent à utiliser @code{filecontents*}.
+
+@item nosearch
+@cindex @code{nosearch}, option de @code{filecontents}
+Vérifie uniquement si un fichier existe dans le répertoire courant (et
+le répertoire de sortie, s'il a été spécifié), non dans le chemin
+complet de recherche.
+
+
+@end table
+
+Ces options ont été ajoutées à la parution 2019 de @LaTeX{}.
-Cet environnement peut être utilisé n'importe-où dans le préambule, bien
-qu'elle apparaisse en général avant la commande
-@code{\documentclass}. Elle est typiquement utilisée quand une fichier
-source a besoin d'un fichier non standard de style ou de
-classe. L'environnement permet d'écrire ce fichier dans le répertoire
-contenant ce fichier et ainsi de rendre le code source autonome. Une
-autre utilisation est d'inclure des référence au format @code{bib} dans
-le fichier source, de même pour le rendre autonome.
+@cindex sources autonomes
+@cindex fichiers source, rendre autonomes
+Cet environnement peut être utilisé n'importe où dans le préambule, bien
+qu'il apparaisse souvent avant la commande @code{\documentclass}. Elle
+est classiquement utilisée pour créer un fichier @code{.bib} ou d'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.
-L'environnement vérifie si un fichier de même nom existe déjà, et si
-oui, ne fait rien. Il y a un paquetage @file{filecontents} qui redéfinit
-l'environnement @code{filecontents} de sorte qu'au lieu de ne rien faire
-dans ce cas, il écrase le fichier existant.
Par exemple, ce document :
@@ -3488,7 +4440,7 @@ Un article de \monnom.
\end@{document@}
@end example
-produit ce fichier @file{JH.sty}.
+produit ce fichier @file{JH.sty} :
@example
%% LaTeX2e file `JH.sty'
@@ -3663,20 +4615,36 @@ utilise des losanges :
@findex \leftmarginiv
@findex \leftmarginv
@findex \leftmarginvi
-
+@anchor{itemize leftmargin}
+@anchor{itemize leftmargini}
+@anchor{itemize leftmarginii}
+@anchor{itemize leftmarginiii}
+@anchor{itemize leftmarginiv}
+@anchor{itemize leftmarginv}
+@anchor{itemize leftmarginvi}
Les paramètres de @code{\leftmargini} jusqu'à @code{\leftmarginvi}
définissent la distance entre la marge de gauche de l'environnement
-surjacent et la marge de gauche de la liste. Par convention,
-@code{\leftmargin} est réglée à la @code{\leftmargin@var{N}} appropriée
-quand on entre dans un nouveau niveau d'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'imbrication). Les valeurs par défaut sont :
+@code{2.5em} pour le niveau 1 (@code{2em} en mode deux-colonnes),
+@code{2.2em} pour le niveau 2, @code{1.87em} pour le niveau 3 et
+@code{1.7em} pour le niveau 4, avec des valeurs plus petites pour les
+niveaux plus profondément imbriqués.
+
+@PkgIndex{enumitem}
+Pour les autres environnements majeurs de listes à étiquettes de
+@LaTeX{}, voir @ref{description} et @ref{enumerate}. 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 @ref{list}. La paquetage @file{enumitem} est utile
+pour personaliser les listes.
-Les valeurs par défaut varient de @samp{.5em} (pour les niveaux
-d'imbrication les plus élevés) jusqu'à @samp{2.5em} (premier niveau), et
-sont légèrement réduits en mode deux-colonnes. Cet exemple réduit
-grandement l'espace de marge pour la liste la plus extérieure :
+Dans cet exemple on réduit grandement l'espace de marge pour la liste à
+puces la plus externe~:
@example
-\setlength@{\leftmargini@}@{1.25em@} % par défaut 2.5em
+\setlength@{\leftmargini@}@{1.25em@} % valeur par défaut 2.5em
@end example
@c xx should be in its own generic section
@@ -3745,7 +4713,7 @@ désirable d'élider l'espace entre les articles. Voici un exemple
définissant un environnement @code{itemize*} sans espacement
supplémentaire entre les articles, ni entre les paragraphes au sein d'un
seul article (@code{\parskip} n'est pas spécifique aux listes,
-@pxref{\parskip}):
+@pxref{\parindent & \parskip}):
@example
\newenvironment@{itemize*@}%
@@ -3769,38 +4737,330 @@ Cet environnement est utilisé pour créer des lettres. @xref{Letters}.
@EnvIndex{list}
@cindex listes d'articles, générique
-L'environnement @code{list} 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.
+Synopsis :
@example
-\begin@{list@}@{@var{étiquettage}@}@{@var{espacement}@}
-\item @var{item1}
-\item @var{item2}
+\begin@{list@}@{@var{étiquetage}@}@{@var{espacement}@}
+\item[@var{étiquette optionnelle du premier article}] texte du premier article
+\item[@var{étiquette optionnelle du deuxième article}] texte du deuxième aticle
...
\end@{list@}
@end example
-L'argument obligatoire @var{étiquettage} spécifie comment les articles
-doivent être étiquetés (à moins que son argument optionnel soit fourni à
-@code{\item}). Cet argument est un morceau de texte qui est inséré dans
-une boîte pour former l'étiquette. Il peut contenir, et d'habitude c'est
-le cas, d'autres commandes @LaTeX{}.
+L'environnement @code{list} est un environnement générique qui est
+utilisé pour construire des listes plus spécialisées. On l'utilise la
+plupart du temps pour créer des listes via les environnements
+@code{description}, @code{enumerate}, et @code{itemize}
+(@pxref{description}, @ref{enumerate}, et @ref{itemize}). Par ailleurs,
+beaucoup d'environnements standards de @LaTeX{} qui visuellement ne sont
+pas des listes sont construits en utilisant @code{list}, ceci comprend
+@code{quotation}, @code{quote}, @code{center}, @code{verbatim}, et bien
+d'autres (@pxref{quotation & quote}, @pxref{center},
+@pxref{flushright}).
+
+Ici, on décrit l'environnement @code{list} en définissant un
+nouvel environnement personnalisé.
+
+@example
+\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@}
+@end example
+
+L'argument obligatoire @var{étiquetage}, qui est le premier argument de
+l'environnement @code{list}, spécifie comment les articles doivent être
+étiquetés par défaut. Il peut contenir du texte et des commandes
+@LaTeX{}, comme dans l'exemple précédent où il contient à la fois
+@samp{Article} et @samp{\Roman@{@dots{}@}}. @LaTeX{} forme l'étiquette
+en mettant l'argument @var{étiquetage} dans une boîte de largeur
+@code{\labeidth}. Si l'étiquette est plus large que cela, le matériel
+supplémentaire s'étend sur la droite. Lorsque vous fabriquez une
+instance de @code{list} vous pouvez l'emporter sur l'étiquetage par
+défaut en donnant à @code{\item} un argument optionnel avec des crochets
+et le texte, comme dans l'exemple précédent @code{\item[Étiquette
+spéciale.]} ; @pxref{\item}.
+
+Le second argument obligatoire @var{espacement} prend une liste de
+commandes. L'une de celle qu'on y retrouve est
+@code{\usecounter@{@var{nomcompteur}@}} (@pxref{\usecounter}). 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'environnement, et le compteiur est incrémenté par un chaque
+fois que @LaTeX{} rencontre une commande @code{\item}.
+
+@findex \makelabel
+Une autre commande qu'on retrouve dans @var{espacement} est
+@code{\makelabel}, pour construire la boîte de l'étiquette. Par défaut
+elle positionne le contenu fer à droite. Elle prend un argument,
+l'étiquette. Elle compose sont contenu en mode LR. Un exemple de
+changement de sa définition consiste dans l'exemple précédent
+@code{nommage} à ajouter avant la définition de l'environnement
+@code{\newcommand@{\namedmakelabel@}[1]@{\textsc@{#1@}@}}, et entre la
+commande @code{\setlength} et la parenthèse cloturant l'argument
+@var{espacmeent} à ajouter aussi @code{\let\makelabel\namedmakelabel}.
+Ceci composera les étiquette en petites capitales. De même, en
+remplaçant cette seconde ligne de code par @code{\let\makelabel\fbox} on
+met les étiquettes dans une boîte encadrée. Ci-après voici un autre
+exemple de la commande @code{\makelabel}, dans la définition de
+l'énvironnement @code{etiquetterouge}.
+
+De même on trouve souvent au sein de @var{espacement} des commandes pour
+redéfinir l'espacement de la liste. Ci dessous on listes les paramètres
+d'espacement et leur valeurs par défaut. (Il se peut que les valeurs par
+défaut pour les environnements dérivés tels que @code{itemize} soient
+différentes des valeurs exposées ici). Voir aussi la figure qui suit la
+liste. Chaque paramètre est une longueur (@pxref{Lengths}). Les espaces
+verticaux sont d'ordinaire des longueurs élastiques, avec une composante
+en @code{plus} ou en @code{minus}, 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 @code{\setlength@{itemsep@}@{2pt plus1pt
+minus1pt@}}. Pour obtenir certains effets, ces longueurs doivent être
+mise à zéro, ou à une valeur négative.
+
+@ftable @code
+@item \itemindent
+Espace supplémentaire horizontal de renfoncement, ajouté à de
+@code{leftmargin}, de la première ligne de chaque article. Sa valeur par
+défaut est @code{0pt}.
+
+@item \itemsep
+Espace vertical entre les articles, ajouté à @code{\parsep}. Les
+valeurs par défaut pour les trois premiers niveaux dans les classes de
+@LaTeX{} @samp{article}, @samp{book}, et @samp{report} à la taille de 10
+point sont : @code{4pt plus2pt minus1pt}, @code{\parsep} (c-à-d.@:
+@code{2pt plus1pt minus1pt}), et @code{\topsep} (c-à-d.@: @code{2pt
+plus1pt minus1pt}). Les valeurs par défaut à 11 points sont :
+@code{4.5pt plus2pt minus1pt}, @code{\parsep} (c-à-d.@: @code{2pt
+plus1pt minus1pt}), et @code{\topsep} (c-à-d.@: @code{2pt plus1pt
+minus1pt}). Les valeurs par défaut à 12 points sont : @code{5pt
+plus2.5pt minus1pt}, @code{\parsep} (c-à-d.@: @code{2.5pt plus1pt
+minus1pt}), et @code{\topsep} (c-à-d.@: @code{2.5pt plus1pt minus1pt}).
+
+@item \labelsep
+Espace horizontal entre l'étiquette et le texte d'un article. La valeur
+par défaut pour les classes @LaTeX{} @samp{article}, @samp{book}, et
+@samp{report} est de @code{0.5em}.
+
+@item \labelwidth
+Largueur horizontale. La boîte contenant l'étiquette est nominalement de
+cette largeur. Si @code{\makelabel} renvoie un texte qui est plus larget
+que cela, alors le renfoncement de la première ligne de l'article sera
+augmenté pour créer l'espace nécessaire à ce matériel supplémentaire.
+Si @code{\makelabel} renvoie un texte de largeur inférieur ou égale à
+@code{\labelwidth} alors le comportement par défaut de @LaTeX{} est que
+l'étiquette est composé fer à droite dans une boîte de cette largeur.
+
+Le bord de gauche de la boîte de l'étiquette est à
+@code{\leftmargin}+@code{\itemindent}-@code{\labelsep}-@code{\labelwidth}
+de la marge de gauche de l'environnement enveloppant.
+
+La valeur par défaut pour les classe @LaTeX{} @samp{article},
+@samp{book}, et @samp{report} pour les liste de premier niveau vaut
+@code{\leftmargini}-@code{\labelsep}, (c-à-d.@: @code{2em} en mode à une
+colonne et @code{1.5em} en mode à deux colonnes). Au deuxième niveau,
+c'est @code{\leftmarginii}-@code{\labelsep}, et au troisième niveau
+@code{\leftmarginiii}-@code{\labelsep}. Ces définitions ont pour effet
+que le bord de gauche de l'étiquette coïncide avec la marge dee gauche
+de l'environnement enveloppant.
+
+r@item \leftmargin
+Espace horizontal entre la marge de gauche de l'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.
+
+Dans les classes de document @LaTeX{} standardes, ce paramètre est réglé
+à la valeur @code{\leftmargini} pour une liste de premier niveau, alors
+que pour une liste de deuxième niveau, c'est à dire imbriquée dans une
+liste de premier niveau, il est réglé à @code{\leftmarginii}. Pour les
+listes aux niveaux d'imbrication suivants les valeurs de
+@code{\leftmarginiii} à @code{\leftmarginvi} sont utilisées. (Imbriquer
+des liste au delà de cinq niveaux produit le message d'erreur @samp{Too
+deeply nested}).
+
+Les valeurs par défaut des trois premiers niveaux dans les classes
+@LaTeX{} @samp{article}, @samp{book}, et @samp{report} sont les
+suivantes : @code{\leftmargini} vaut @code{2.5em} (ou @code{2em} en mode
+à deux colonnes), @code{\leftmarginii} vaut @code{2.2em}, et
+@code{\leftmarginiii} vaut @code{1.87em}.
+
+@item \listparindent
+Espace horizontal de renfoncement supplémentaire, en plus de
+@code{\leftmargin}, pour le deuxième paragraphes et les suivants au sein
+d'un article de liste. A negative value makes this an ``outdent''. Its
+default value is @code{0pt}.
+
+@item \parsep
+@anchor{list parsep} Espace vertical entre les paragraphe d'un article.
+Les valeurs par défaut pour les trois premierss niveaux dans les classes
+@LaTeX{} @samp{article}, @samp{book} et @samp{report} à la taille de 10
+point sont : @code{4pt plus2pt minus1pt}, @code{2pt plus1pt minus1pt},
+and @code{0pt}. La valeurs par défaut à la taille de 11 point sont :
+@code{4.5pt plus2pt minus1pt}, @code{2pt plus1pt minus1pt}, et
+@code{0pt}. La valeurs par défaut à la taille de 12 point sont :
+@code{5pt plus2.5pt minus1pt}, @code{2.5pt plus1pt minus1pt}, and
+@code{0pt}.
+
+@item \partopsep
+@anchor{list partopsep} Espace vertical ajouté, en plus de
+@code{\topsep}+@code{\parskip}, en haut et en bas de l'environnement
+tout entier lorsque la liste considérée est précédée d'une ligne à
+blanc. (Une ligne à blanc dans le source @LaTeX{} avant la liste change
+l'espacement à la fois en haut et en bas de la liste ; que la ligne
+suivant la liste soit à blanc est sans importance).
+
+Les valeurs par défaut pour les trois premiers niveaux dans les classes
+@LaTeX{} @samp{article}, @samp{book}, anet @samp{report} à la taille de
+point sont : @code{2pt plus1 minus1pt}, @code{2pt plus1pt minus1pt}, et
+@code{1pt plus0pt minus1pt}. Les valeurs par défaut à la taille de 11
+point sont : @code{3pt plus1pt minus1pt}, @code{3pt plus1pt minus1pt},
+et @code{1pt plus0pt minus1pt}). Les valeurs par défaut à la taille de
+12 point sont : @code{3pt plus2pt minus3pt}, @code{3pt plus2pt
+minus2pt}, et @code{1pt plus0pt minus1pt}.
+
+@item \rightmargin
+@anchor{list rightmargin}
+
+Espace horizontal entre la marge de droite de la liste et la marge de
+droite de l'environnement l'englobant. Horizontal space between the right margin of the list
+and the right margin of the enclosing environment. Its default value is
+@code{0pt}. It must be non-negative.
+
+@item \topsep
+@anchor{list topsep} Espace vertical ajouté aussi bien au haut qu'au bas
+de la lise, en plus de @code{\parskip} (@pxref{\parindent & \parskip}).
+Les valeurs par défaut pour les trois premiers niveaux dans les classes
+@LaTeX{} @samp{book}, anet @samp{report} à la taille de 10 point sont :
+@code{8pt plus2pt minus4pt}, @code{4pt plus2pt minus1pt}, and @code{2pt
+plus1pt minus1pt}. Les valeurs par défaut à la taille de 11 point
+sont : @code{9pt plus3pt minus5pt}, @code{4.5pt plus2pt minus1pt}, and
+@code{2pt plus1pt minus1pt}. Les valeurs par défaut à la taille de 12
+point sont : @code{10pt plus4pt minus6pt}, @code{5pt plus2.5pt
+minus1pt}, and @code{2.5pt plus1pt minus1pt}.
+
+@end ftable
+
+La figure suivante illustre les distances horizontales et verticales.
+
+@float
+@image{latex2e-figures/list,3.21in,,,.png}
+@end float
+
+Les longueurs illustrées sont listées ci-dessous. La relation clef est
+que le bord droit du crochet pour @var{h1} est à la même position
+horizontale que le bord droit du crochet pour @var{h4}, de sorte que le
+bord de gauche de la boîte de l'étiquette est à
+@var{h3}+@var{h4}-(@var{h0}+@var{h1}).
+
+@table @var
+@item v0
+vaut @math{@code{@\topsep} + @code{@\parskip}} si l'environnement
+@code{list} ne commence pas un nouveau paragraphe, et
+@code{\topsep}+@code{\parskip}+@code{\partopsep} sinon
+
+@item v1
+@code{\parsep}
+
+@item v2
+@code{\itemsep}+@code{\parsep}
+
+@item v3
+Même valeur que @var{v0}. (Cet espace est affecté selon qu'une ligne à
+blanc apparaît dans le source au dessus de l'environnemnt ; la présence
+d'une ligne à blanc au dessous de l'environnement est sans effet.)
+
+@item h0
+@code{\labelwidth}
+
+@item h1
+@code{\labelsep}
+
+@item h2
+@code{\listparindent}
-L'argument obligatoire @var{espacement} contient des commandes pour
-changer les paramètres d'espacement pour la liste. Cet argument est le
-plus souvent vide, c.-à-d.@: @code{@{@}}, ce qui laisse l'espacement
-par défaut.
+@item h3
+@code{\leftmargin}
-L'argument utilisé pour composer les articles de la liste est spécifiée
-par @code{\linewidth} (@pxref{Page layout parameters}).
+@item h4
+@code{\itemindent}
+
+@item h5
+@code{\rightmargin}
+
+@end table
+
+The list's left and right margins, shown above as @var{h3} and @var{h5},
+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 @code{\linewidth} (@pxref{Page
+layout parameters}). For instance, set the list's left margin to be one
+quarter of the distance between the left and right margins of the
+enclosing environment with
+@code{\setlength@{\leftmargin@}@{0.25\linewidth@}}.
+
+Page breaking in a list structure is controlled by the three
+parameters below. For each, the @LaTeX{} default is
+@code{-\@@lowpenalty}, that is, @code{-51}. Because it is negative,
+it somewhat encourages a page break at each spot. Change it with,
+e.g., @code{\@@beginparpenalty=9999}; a value of 10000 prohibits a
+page break.
+
+@ftable @code
+@item \@@beginparpenalty
+The page breaking penalty for breaking before the list (default @code{-51}).
+
+@item \@@itempenalty
+The page breaking penalty for breaking before a list item (default @code{-51}).
+
+@item \@@endparpenalty
+The page breaking penalty for breaking after a list (default @code{-51}).
+
+@end ftable
+
+@PkgIndex{enumitem}
+Le paquetage @code{enumitem} est utile pour personaliser les
+listes.
+
+Dans l'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. @xref{\usecounter}.
+
+@example
+\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@} @}
+@end example
@menu
* \item:: Une entrée dans une liste.
+* trivlist:: Une forme restreinte de @code{list}.
@end menu
@node \item
+@subsection @code{\item}: Une entrée dans une liste
Synopsis :
@@ -3808,6 +5068,7 @@ Synopsis :
\item texte de l'article
@end example
+@noindent
ou
@example
\item[@var{étiquette optionnelle}] texte de l'article
@@ -3839,6 +5100,53 @@ Le premier article est étiquetté @samp{1.}, le deuxième article est
@samp{2.} (notez que, à cause de l'étiquette optionnelle dans le second
article, le troisième article ne reçoit pas l'étiquette @samp{3.}).
+@node trivlist
+@subsection @code{trivlist}: Une forme restreinte de @code{list}
+
+Synopsis :
+
+@example
+\begin@{trivlist@}
+ ...
+\end@{trivlist@}
+@end example
+
+Une version restreinte de l'environnement @code{list} dans laquelle les
+marges sont sans renfoncement et @code{\item} sans l'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 @code{\item}
+fait partie de la définition de l'environnement. Par exemple,
+l'environnement @code{center} est défini pour l'essentiel comme ceci :
+
+@example
+\newenvironment@{center@}
+ @{\begin@{trivlist@}\centering\item\relax@}
+ @{\end@{trivlist@}@}
+@end example
+
+Utiliser @code{trivlist} de la sorte permet à la macro d'hériter du code
+mutualisé : combiner l'espace vertical provenant de deux environnement
+adjacent ; détecter si le texte suivant l'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'éventuels
+environnements de liste imbriqués.
+
+En particulier, @code{trivlist} utilise les valeurs courantes des
+paramètres de liste (@pxref{list}), à ceci près que @code{\parsep} est
+réglé à la valeur de @code{\parskip}, et que @code{\leftmargin},
+@code{\labelwidth}, et @code{\itemindent} sont réglés à zéro.
+
+Cet exemple produit les articles comme deux paragraphes, à ceci près que
+(par défaut) ils n'ont pas de renfoncement de paragraphe et sont séparés
+verticalement.
+
+@example
+\begin@{trivlist@}
+\item C'est un fameux trois-mâts, fin comme un oiseau
+\item Hisse et ho, Santiano.
+\end@{trivlist@}
+@end example
+
@node math
@section @code{math}
@EnvIndex{math}
@@ -3852,6 +5160,8 @@ Synopsis :
\end@{math@}
@end example
+@findex $ @r{en ligne, math}
+@findex \(...\) @r{en ligne, math}
L'environnement @code{math} insert les @var{maths} donnés au sein du
texte en cours. @code{\(...\))} et @code{$...$} sont des synonymes.
@xref{Math formulas}.
@@ -3861,40 +5171,198 @@ texte en cours. @code{\(...\))} et @code{$...$} sont des synonymes.
@EnvIndex{minipage}
@cindex minipage, créer une
+Synopsis :
+
+@example
+\begin@{minipage@}@{@var{largeur}@}
+ @var{matière}
+\end@{minipage@}
+@end example
+
+@noindent
+ou
+
@example
\begin@{minipage@}[@var{position}][@var{hauteur}][@var{pos-interne}]@{@var{largeur}@}
-@var{texte}
+@var{matière}
\end@{minipage@}
@end example
-L'environnement @code{minipage} compose son corps @var{texte} dans un
-bloc qui ne peut pas être coupé sur plusieurs pages. C'est similaire à
-la commande @code{\parbox} (@pxref{\parbox}), mais contrairement à
-@code{\parbox}, d'autres environnements de production de paragraphe
-peuvent être utilisés au sein d'une minipage.
+Place @var{matière} dans une boîte qui est @var{largeur} de large. C'est
+comme une version réduite d'une page ; elle peut contenir ses propres
+notes en bas de page, listes à puces, etc. (Il y a quelques
+restrictions, notamment qu'elle ne peut pas avoir de flottants). Cette
+boîte ne peut pas être coupé sur plusieurs pages. Ainsi @code{minipage}
+est similaire à la commande @code{\parbox} (@pxref{\parbox}), mais
+contrairement à @code{\parbox}, d'autres environnements de production de
+paragraphe peuvent être utilisés au sein d'une minipage. This example
+will be 3@tie{}inches wide, and has two paragraphs.
-@c (xxref positions)
-Les arguments sont les mêmes que pour @code{\parbox} (@pxref{\parbox}).
+@example
+\begin@{minipage@}@{3in@}
+ Stephen Kleene fut un fondateur de la théorie de la récursivité.
-@cindex Renfoncement des paragraphes, au sein d'une minipage
+ 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@}
+@end example
+
+@noindent
+Voir plus bas pour une discussion sur le renfoncement de paragraphe au
+sein d'une @code{minipage}.
+
+L'argument obligatoire @var{largeur} est une longueur rigide (@pxref{Lengths}).
+Il donne la largeur de la boîte dans laquelle @var{matière} est composée.
+
+Il y a trois arguments optionnels, @var{position}, @var{hauteur}, et
+@var{pos-interne}. Il n'est pas nécessaire de fournir les trois à la
+fois. Par exemple, obtenez les valeur par défaut pour @var{position} et
+réglez @var{hauteur} avec @code{\begin@{minipage@}[c][2.54cm]
+@var{matière} \end@{minipage@}}. (Obtenez la hauteur naturelle avec un
+argument vide, @code{[]}).
+
+L'argument optionnel @var{position} gouverne la façon dont la
+@code{minipage} s'aligne verticalement avec la matière l'entourant.
+
+@table @code
+@item c
+@c xx Clarify what it means when adjacent text lines do not have aligned
+@c vertical center with each other
+(Synonyme @code{m}) Valeur par défaut. Positionne la @code{minipage} de
+sorte que son centre vertical soit aligné avec le centre des lignes de
+texte adjacentes.
+
+@item t
+@findex \vtop @r{@value{PlainTeX}}
+Aligne la ligne du haut de la @code{minipage} sur la ligne de base du
+texte l'entourant (comme @code{\vtop} en @value{PlainTeX}).
+
+@item b
+@findex \vbox @r{@value{PlainTeX}}
+Aligne la ligne du bas de @code{minipage} avec la ligne de base du texte
+l'entourant (comme @code{\vbox} en @value{PlainTeX}).
+@end table
+
+Pour voir l'effet de ces options, comparez le résultat de la compilation de
+
+@example
+---\begin@{minipage@}[c]@{0.25in@}
+ first\\ second\\ third
+\end@{minipage@}
+@end example
+
+@noindent
+avec ce qui se passe en remplaçant @code{c} par @code{b} ou @code{t}.
+
+L'argument optionnel @var{hauteur} est une longueur rigide
+(@pxref{Lengths}). Il règle la hauteur de la @code{minipage}. Vous
+pouvez donner n'importe quelle valeur supérieure, égale ou inférieure à
+la hauteur naturelle de la @code{minipage} sans que @LaTeX{} ne produise
+une erreur ou un avertissement. Vous pouvez aussi la régler à une
+hauteur de valeur nulle ou négative.
+
+L'argument optionnel final @var{pos-interne} contrôle la disposition de
+@var{matière} au sein de la boîte. Voici les valeurs possibles (la
+valeur par défaut est la valeur de l'argument @var{position}).
+
+@table @code
+@item t
+Place @var{matière} en haut de la boîte.
+
+@item c
+Centre @var{matière} verticalement.
+
+@item b
+Place @var{matière} en bas de la boîte.
+
+@item s
+Dilate @var{matière} verticalement ; elle doit contenir de l'espace
+dilatable verticalement.
+
+@end table
+
+L'argument @var{pos-interne} a un sens quand l'option @var{hauteur} est
+réglée à une valeur supérieure à la hauteur naturelle de la
+@code{minipage}. Pour voir l'effet des options, exécutez l'exemple
+suivant avec les différents choix possibles au lieu de @code{b}.
+
+@example
+Texte avant
+\begin@{center@}
+ ---\begin@{minipage@}[c][8cm][b]@{0.25\textwidth@}
+ premier\\ deuxième\\ troisième
+ \end@{minipage@}
+\end@{center@}
+Texte après
+@end example
+
+@cindex renfoncement des paragraphes, au sein d'une minipage
+@cindex paragraphes, renfoncement au sein d'une minipage
@findex \parindent
Par défaut, les paragraphes ne sont pas renfoncés au sein d'un
-environnement @code{minipage}. Vous pouvez restaurer le renfoncement avec
-une commande telle que @code{\setlength@{\parindent@}@{1pc@}}.
+environnement @code{minipage}. Vous pouvez restaurer le renfoncement
+avec une commande telle que @code{\setlength@{\parindent@}@{1pc@}} placé
+au début de @var{matière}.
@cindex notes en bas de page au sein des figures
@cindex figures, notes en bas de page au sein des
Les notes en bas de page au sein d'un environnement @code{minipage} sont
-gérées d'une façon qui est particulièrement utiles pour mettre des notes
+gérées d'une façon qui est particulièrement utile pour mettre des notes
en bas de page dans des figures ou des tableaux. Une commande
-@code{\footnote} @code{\footnotetext} met la note en bas de page au bas
+@code{\footnote} ou @code{\footnotetext} 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 @code{\mpfootnote} au lieu du compteur ordinaire
@code{footnote} (@pxref{Counters}).
-Cependant, ne mettez pas une minipage à l'intérieur d'une autre si vous
-utilisez les note en bas de page ; elles pourraient terminer en bas de
-la mauvaise minipage.
+L'exemple ci-dessous place la note argument de @code{\footnote} en bas
+de la table, et non en bas de la page.
+
+@example
+\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@} &\textsc@{Reigne@} \\ \hline
+ Elizabeth II &63 ans\footnote@{à ce jour@} \\
+ Victoria &63 ans \\
+ George III &59 ans
+ \end@{tabular@}
+ \end@{center@}
+\end@{minipage@}
+\end@{center@}
+@end example
+
+Si vous imbriquez des minipages, alors il y a une bizarrerie dans
+l'utilisation des note @code{\footnote}. Les notes apparaissement au bas
+du texte terminé par la prochaine @code{\end@{minipage@}} ce qui n'est
+peut-être pas leur place logique.
+
+L'exemple suivant place un tableau de données côte à côte d'un
+graphique. Ils sont verticalement centrés.
+
+@PkgIndex{siunitx}
+@example
+% 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@} &Pop. (million) \\ \hline
+ The Bronx &1.5 \\
+ Brooklyn &2.6 \\
+ Manhattan &1.6 \\
+ Queens &2.3 \\
+ Staten Island &0.5
+ \end@{tabular@}
+ \end@{minipage@}
+\end@{center@}
+@end example
@node picture
@section @code{picture}
@@ -3902,6 +5370,17 @@ la mauvaise minipage.
@cindex créer des images
@cindex images, créer
+Synopsis :
+
+@example
+\begin@{picture@}(@var{largeur},@var{hauteur})
+@dots{} @var{commandes picture} @dots{}
+\end@{picture@}
+@end example
+
+@noindent
+ou
+
@example
\begin@{picture@}(@var{largeur},@var{hauteur})(@var{décalagex},@var{décalagey})
@dots{} @var{commandes picture} @dots{}
@@ -3910,11 +5389,17 @@ la mauvaise minipage.
@findex \unitlength
-L'environnement @code{picture} 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 --- un
+L'environnement @code{picture} 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'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.
+
+@c xxx Revoir la trad.
+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 --- un
nombre comme @code{5}, @code{0.3} ou @code{-3.1416}. Une coordonnées
spécifie une longueur en multiples de l'unité de longueur
@code{\unitlength}, ainsi si @code{\unitlength} a été réglée à
@@ -4128,18 +5613,63 @@ cadre. Aucun espace supplémentaire n'est mis entre le cadre et l'objet
Synopsis :
@example
-\line(@var{xpente},@var{ypente})@{@var{longueur}@}
+\line(@var{xpente},@var{ypente})@{@var{excursion}@}
@end example
-La commande @code{\line} dessine un ligne avec la @var{longueur} donnée
-et la pente @var{xpente}/@var{ypente}.
+Dessine une ligne. Sa pente est telle que la ligne monte de @var{ypente}
+verticalement pour toute avancée horizontale de
+@var{xpente}. L'@var{excursion} est le déplacement horizontal total ---
+ce n'est pas la longueur du vecteur, mais la variation en @math{x}. Da,s
+me cas spécial des ligne vertical, où (@var{xpente},@var{ypente})=(0,1),
+l'@var{excursion} donne le déplacement en @math{y}.
+
+L'exemple suivant dessine une ligne commençant aux coordonnées (1,3).
-De base @LaTeX{} peut seulement dessiner des ligne dont la
-@math{@var{pente} = x/y}, où @math{x} et @math{y} prennent des valeurs
-entières de @minus{}6 jusqu'à 6. Pour des ligne de pente
-quelconque, sans parler d'autres formes, voir le paquetage
-@code{curve2e} et bien d'autres sur le CTAN.
+@example
+\put(1,3)@{\line(2,5)@{4@}@}
+@end example
+@noindent
+Pour toute avancée de 2 vers la droite, cette ligne monte de 5. Parce
+que @var{excursion} spécifie qu'elle avance de 4, elle monte en tout
+de 10. De sorte que son extrémité finale est
+@math{(1,3)+(4,10)=(5,13)}. En particulier, notez que
+@math{@var{excursion}=4} n'est pas la longueur de la ligne, mais c'est
+son déplacement en @math{x}.
+
+Les arguments @var{xpente} et @var{ypente} sont des entiers qui peuvent
+être positifs, negatifs, ou nuls zero (si les deux valent 0, alors
+@LaTeX{} traite le second comme 1). Avec
+@code{\put(@var{x_init},@var{y_init})@{\line(@var{xpente},@var{ypente})@{@var{travel}@}@}},
+si @var{xpente} est négatif alors l'extrémté finale d ela ligne a sa
+première coordonnée inférieure à @var{x_init}. Si @var{ypente} est
+negatif alors l'extrémité finale a sa seconde coordonnées inférieure à
+@var{y_init}.
+
+Si @var{excursion} est négatif alors vous obtenez @code{LaTeX Error: Bad \line or
+\vector argument.}
+
+@cindex @code{pict2e}, paquetage
+@cindex graphiques, paquetages
+@PkgIndex{pict2e}
+@PkgIndex{TikZ}
+@PkgIndex{PSTricks}
+@PkgIndex{MetaPost}
+@PkgIndex{Asymptote}
+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 @var{xpente} et @var{ypente} prennent
+des valeurs entières de @minus{}6 jusqu'à 6. De plus ils doivent être
+premiers entre eux, de sorte que (@var{xpente}, @var{ypente})=(2,1) est
+licite, mais pas (@var{xpente}, @var{ypente})=(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'autres
+formes dans un système tel que @code{picture}, voir le paquetage
+@file{pict2e} (@url{https://ctan.org/pkg/pict2e}). Une autre solution
+est d'utiliser un système graphique complet tel que TikZ, PSTricks,
+MetaPost, ou Asymptote.
@node \linethickness
@subsection @code{\linethickness}
@@ -4147,10 +5677,11 @@ quelconque, sans parler d'autres formes, voir le paquetage
La commande @code{\linethickness@{@var{dim}@}} déclare que l'épaisseur des
lignes horizontales et verticales dans un environnement @code{picture}
-environnement vaut @var{dim}, qui doit être une longueur positive.
+vaut @var{dim}, ce qui doit être une longueur positive.
-@code{\linethickness} n'affecte pas l'épaisseur des lignes obliques,
-cercles, ou quarts de cercles dessinés par @code{\oval}.
+Elle diffère de @code{\thinlines} et @code{\thicklines} en ce qu'elle
+n'affecte pas l'épaisseur des lignes obliques, cercles, ou quarts de
+cercles dessinés par @code{\oval}.
@node \thicklines
@@ -4270,7 +5801,7 @@ spécifiées. Les valeurs de @math{@var{xpente}} et @math{@var{ypente}}
doivent être comprises entre @minus{}4 and +4 y compris.
-@node quotation and quote
+@node quotation & quote
@section @code{quotation} et @code{quote}
@EnvIndex{quotation}
@cindex citation
@@ -4300,20 +5831,20 @@ ou
Cite du texte.
-Dans les deux environnement, les marges sont renfoncées à la fois sur la
+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.
Pour comparer les deux : dans l'environnement @code{quotation}, les
paragraphes sont renfoncés de 1,5@dmn{em} et l'espace entre les
-paragraphe est petit, @code{0pt plus 1pt}. Dans l'environnement
-@code{quote}, les paragraphes ne sont pas renfoncés et il y a une espace
-verticale entre les paragraphes (c'est la longueur elastique
+paragraphes est petit, @code{0pt plus 1pt}. Dans l'environnement
+@code{quote}, les paragraphes ne sont pas renfoncés et il y a un espace
+vertical entre les paragraphes (c'est la longueur élastique
@code{\parsep}). Ainsi, l'environnement @code{quotation} 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,
-@code{quote} convient meieux pour des citations courtes ou une suite de
+@code{quote} convient mieux pour des citations courtes ou une suite de
citations courtes.
@example
@@ -4328,7 +5859,7 @@ citations courtes.
@section @code{tabbing}
@EnvIndex{tabbing}
-@cindex taquets des tabulation, utiliser
+@cindex taquets de tabulation, utiliser
@cindex aligner du texte en utilisant des taquets de tabulation
@cindex alignement au moyen de tabbing
@@ -4337,66 +5868,200 @@ Synopsis :
@example
\begin@{tabbing@}
@var{row1col1} \= @var{row1col2} \= @var{row1col3} \= @var{row1col4} \\
-@var{row2col1} \> \> @var{row2col3} \\
+@var{row2col1} \> \> @var{row2col3} \\
...
\end@{tabbing@}
@end example
-
-
L'environnement @code{tabbing} fournit une technique pour aligner du
-texte en colonnes. Il fonctionne en réglant des taquet et en tabulant
-jusqu'à 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'avance.
+texte en colonnes. Il fonctionne en réglant des taquets et en tabulant
+jusqu'à 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'avance.
Cet environnement peut être rompu entre plusieurs pages, contrairement à
l'environnement @code{tabular}.
-Les commandes suivante peuvent être utilisée au sein d'un environnement @code{tabbing} :
+@cindex ligne tabulée, @r{tabbing}
+L'environnement @code{tabbing} contient une suite de @dfn{lignes
+tabulées}, la première ligne tabulée commence immédiatement après
+@code{\begin@{tabbing@}} et chaque ligne se termine par @code{\\} ou
+@code{\kill}. Il est possible de terminer la dernière ligne juste par
+@code{\end@{tabbing@}}, ce qui est équivalent à
+@code{\\\end@{tabbing@}}.
+
+@cindex motif courant de taquets de tabulation, @r{tabbing}
+L'environnement @code{tabbing} a un @dfn{motif courant de taquets de
+tabulation} qui est une séquence de @var{n} taquets, avec @math{@var{n} >
+0}, ce qui crée @var{n} colonnes correspondantes. Immédiatement après
+@code{\begin@{tabbing@}} on a @math{@var{n}=1}, 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.
+
+@cindex taquet courant, @r{tabbing}
+L'un des taquets du motif courant ayant été réglé comme le @dfn{taquet
+courant}, par défaut tout texte composé par la suite au sein de
+l'envionnement @code{tabbing} est composé en drapeau droit avec le fer à
+gauche sur ce taquet, c'est à dire qu'il est aligné à gauche dans la
+colonne courante. La composition est faite en mode LR.
+
+@cindex taquet de début de ligne courant, @r{tabbing}
+Par ailleurs l'environnement @code{tabbing} a un @dfn{taquet de début de
+ligne courant}. Par défaut, immédiatement après @code{\begin@{tabbing@}}
+c'est le taquet N°0, mais cela peut être changé avec les commandes
+@code{\+} et @code{\-}. Au début de chaque ligne tabulée, le taquet
+courant est initalement égal au taquet de début de ligne courant.
+
+La marge de droite de l'environnement @code{tabbing} est la fin de
+ligne, c.-à-d.@: que la largeur de l'environnement est de longueur
+@code{\linewidth}. Il n'y a pas par défaut de taquet correspondant à la
+marge de droite, même s'il serait possible avec un peu de calcul d'en
+définir un à cette position (voir exemples ci-après).
+
+En ce qui concerne la marge de gauche, ou autrement dit le taquet N°0,
+contrairement à l'environnement @code{tabular}, il n'est pas nécessaire
+de mettre un @code{\noindent} devant @code{\begin@{tabbing@}} pour
+éviter un renfoncement : un environnement @code{tabbing} commence
+toujours un nouveau paragraphe sans renfoncement. De plus il est inutile
+d'étoiler une commande @code{\hspace} en début de ligne tabulée pour que
+l'espace soit pris en compte.
+
+Les commandes suivantes peuvent être utilisées au sein d'un
+environnement @code{tabbing} :
@ftable @code
@item \\ @r{(tabbing)}
-Finit une ligne.
+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.
@item \= @r{(tabbing)}
-Règle un taquet à la position courante.
+Règle un taquet à la position courante. La @var{n}ième commande
+@code{\=} de la ligne tabulée courante définit le taquet N°@var{n}, ou
+le redéfinit s'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
+@math{(@var{n}+1)}, c'est à dire qu'on a des taquets N°0 à N°@var{n},
+alors la @math{(@var{n}+1)}ième commande @code{\=} définit le taquet
+N°@math{@var{n}+1}, ce qui porte le nombre de taquets à
+@math{@var{n}+2}. 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°@var{n} et N°@var{m} distincts, voire de faire en sorte que
+les taquets N°@var{n} et N°@var{m}, avec @math{@var{n}<@var{m}}, soient
+à des positions telles que le taquet N°@var{m} soit avant le taquet
+N°@var{n}.
@item \> @r{(tabbing)}
@findex \>
-Avance au taquet suivant.
+Change le taquet courant au taquet suivant dans l'ordre logique,
+c.-à-d.@: si le taquet courant est le taquet N°@var{n}, alors, en
+supposant qu'il y ait au moins @math{@var{n}+2} taquets définis, on
+passe au taquets N°@math{@var{n}+1}, sinon cette commande provoque une
+erreur.
@item \<
-Place le texte qui suit à la gauche de la marge locale (sans changer
-cette marge). Ne peut être utilisé qu'au début d'une ligne.
+Change le taquet courant au taquet précédent dans l'ordre logique. Cette
+commande ne peut être utilisée qu'au début d'une ligne tabulée, et que
+lorsque le taquet de début de ligne courant est le taquet N°@var{n} avec
+@math{@var{n}>0}. Le taquet courant devient alors le taquet
+N°@math{@var{n}-1}.
+
+Il est en fait possible d'avoir @var{m} commandes @code{\<} consécutives
+à condition que @math{@var{m}@leq{}@var{n}}, le taquet courant devient
+alors le taquet N°@math{(@var{n}-@var{m})}. Si par contre
+@math{@var{m}>@var{n}}, alors la @math{@var{n}+1} commande @code{\<}
+provoque une erreur.
+
+Il est possible, même si c'est absurde, d'avoir ensuite des commandes
+@code{\>} qui défont ce qu'on fait les commandes @code{\<}. Ainsi en
+supposant qu'au début d'une ligne tabulée le taquet de début de ligne
+courant soit le taquet N°2, faire commencer la ligne par @code{\<\<\>\>}
+n'a aucun effet. Par contre, @code{\<\<\<\>\>\>} provoquera une erreur,
+parce que la troisième commande @code{\<} est illicite. Dans les mêmes
+conditions faire @code{\<\>\<\>} provoque également une erreur, car la
+seconde commande @code{\<} n'est pas consécutive de la première, elle
+n'est donc pas, au sens où on l'entend, utilisée en début de ligne.
@item \+
-Déplace la marge de gauche d'un taquet vers la droite pour la ligne
-suivante et toutes celles qui suivent.
+Change le taquet de début de ligne courant au taquet suivant dans
+l'ordre logique pour la ligne tabulée suivante, et toutes celles qui
+suivent tant qu'une autre commande ne vient pas le modifier. La notion
+de taquet suivant dans l'ordre logique suit le même principe que pour la
+commande @code{\>}, c'est à dire que s'il n'y a que @math{@var{n}+1}
+taquets défini, et que le taquet de début de ligne courant est le taquet
+N°@var{n}, alors cette commande provoque une erreur. La commande
+@code{\+} peut être invoquée n'importe où dans la ligne tabulée, et on
+peut avoir plusieurs commandes @code{\+} au sein de la même ligne, du
+moment que pour chacune d'elle un nombre suffisant de taquets est déjà
+défini. Par exemple le code suivant provoque une erreur parce que bien
+qu'à la fin de la première on ait trois taquets définis, au moment où la
+commande @code{\+} 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 :
+@smallexample
+\begin@{tabbing@}
+Vive \+\=la \=France\\
+Vive \>la\>République\\
+\end@{tabbing@}
+@end smallexample
+En revanche le code suivant fonctionne, car lorsque la commande
+@code{\+} 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.
+@smallexample
+\begin@{tabbing@}
+Vive \=la \=France\+\\
+Vive \>la\>République\\
+\end@{tabbing@}
+@end smallexample
+C'est pourquoi l'usage est que la ou les commandes @code{\+} sont
+toujours invoquées juste avant la fin de ligne @code{\\} ou @code{\kill}.
+Il est possible, même si cela est absurde, d'avoir sur la même ligne à
+la fois des commandes @code{\+} et @code{\-} s'annulant l'une l'autre,
+du moment qu'aucune d'elle ne fasse passer sur un taquet non défini.
+
@item \-
-Déplace la marge de gauche d'un taquet vers la gauche pour la ligne
-suivante et toutes celles qui suivent.
+Change le taquet de début de ligne courant au taquet précédent dans
+l'ordre logique pour la ligne tabulée suivante, et toutes celles qui
+suivent tant qu'une autre commande ne vient pas le modifier. C'est à
+dire que si le taquet de début de ligne courant est le taquet N°@var{n},
+et qu'on a @var{m} commandes @code{\-} avec @math{@var{m}@geq{}@var{n}},
+alors le taquet de début de ligne courant de la ligne suivante devient
+le taquet N°@math{@var{n}-@var{m}}. Par contre, si
+@math{@var{m}>@var{n}}, alors la @math{(@var{n}+1)}ième commande
+@code{\+} provoque une erreur.
@item \' @r{(tabbing)}
Déplace tout ce que vous avez tapé jusqu'alors dans la colonne courante,
c.-à-d.@: tout ce qui suit la plus récente commande @code{\>},
-@code{\<}, @code{\'}, @code{\\}, ou @code{\kill}, à la droite de la
-colonne précédente, aligné à droite sur le taquet de la colonne
-courante.
+@code{\<}, @code{\'}, @code{\\}, ou @code{\kill}, aligné à droite dans
+la colonne précédente, le fer à droite étant espacé du taquet courant
+d'une longueur @code{\tabbingsep}. Voir aussi @code{\`}.
@item \` @r{(tabbing)}
-Vous perme de placer du texte justifié à droite sur n'importe quel
-taquet, y compris le taquet 0. Toutefois, ne peut pas placer du texte à
-la droite de la dernière colonne parce qu'il n'y a pas de taquet à cet
-endroit. La commande @code{\`} déplace tout le texte qui la suit,
-jusqu'à la commande @code{\\} ou @code{\end@{tabbing@}} qui termine la
-ligne.
+Vous permet de placer du texte justifié à droite en face de n'importe
+quel taquet, y compris le taquet 0. Les commandes @code{\`} et @code{\'}
+alignent toutes deux le texte à droite, toutefois elles se distinguent
+fortement par deux aspects :
+@itemize
+@item
+Tout d'abord le texte qui est déplacé est, dans le cas de @code{\`}, le
+texte qui suit la commande @code{\`} et qui va jusqu'à la fin de la
+ligne tabulée, c.-à-d.@: jusqu'à @code{\\} ou @code{\end@{tabbing@}}.
+Il ne doit y avoir aucune commande @code{\>} ou @code{\'} entre le
+@code{\`} et la commande @code{\\} ou @code{\end@{tabbing@}} qui termine
+la ligne. Dans le cas de la commande @code{\'} au contraire, c'est le
+texte qui précède la commande @code{\'}.
+@item
+Par ailleurs, avec @code{\'} l'alignement se fait sur un taquet et avec
+un espacement relatif de @code{\tabbingspace}, alors qu'avec @code{\`}
+l'alignement se fait sur la marge de droite et sans espacement relatif.
+@end itemize
@item \a @r{(tabbing)}
-@findex \a' @r{(acute accent in tabbing)}
-@findex \a` @r{(grave accent in tabbing)}
-@findex \a= @r{(macron accent in tabbing)}
+@findex \a' @r{(aigu, accent dans tabbing)}
+@findex \a` @r{(grave, accent dans tabbing)}
+@findex \a= @r{(macron, accent dans tabbing)}
Dans un environnement @code{tabbing}, les commandes @code{\=}, @code{\'}
et @code{\`} ne produisent pas d'accents comme d'habitude
(@pxref{Accents}). À leur place, on utilise les commandes @code{\a=},
@@ -4414,30 +6079,157 @@ Restaure les positions de taquets sauvegardés par le dernier
@code{\pushtabs}.
@item \pushtabs
-Sauvegarde positions courantes de tous les taquets. C'est utile pour
-changer temporairement les positions de taquets au milieu d'un
-environnement @code{tabbing}.
+Sauvegarde dans une pile dédiée à cet effet le motif courant de taquets
+de tabulation. C'est utile pour changer temporairement les positions de
+taquets au milieu d'un environnement @code{tabbing}. Après un
+@code{\pushtabs}, on a un nouveau motif vierge, c.-à-d.@: ne contenant
+qu'un seul taquet, le taquet N°0 à la position de début de ligne. Pour
+toute commande @code{\pushtabs} il doit y avoir une commande
+@code{\poptabs} avant la fin de l'environnement, c'est à dire que la
+pile doit être explicitement vidée avant le @code{end@{tabbing@}}.
+
@item \tabbingsep
-Distance à la gauche d'un taquet déplacé par @code{\'}.
+Distance du texte déplacé par @code{\'} à la gauche du taquet courant.
@end ftable
-Cet exemple compose un fonction en Pascal function dans un format
-traditionnel :
+Il est à noter que les espaces en début de ligne, où après @code{\=},
+@code{\>} ou @code{\<} sont gobés, qu'il s'agisse d'espaces produits par
+la macro @code{\space} ou par le caractère espace. Par contre l'espace
+produit par la le caractère de contrôle espace (@code{\@w{ }}, c.-à-d.@:
+une contr'oblique suivie d'un caractère espace) n'est pas gobé.
+
+Cet exemple compose un fonction en Pascal dans un format traditionnel :
@example
+@{\ttfamily
\begin@{tabbing@}
-function \= fact(n : integer) : integer;\\
- \> begin \= \+ \\
- \> if \= n $>$ 1 then \+ \\
- fact := n * fact(n-1) \- \\
- else \+ \\
- fact := 1; \-\- \\
+function \= fact(n : integer) : integer;\+\\
+ begin \=\+\\
+ if \= n $>$ 1 then\+\\
+ fact := n * fact(n-1)\-\\
+ else\+\\
+ fact := 1;\-\-\\
end;\\
-\end@{tabbing@}
+\end@{tabbing@}@}
+@end example
+
+Le résultat ressemble à cela :
+@example
+function fact(n : integer) : integer;
+ begin
+ if n > 1 then
+ fact := n * fact(n-1);
+ else
+ fact := 1;
+ end;
+@end example
+
+@PkgIndex{algorithm2e}
+@PkgIndex{listings}
+Ceci n'était qu'un exemple illustrant @code{tabbing}, pour formatter du
+code considérez plutôt les paquetages @file{algorithm2e} pour du
+pseudo-code, et @code{listings} pour du vrai code.
+
+Voici un autre exemple où le taquet N°2 est entre le taquet N°0 et le
+taquet N°1 :
+
+@example
+@{\ttfamily
+\begin@{tabbing@}
+ 12\=34\=\kill
+ 12345678\=9\\
+ 1\>2\>3\\
+\end@{tabbing@}@}
@end example
+Le résultat ressemble à cela :
+@example
+123456789
+1 3 2
+@end example
+
+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 @code{_} ou
+un caractère @code{@minus{}}. Evidemment ce n'est qu'une illustration de
+la flexivilité des taquets, et non une méthode convenable pour souligner
+ou barrer un mot, d'un part parce que @code{tabbing} en soi commençant
+un nouveau paragraphe ne permet pas d'agir sur un seul mot, et d'autre
+part, parce que le paquetage @code{soul} fait cela beaucoup mieux.
+@PkgIndex{soul}
+
+@example
+@{\ttfamily
+\begin@{tabbing@}
+ \=souligne \=\=\kill
+ soulign\a'e\>
+ \_@{@}\_@{@}\_@{@}\_@{@}\_@{@}\_@{@}\_@{@}\_@{@}\>
+ barr\a'e\>@{--@}@{--@}@{--@}@{--@}@{--@}@{--@}\\
+\end@{tabbing@}@}
+@end example
+
+@iftex
+Le résultat ressemble à cela (la police utilisée dans ce document pour les exemples
+n'est pas ici la mieux adaptée) :
+
+@tex
+{\def\underscore{\hbox to 0.5em{\_{}}}%
+\def\line#1{\leavevmode\hbox{#1}}%
+\nonfillstart\tt\setupmarkupstyle{example}%
+\gobble
+\line{\hbox{soulign\'e}\kern-4em%
+\hbox{\underscore\underscore\underscore\underscore%
+\underscore\underscore\underscore\underscore}\space\space%
+\hbox{barr\'e}\kern-2.5em%
+{-}{-}{-}{-}{-}}
+}
+@end tex
+@end iftex
+
+Finalement, voici un exemple où on a placé le taquet N°5 décalé d'une
+longueur @code{\tabbingsep} à droite de la marge de droite.
+
+@example
+@{\ttfamily
+\begin@{tabbing@}
+\hspace@{1cm@}\=\hspace@{1cm@}\=\hspace@{1cm@}\=\hspace@{1cm@}\=
+ \hspace@{\dimexpr\linewidth-4cm+\tabbingsep@}\=\kill
+1\>2\>X\'3\>4\>5\>\a`a gauche de de la marge de droite
+ avec \textbackslash'\'\\
+1\>2\>X\'3\>4\>5\`\a`a gauche de de la marge de droite
+ avec \textbackslash`\\
+\end@{tabbing@}@}
+@end example
+
+Le résultat ressemble à cela :
+
+@iftex
+@tex
+{\def\item#1{\hbox to 1cm{#1}}%
+\def\itemii#1#2{\hbox to 1cm{#1\filskip#2\hskip5pt}}%
+\def\line#1{\leavevmode\hbox to 13.95cm{#1}}%
+\def\filskip{\hskip 0pt plus 1fil}%
+\nonfillstart\tt\setupmarkupstyle{example}%
+\gobble
+%\line{012345678901234567890123456789012345678901234567890123456789}
+\line{\item1\itemii2X\item3\item4\item5%
+ \filskip\`a gauche de la marge de droite avec \backslashchar'}
+\line{\item1\itemii2X\item3\item4\item5%
+ \filskip\`a gauche de la marge de droite avec \backslashchar`}
+}%
+@end tex
+@end iftex
+@ifnottex
+@example
+@c 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 \`
+@end example
+@end ifnottex
+
@node table
@section @code{table}
@@ -4449,7 +6241,7 @@ Synopsis :
@example
\begin@{table@}[@var{placement}]
- @var{corps-du-talbeau}
+ @var{corps-du-tableau}
\caption[@var{titreldt}]@{@var{titre}@}
\end@{table@}
@end example
@@ -4471,8 +6263,8 @@ L'étiquette est optionnelle ; elle est utilisée pour les double renvois
@findex \caption
La commande @code{\caption} spécifie la légende @var{texte} pour la
figure. La légende est numérotée par défaut. Si @var{titreldt} est
-présent, il est utilisé dans la liste des talbeaux au lieu de @var{titre}
-(@pxref{Tables of contents}).
+présent, il est utilisé dans la liste des tableaux au lieu de @var{titre}
+(@pxref{Table of contents etc.}).
@example
\begin@{table@}[b]
@@ -4529,9 +6321,9 @@ beaucoup des caractéristiques.
Le format vertical de deux colonnes alignées à gauche, avec une barre
verticales entre elles, est spécifié par l'argument @code{@{l|l@}} de @code{tabular}.
-@findex &
+@findex & @r{pour cellules de tableau}
Les colonnes sont séparées avec une esperluette @code{&}. On crée un
-filet horizontal entre deux ligne avec @code{\hline}.
+filet horizontal entre deux lignes avec @code{\hline}.
@findex \\ @r{pour @code{tabular}}
La fin de chaque ligne est marquée avec une
double-contr'oblique @code{\\}. Cette @code{\\} est optionnelle après
@@ -4663,8 +6455,8 @@ sont pas permis au sein d'une telle cellule, sauf à l'intérieur d'un
environnement comme @code{minipage}, @code{array}, ou @code{tabular},
ou à l'intérieur d'une @code{\parbox} explicite, ou dans la portée d'une
déclaration @code{\centering}, @code{\raggedright}, ou
-@code{\raggedleft} (quand elles sont utilisée au sein d'une cellule de
-colonne en @code{p} ces déclaration doivent apparaître entre accolade,
+@code{\raggedleft} (quand elles sont utilisées au sein d'une cellule de
+colonne en @code{p} ces déclarations doivent apparaître entre accolades,
comme dans @code{@{\centering .. \\ ..@}}. Sans quoi @LaTeX{} prendra la
double contr'oblique comme une fin de ligne.
@@ -4691,7 +6483,7 @@ peut la changer comme dans
@item \arraystretch
Un facteur par lequel l'espacement entre les lignes au sein des
-environnement @code{tabular} et @code{array} est multiplié. La valeur
+environnements @code{tabular} et @code{array} est multiplié. La valeur
par défaut est @samp{1} pour aucune dilatation/contraction. On peut la
changer comme dans @code{\renewcommand@{\arraystretch@}@{1.2@}}.
@@ -4878,15 +6670,32 @@ Synopsis :
L'environnement @code{thebibliography} produit une bibliographie ou une
liste de références.
-Dans la classe @code{article}, cette liste de références est intitulée
-« Réferences » ; dans la classe @code{report}, elle est intitulée
-« Bibliographie ». Vous pouvez changer le titre (dans les classes standardes)
-en redéfinissant la commande @code{\refname}. Par exemple, cela
-l'élimine complètement :
+Dans la classe @code{article}, cette liste de références est intitulée
+@samp{Références} et ce titre est stocké dans la macro @code{\refname} ;
+dans la classe @code{report}, elle est intitulée @samp{Bibliographie} et
+ce titre est stocké dans la macro @code{\bibname}.
-@example
-\renewcommand@{\refname@}@{@}
-@end example
+Vous pouvez changer le titre en redéfinissant celle des commandes
+@code{\refname} ou @code{\bibname} qui est applicable selon la classe :
+
+@itemize
+@item
+@findex \bibname
+Pour les classes standardes dont le niveau le plus élevé de rubricage
+est @code{\chapter} le titre est dans la macro @code{\bibname}, par
+exemple les classes @file{book} et @file{report} tombent dans cette
+catégorie.
+@item
+@findex \refname
+Pour les classes standardes dont le niveau le plus élevé de rubricage
+est @code{\section} le titre est dans la macro @code{\refname}, par
+exemple la classe @file{article} tombe dans cette catégorie.
+@end itemize
+
+@PkgIndex{babel}
+Typiquement il n'est ni nécessaire ni désirable de redéfinir directement
+@code{\refname} ou @code{\bibname} ; les paquetages linguistiques comme
+@file{babel} s'en chargent.
L'argument obligatoire @var{étiquette-la-plus-large} est un texte qui,
lorsqu'il est composé, est aussi large que la plus large des étiquettes
@@ -5089,8 +6898,8 @@ par exemple le caractère @code{\} produit @samp{\} à l'impression . Il,
fait de @LaTeX{} une machine à écrire, c.-à-d.@: que le retour chariot
et les blancs y ont un tel effet.
-L'environnement @code{verbatim} utilise une police de type machine à
-écrire à chasse fixe (@code{\tt}).
+L'environnement @code{verbatim} utilise une police de type tapuscrit
+(encore appelé « machine à écrire ») à chasse fixe (@code{\tt}).
@menu
* \verb:: La forme macro de l'environnement @code{verbatim}.
@@ -5423,19 +7232,22 @@ page. D'ordinaire ceci se produit automatiquement, mais parfois on peut
désirer influencer les sauts.
@menu
-* \cleardoublepage:: Commence une nouvelle page de droite.
-* \clearpage:: Commence une nouvelle page.
+* \clearpage & \cleardoublepage:: Commence une nouvelle page de droite ; éjecte les flottants.
* \newpage:: Commence une nouvelle page.
* \enlargethispage:: Agrandit d'un peu la page courante.
* \pagebreak & \nopagebreak:: Forcer & éviter les sauts de page.
@end menu
-@node \cleardoublepage
-@section @code{\cleardoublepage}
+@node \clearpage & \cleardoublepage
+@section @code{\clearpage} & @code{\cleardoublepage}
+@c xx Revoir la traduction
@findex \cleardoublepage
@cindex commencer une page de droite
+@findex \clearpage
+@cindex débourrer les flottant et commencer une page
+@cindex commencer une nouvelles page et débourrer les flottant
La commande @code{\cleardoublepage} finit la page courante et fait que
@LaTeX{} imprime tous les flottants, tableaux et figures, qui sont
@@ -5445,11 +7257,6 @@ et une page de droite (numérotée impaire), en produisant si nécessaire
une page à blanc.
-@node \clearpage
-@section @code{\clearpage}
-@findex \clearpage
-@cindex débourrer les flottant et commencer une page
-@cindex commencer une nouvelles page et débourrer les flottant
La commande @code{\clearpage} finit la page actuelle et fait que
@LaTeX{} imprime tous les flottants, tableaux et figures, qui sont
@@ -5462,8 +7269,43 @@ apparus en entrée jusqu'à ce point et sont en attente.
@cindex nouvelle page, commencer
@cindex commencer une nouvelle page
-La commande @code{\newpage} finit la page courante, mais ne débourre pas
-tous les flottants (@pxref{\clearpage}).
+Synopsis :
+
+@example
+\newpage
+@end example
+
+La commande @code{\newpage} finit la page courante. Cette commande est
+robuste (@pxref{\protect}).
+
+Les sauts de page de @LaTeX{} sont optimisés de sorte que d'ordinaire on
+n'utilise cette commande dans le corps d'un document que pour les
+finitions sur la version finale, ou à l'interieur de commandes.
+
+Alors que les commandes @code{\clearpage} et @code{\cleardoublepage}
+finissent également la page courante, en plus de cela elles débourrent
+les flottants pendants (@pxref{\clearpage & \cleardoublepage}). Et, si
+@LaTeX{} est en mode à deux colonne alors @code{\clearpage} et
+@code{\cleardoublepage} finissent las page courante en laissant
+possiblement une colonne vide, alors que @code{\newpage} finit seulement
+la colonne courante.
+
+Contrairement à @code{\pagebreak} (@pxref{\pagebreak & \nopagebreak}),
+la commande @code{\newpage} n'a pas pour effet que la nouvelle page
+commence exactement là où la requête est faite. Dans l'exemple suivant
+
+@example
+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.
+@end example
+
+@noindent
+la nouvelle page commence après @samp{continent}, et la ligne où se
+produit le saut n'est pas justifiée à droite. De plus, @code{\newpage}
+n'étire pas verticalement la page, contrairement à @code{\pagebreak}.
@node \enlargethispage
@@ -5633,7 +7475,7 @@ Synopsis :
Sans l'argument optionnel, la commande @code{\footnotemark} 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 @code{\footnotetext}.
+note séparément la commande @code{\footnotetext}.
Cette commande pour produire plusieurs marque de note en bas de page
faisant référence à la même note avec
@@ -5790,6 +7632,9 @@ des genres.
@menu
* \newcommand & \renewcommand:: (Re)définir une nouvelle commande.
+* \providecommand:: Définir une commande, si le nom n'est pas utilsé.
+* \makeatletter et \makeatother: \makeatletter & \makeatother. Change la catégorie du caractère arobe.
+* \@@ifstar:: Définir vos propres commandes étoilées.
* \newcounter:: Définir un nouveau compteur.
* \newlength:: Définir une nouvelle longueur.
* \newsavebox:: Définir une nouvelle boîte.
@@ -5818,11 +7663,18 @@ Synopsis :
\renewcommand*@{\@var{cmd}@}[@var{nargs}][@var{optargdéfaut}]@{@var{défn}@}
@end example
+@c xxx Revoir la trad.
+Définit ou redéfinit une commande (voir aussi la discussion de
+@code{\DeclareRobustCommand} dans @ref{Class and package commands}).
+
@cindex forme en *, définir de nouvelles commandes
@cindex forme étoilée, définir de nouvelles commandes
-La forme étoilée (en @code{*}) de ces commandes exige que les arguments
-ne contiennent pas de paragraphes de texte (la commande n'est pas
-@code{\long}, dans la terminologie de @TeX{} de base).
+@findex \long
+La forme étoilée (en @code{*}) de ces commandes interdit que les
+arguments contiennent une multiplicité de paragraphes de texte (la
+commande n'est pas @code{\long}, dans la terminologie de
+@value{PlainTeX}). Avec la forme par défaut, il est possible qu'un
+argument soit une multiplicité de paragraphes.
@table @var
@item cmd
@@ -5858,10 +7710,10 @@ cas, tout argument obligatoire sera désigné en commençant par @code{#2}.
Omettre @code{[@var{maval}]} dans un appel n'est pas la même chose
qu'avoir les crochets ne contenant rien, comme dans @code{[]}. Dans le
premier cas le paramètre @code{#1} se développe en @var{optargdéfaut} ;
-alors que dans le secon @code{#1} se développe en une chaîne vide.
+alors que dans le second @code{#1} se développe en une chaîne vide.
@item défn
-Le texte par lequel substituer chaque occurrence de \@code{cmd} ; le
+Le texte par lequel substituer chaque occurrence de @code{\@var{cmd}} ; le
paramètre positionnel @code{#@var{n}} au sein de @var{défn} est
remplacée par le texte passé comme @var{n}ième argument.
@@ -5921,16 +7773,191 @@ la définition et par conséquent définissent bien un groupe.
-@c xx \providecommand, * forme (non-\long)
+@node \providecommand
+@section @code{\providecommand}
+
+@findex \providecommand
+@cindex commandes, définir de nouvelles
+@cindex définir une nouvelle commande
+@cindex nouvelles commandes, définir
+
+Définit une commande, du moment qu'aucune commande de même nom n'existe déjà.
+
+Synopsis :
+
+@example
+\providecommand@{@var{cmd}@}[@var{nargs}][@var{optargdéfaut}]@{@var{defn}@}
+\providecommand*@{@var{cmd}@}[@var{nargs}][@var{optargdéfaut}]@{@var{defn}@}
+@end example
+
+Si aucune commande de ce nom n'existe alors ceci a le même effet que
+@code{\newcommand} (@pxref{\newcommand & \renewcommand}). 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'être chargé plus d'une fois.
+
+@node \makeatletter & \makeatother
+@section @code{\makeatletter} et @code{\makeatother}
+
+Synopsis :
+
+@example
+\makeatletter
+ ... définition de commande comprenant @@ dans leur nom ..
+\makeatother
+@end example
+
+Utilisez cette paire de commande quand vous redéfinissser les commandes
+@LaTeX{} dont le nom comprend un caractère arobe @code{@@}. La
+déclaration @code{\makeatletter} a pour effet que le caractère
+arobase @code{@@} ait le code de catégorie des lettres, c.-à-d.@: 11. La
+déclaration @code{\makeatother} règle de code de catégorie de @code{@@}
+à 12, sa valeur d'origine.
+
+À mesure que chaque caractère est lu par @TeX{} pour @LaTeX{}, un code
+de catégorie lui est assigné. On appelle aussi ce code
+@cindex catcode
+@cindex code de catégorie de caractère
+@cindex catégorie, code de caractère
+@dfn{catcode} pour faire court. Par exemple, la contre-oblique @code{\}
+reçoit le catcode 0. Les noms de commande consistent en un caractère de
+catégorie 0, d'ordinaire une contr'oblique, suivi par des lettres,
+c-à-d.@: des caractères de catégorie 11 (à ceci près qu'une commande
+peut également consister en un caractère de catégorie 0 suivi d'un
+unique caractère qui n'est pas une lettre).
+
+Le code source de @LaTeX{} suit la convention que certaines commandes
+utilisent @code{@@} 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'un paquetage ou d'une
+classe de remplacer accidentellement une telle commande par une commande
+définie par eux, puisque par défaut l'arobe a le catcode 12 (other).
+
+Utilisez la paire @code{\makeatletter} et @code{\makeatother} au sein
+d'un fichier @file{.tex}, typiquement dans le préambule, quand vous
+définissez ou redéfinissez des commandes dont le nom comprend @code{@@},
+en entourant votre définition par elles. Ne les utilisez pas au sein de
+fichiers @file{.sty} ou @file{.cls} puisque les commandes
+@code{\usepackage} et @code{\documentclass} font déjà le nécessaire pour
+que l'arobe ait le catcode d'une lettre, à savoir 11.
+
+@PkgIndex{macros2e}
+Pour une liste complète des macros contenant une arobase dans leur nom,
+voir le document @url{http://ctan.org/pkg/macros2e}.
+@c xx pourquoi est-ce que ceci a été enlevé :
+@c xx Ces macros sont surtout à l'intention des auteurs de classes et de
+@c xx paquetages.
+
+Dans l'exemple suivant une commande @code{\these@@nomuniversite} se
+trouve dans le fichier de classe, et l'utilisateur veut changer sa
+définition. Pour cela, il suffit d'insérer les trois lignes suivantes
+dans le préambule, avant le @code{\begin@{document@}} :
+
+@example
+\makeatletter
+\renewcommand@{\these@@nomuniversite@}@{Université Lyon III Jean Moulin@}
+\makeatother
+@end example
+
+
+@node \@@ifstar
+@section @code{\@@ifstar}
+
+@findex \@@ifstar
+@cindex commandes, variantes étoilées
+@cindex étoilées, variantes de commandes
+
+
+@c Inpirée des trucs & astuces de Manuel Pégourié-Gonnard
+@c (https://elzevir.fr/imj/latex/tips.html#stared)
+
+Vous l'avez sans doute remarqué, beaucoup d'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.
+
+Si vous avez lu @ref{\newenvironment & \renewenvironment}, vous aurez compris
+que c'est immédiat pour les environnements car l'étoile est un caractère
+autorisé dans les noms d'environnements. Il vous suffit donc de faire
+@code{\newenvironment@{@var{monenv}@}} et
+@code{\newenvironment@{@var{monenv}*@}} avec les définitions souhaitées.
+
+Pour les commandes, c'est plus compliqué car l'é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'une étoile et d'adapter son
+comportement en conséquence. Cette première commande ne pourra pas accepter
+d'argument, mais pourra faire appel à des commandes qui en acceptent. Par
+ailleurs, on utilise la commande @code{\@@ifstar} interne du noyau @LaTeX{} et
+vous pouvez vous reportez à « @ref{\makeatletter & \makeatother} » pour
+comprendre pourquoi cela implique l'usage d'un bloc
+@code{\makeatletter...\makeatother}.
+
+Dans cet exemple, on définit @code{\ciel} comme une commande avec un
+argument obligatoire et admettant une variante étoilée @code{\ciel*}
+également avec un argument obligatoire :
+
+@example
+\makeatletter
+\newcommand*\ciel@@starred[1]@{ciel #1 étoilé@}
+\newcommand*\ciel@@unstarred[1]@{ciel #1 non étoilé@}
+\newcommand\ciel@{\@@ifstar@{\ciel@@starred@}@{\ciel@@unstarred@}@}
+\makeatother
+@end example
+
+@noindent ainsi, @code{\ciel@{bleu@}} composera « ciel bleu non étoilé » tandis que
+@code{\ciel*@{nocturne@}} composera « ciel nocturne étoilé ».
+
+Notez que les commandes intermédiaires @code{\ciel@@starred} et
+@code{\ciel@@unstarred} comportent un @code{@@} dans leur nom ce qui est
+possible puisque elles apparaissent au sein d'un bloc
+@code{\makeatletter...\makeatother}. Ceci assure qu'elles ne puissent pas être
+utilisées directement dans le document. L'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
+@code{\newcommand*@{\@var{cmd}@}} vérifie que si la commande @code{\@var{cmd}}
+n'est pas déjà définie et génère une erreur si c'est le cas.
+
+Voici un autre exemple, où la commande @code{\agentsecret} comporte deux
+arguments, tandis que sa variante étoilée @code{\agentsecret*} n'en présente qu'un seul :
+
+@example
+\makeatletter
+\newcommand*\agentsecret@@starred[1]@{\textsc@{#1@}@}
+\newcommand*\agentsecret@@unstarred[2]@{\textit@{#1@} \textsc@{#2@}@}
+\newcommand\agentsecret@{\@@ifstar@{\agentsecret@@starred@}
+@ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @{\agentsecret@@unstarred@}@}
+\makeatother
+@end example
+
+@noindent Avec cette définition, la célèbre réplique de l'agent 007 :
+
+@example
+Je m'appelle \agentsecret*@{Bond@}, \agentsecret@{James@}@{Bond@}.
+@end example
+
+@noindent est équivalente à :
+
+@example
+Je m'appelle \textsc@{Bond@}, \textit@{James@} textsc@{Bond@}.
+@end example
+
+Un dernier mot :
+dans le nom d'une commande, l'étoile est comme une sorte d'argument optionnel.
+Ceci est différent des noms d'environnement, où l'étoile fait partie
+du nom lui-même, et peut donc être à n'importe quelle position !
+D'un point de vue purement @TeX{}nique il est donc possible de mettre un nombre indéfini
+d'espaces entre la commande et l'étoile. Ainsi @code{\agentsecret*@{Bond@}} et
+@code{\agentsecret *@{Bond@}} sont équivalents. Toutefois la pratique commune
+est de ne jamais insérer de tels espaces.
@node \newcounter
-@section @code{\newcounter}
+@section @code{\newcounter} : allouer un compteur
@findex \newcounter
@cindex compteurs, définir de nouveaux
Synopsis :
@example
+\newcounter@{@var{nomcompteur}@}
\newcounter@{@var{nomcompteur}@}[@var{super}]
@end example
@@ -5945,37 +7972,44 @@ nommé @var{super}.
@node \newlength
-@section @code{\newlength}
+@section @code{\newlength} : allouer une longueur
@findex \newlength
-@cindex longueurs, définir de nouvelles
+@cindex longueurs, allouer de nouvelles
+@cindex longueurs élastiques, définir de nouvelles
+@cindex élastiques, définir de nouvelles longueurs
+@cindex pas, registre de, @value{PlainTeX}
+@cindex ressort, registre de, @value{PlainTeX}
-Synopsis :
+Alloue un nouveau registre de @dfn{longueur}. Synopsis :
@example
\newlength@{\@var{arg}@}
@end example
-La commande @code{\newlength} définit l'argument obligatoire comme une
-commande de @dfn{longueur} avec une valeur de @code{0mm}. L'argument
-doit être une séquence de contrôle, comme dans
-@code{\newlength@{\foo@}}. Une erreur se produit si @code{\foo} est déjà
-défini.
+Cette commande prnedre un argument obligatoire qui doit commencer par
+une contr'oblique (@samp{\}). Elle crée un nouveau registre de longueur
+nommé @code{\@var{arg}}, ce qui constitue un emplacement où détenir des
+longueurs (élastiques) telles que @code{1in plus.2in minus.1in} (ce que
+@value{PlainTeX} appelle un registre @code{skip}, ou regristre de
+pas). Le registre est crée avec une valeur initiale de zéro. La séquence
+de contrôle @code{\@var{arg}} doit ne pas être déjà définie.
-@xref{Lengths}, pour comment régler la nouvelle longeur à une valeur non
-nulle, et pour plus d'information à propos des longueurs en général.
+@xref{Lengths}, pour plus d'information à propos des longueurs.
@node \newsavebox
-@section @code{\newsavebox}
+@section @code{\newsavebox} : allouer une boîte
+
@findex \newsavebox
+@cindex boîte, allouer une nouvelle
-Synopsis :
+Alloue un « baquet » pour détenir une boîte. Synopsis :
@example
\newsavebox@{\@var{cmd}@}
@end example
-Définit @code{\@var{cmd}} pour se référer à un nouveau bac pour stocker
+Définit @code{\@var{cmd}} 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'utiliser plusieurs fois (@pxref{Boxes}) ou pour le mesurer ou le
manipuler. Le nom @code{\@var{cmd}} doit commencer par une
@@ -6046,7 +8080,7 @@ utilisé avec des crochets à la suite, comme dans
être suivi de crochet, alors, au sein de @var{défdébut}, le
@cindex paramètre positionnel
paramètre positionnel @code{#1} se développe en la valeur par défaut,
-c.-à-d.@: @var{optargdefault}. Dans les deux cas, le premier paramètre
+c.-à-d.@: @var{optargdéfaut}. Dans les deux cas, le premier paramètre
positionnel faisant référence à argument obligatoire est @code{#2}.
Omettre @code{[@var{maval}]} dans l'appel est différent d'avoir des
@@ -6346,8 +8380,8 @@ comme la table des matières. On appelle
@dfn{argument mouvant} 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'arguments mouvants sont ceut qui apparaissent
-au sein des commande @code{\caption@{...@}} (@pxref{figure}), dans la
+valide. Certains exemples d'arguments mouvants sont ceux qui apparaissent
+au sein des commandes @code{\caption@{...@}} (@pxref{figure}), dans la
commande @code{\thanks@{...@}} (@pxref{\maketitle}), et dans les
expression en @@ des environnements @code{tabular} et @code{array}
(@pxref{tabular}).
@@ -6376,7 +8410,7 @@ mystérieuse
Dans l'exemple suivant la commande @code{\tableofcontents} produit une
erreur à cause du @code{\(..\)} dans le titre de section qui se
développe en code incorrect @TeX{} dans le fichier @file{.toc}. Vous
-pouvez résoudre ceci en remplaçat @code{\(..\)}
+pouvez résoudre ceci en remplaçant @code{\(..\)}
par @code{\protect\(..\protect\)}.
@example
@@ -6504,13 +8538,32 @@ Synopsis :
\value@{@var{compteur}@}
@end example
-La commande @code{\value} produit la valeur de @var{compteur}. Ça peut
-être utilisé partout là où @LaTeX{} attend un nombre, par exemple :
+Cette commande se développe en la valeur de @var{compteur}. Elle est
+souvent utilisé dans @code{\setcounter} ou @code{\addtocoutner}, mais
+@code{\value} peut être utilisé partout là où @LaTeX{} attend un
+nombre. Elle ne doit pas être précédée par @code{\protect}
+(@pxref{\protect}).
+
+La commande @code{\value} n'est pas utiliser pour composer la valeur du
+compteur. @xref{\alph \Alph \arabic \roman \Roman \fnsymbol}.
+
+Cet exemple produit en sortie @samp{Le compteur essai vaut 6. Le
+compteur autre vaut 5}.
+
+@example
+\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@}.
+@end example
+
+Cet exemple insère @code{\hspace@{4\parindent@}}.
@example
-\setcounter@{moncompteur@}@{3@}
-\addtocounter@{moncompteur@}@{1@}
-\hspace@{\value@{moncompteur@}\parindent@}
+\setcounter@{moncptr@}@{3@} \addtocounter@{moncptr@}@{1@}
+\hspace@{\value@{moncptr@}\parindent@}
@end example
@@ -6576,10 +8629,134 @@ chaîne représentant le jour courant (@pxref{\today}).
@chapter Longueurs
@cindex longueurs, définir et utiliser
-@cindex longueur
-Une @dfn{longeur} est une mesure de distance. Beaucoup de commandes
+Une @dfn{longueur} est une mesure de distance. Beaucoup de commandes
@LaTeX{} prennent une longueur en argument.
+@cindex rigides, longueurs
+@cindex élastiques, longueurs
+@cindex dimen @r{@value{PlainTeX}}
+@cindex skip @r{@value{PlainTeX}}
+@cindex glue @r{@value{PlainTeX}}
+Il y a deux types de longueur. Une @dfn{longueur rigide} telle que
+@code{10pt} ne contient pas de composante en @code{plus} ou
+@code{minus}. (En @value{PlainTeX} on appelle cela une @dfn{dimen}).
+Une @dfn{longueur élastique} (ce qu'en @value{PlainTeX} on appel un
+@dfn{skip} ou une @dfn{glue}) telle que dans @code{1cm plus0.05cm
+minus0.01cm} peut contenir l'un ou l'autre de ces composantes ou les
+deux. Dans cette longueur élastique, le @code{1cm} est la @dfn{longueur
+naturelle} alors que les deux autres, les composantes en @code{plus} et
+@code{minus}, permette à @TeX{} à dilater ou contracter la longueur pour
+optimiser la disposition.
+
+Les exemples qui suivent utilisent ces deux commandes.
+
+@example
+% 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@}@}@}
+@end example
+
+@noindent
+Cet exemple utilise ces commandes pour afficher une barre noire de
+100 points de long entre @samp{XXX} et @samp{YYY}. Cette longueur est
+rigide.
+
+@example
+XXX\showhbox@{100pt@}@{\blackbar@{100pt@}@}YYY
+@end example
+
+Quant au longueur élastiques, la contraction est le plus simple des
+deux : avec @code{1cm minus 0.05cm}, la longueur naturelle est 1@dmn{cm}
+mais @TeX{} peut la contracter jusqu'à 0,95@dmn{cm}. @TeX{} refuse de
+contracter plus que cela. Ainsi, ci-dessous le premier @code{\showhbox}
+fonctionne bien, un espace de 98 points étant produit entre les deux
+barres.
+
+@example
+XXX\showhbox@{300pt@}@{%
+ \blackbar@{101pt@}\hspace@{100pt minus 2pt@}\blackbar@{101pt@}@}YYY
+
+XXX\showhbox@{300pt@}@{%
+ \blackbar@{105pt@}\hspace@{100pt minus 1pt@}\blackbar@{105pt@}@}YYY
+@end example
+
+@noindent
+Mais le second produit un avertissement du genre de @samp{Overfull
+\hbox (1.0pt too wide) detected at line 17}. En sortie le premier
+@samp{Y} est écrasé par la fin de la barre noire, parce que la matière
+contenue par la boîte est plus large que les 300@dmn{pt} alloués, et que
+@TeX{} a refusé de contracter le total en deçà de 309 points.
+
+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.
+
+@example
+XXX\showhbox@{300pt@}@{%
+ \blackbar@{95pt@}\hspace@{100pt plus 10pt@}\blackbar@{95pt@}@}YYY
+
+XXX\showhbox@{300pt@}@{%
+ \blackbar@{95pt@}\hspace@{100pt plus 1pt@}\blackbar@{95pt@}@}YYY
+@end example
+
+@noindent
+Dans la seconde ligne @TeX{} a besoin de dilater de 10 points alors que
+seulement 1 point a été spécifié. @TeX{} dilate l'espace jusqu'à la
+longueur requise mais il produit un avertissement du genre de
+@samp{Underfull \hbox (badness 10000) detected at line 22}. (On ne
+discute pas ici de ce que signifie « badness »).
+
+Il est possible de mettre à la fois de la dilatation et de la
+contraction dans la même longueur, comme dans @code{1ex plus 0.05ex
+minus 0.02ex}.
+
+Si @TeX{} ajuste plus d'une longueur élastique alors il alloue la
+dilatation ou la contraction proportionnellement.
+
+@example
+XXX\showhbox@{300pt@}@{%
+ \blackbar@{100pt@}% gauche
+ \hspace@{0pt plus 50pt@}\blackbar@{80pt@}\hspace@{0pt plus 10pt@}% milieu
+ \blackbar@{100pt@}@}YYY % droite
+@end example
+
+@noindent
+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 @code{\hspace} doivent se dilater de 20 points.
+Comme les deux sont @code{plus 50pt} et @code{plus 10pt}, @TeX{} obtient
+5/6 de la dilatation du premier espace et 1/6 du second.
+
+La composante @code{plus} ou @code{minus} d'une longueur élastique peut
+contenir un composante en @dfn{fill}, comme dans @code{1in plus2fill}.
+Cela donne à la longueur une dilatabilité ou contractabilité infinie de
+sorte que @TeX{} puisse l'ajuster à n'importe quelle distance. Dans
+l'exemple suivant les deux figures sont également espacées
+horizontalement sur la page.
+
+@example
+\begin@{minipage@}@{\linewidth@}
+ \hspace@{0pt plus 1fill@}\includegraphics@{godel.png@}%
+ \hspace@{0pt plus 1fill@}\includegraphics@{einstein.png@}%
+ \hspace@{0pt plus 1fill@}
+\end@{minipage@}
+@end example
+
+@TeX{} en réalité a trois niveaux d'infinité pour les composantes
+élastiques : @code{fil}, @code{fill}, et @code{filll} dans l'ordre
+d'infinité croissante. D'ordinaire les auteurs de documents n'utilisent
+que celle du milieu (@pxref{\hfill} et @pxref{\vfill}).
+
+Multiplier une longueur élastique par un nombre la transforme en une
+longueur rigide, de sorte qu'après @code{\setlength@{\ylength@}@{2.5cm
+plus 0.5cm@}} et @code{\setlength@{\zlength@}@{3\ylength@}} alors la
+valeur de @code{\zlength} est @code{2.5cm}.
+
+
@menu
* Unités de longueur: Units of length. Les unités que @LaTeX{} connaît.
* \setlength:: Règle la valeur d'une longueur.
@@ -6796,7 +8973,7 @@ commande de rubricage.
@menu
* \indent:: Renfoncer ce paragraphe.
* \noindent:: Ne pas renfoncer ce paragraphe.
-* \parskip:: L'espace ajouté avant les paragraphes.
+* \parindent & \parskip:: L'espace ajouté avant les paragraphes.
* Notes en marge: Marginal notes. Mettre des remarques dans la marge.
@end menu
@@ -6841,8 +9018,8 @@ Pour éliminer le renfoncement de paragraphe dans tout un document, mettez
@code{\setlength@{\parindent@}@{0pt@}} dans le préambule.
-@node \parskip
-@section @code{\parskip}
+@node \parindent & \parskip
+@section @code{\parindent} & @code{\parskip}
@findex \parskip
@cindex espace vertical avant les paragraphes
@@ -7002,9 +9179,9 @@ $\displaystyle \sum_@{n=0@}^\infty x_n $
@section Indices inférieurs & supérieurs
@cindex indice supérieur
@cindex indice inférieur
+@findex ^ @r{indice supérieur}
+@findex _ @r{indice inférieur}
@cindex exposant
-@findex _
-@findex ^
En mode mathématique, utilisez le caractère caret @code{^} pour qu'une
expression @var{exp} apparaisse en indice supérieur, c.-à-d.@: tapez
@@ -7068,7 +9245,6 @@ le mode, voir @ref{\ensuremath}.
@c xx Add Negation: @code{} for negations of relevant symbols
@c Useful: http://www.w3.org/TR/WD-math-970515/section6.html
-
@ftable @code
@item \|
@BES{∥,\|} Parallèle (relation). Synonyme : @code{\parallel}.
@@ -8655,7 +10831,7 @@ Synopsis :
La commande @code{\hspace} ajoute de l'espace horizontal. L'argument
@var{longueur} peut être exprimé en toute unité que @LaTeX{} comprend :
-points, pouces, etc.@: C'est une longueur elastique. Vous pouvez
+points, pouces, etc.@: C'est une longueur élastique. Vous pouvez
ajouter aussi bien de l'espace négatif que de l'espace positif avec une
commande @code{\hspace} ; ajouter de l'espace negatif revient à
retourner en arrière.
@@ -8750,7 +10926,7 @@ Certaines commandes, notamment celles définies avec le paquetage
@findex \nonfrenchspacing
@cindex espacement inter-phrase
-Cette déclaration (provenant de @TeX{} de base) cause que @LaTeX{}
+Cette déclaration (provenant de @value{PlainTeX}) cause que @LaTeX{}
traite l'espacement inter-phrase de la même façon que l'espacement inter-mot.
En justifiant le texte sur une ligne, certaine traditions typographique,
@@ -8766,7 +10942,7 @@ Revenez au comportement par défaut en déclarant
@section @code{\thinspace}
@findex \thinspace
-@code{\thinspace} produit une espace insécable et non-elastique qui vaut
+@code{\thinspace} produit une espace insécable et non-élastique qui vaut
1/6 d'@dmn{em}. C'est l'espace adéquate entre des guillemets anglais
simples emboîtés, comme dans '@dmn{}''.@c Abuse @dmn, which is a thin
@c space in Texinfo.
@@ -8820,7 +10996,7 @@ l'espacement y est fait d'une façon différente.
@findex \hrulefill
@findex \dotfill
-Produit une longueur elastique infinie (@pxref{Lengths}) remplie avec un
+Produit une longueur élastique infinie (@pxref{Lengths}) remplie avec un
filled filet horizontal (c.-à-d.@: une ligne) ou avec des pointillés, au
lieu de just de l'espace blanche.
@@ -8911,15 +11087,15 @@ rétrécissement (la valeur par défaut pour les classes @code{book} et
@cindex dilatation verticale infinie
@cindex verticale infinie, dilatation
-Finit le paragraphe courante et insère une longueur elastique verticale
+Finit le paragraphe courant et insère une longueur élastique verticale
(@pxref{Lengths}) qui est infinie, de sorte qu'elle puisse se dilater ou
-that is se rétrécire autant que nécessaire.
+se rétrécir autant que nécessaire.
On l'utilise souvent de la même façon que @code{\vspace@{\fill@}}, à
ceci près que @code{\vfill} finit le paragraphe courant, tandis que
-@code{\vspace@{\fill@}} ajoute une espace verticale infinin sous sa
+@code{\vspace@{\fill@}} 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 @ref{\vspace}.
Dans l'exemple qui suit la page est remplie, de sorte que les lignes en
@@ -9094,60 +11270,68 @@ contenir de l'espace dilatable pour que cela marche.
@node \parbox
@section @code{\parbox}
@findex \parbox
+@cindex paragraphe, mode
+@cindex paragraphe, dans une boîte
-Synopsis :
+
+Synopsis, l'un parmi les suivants :
@example
-\parbox[@var{position}][@var{hauteur}][@var{pos-interne}]@{@var{largeur}@}@{@var{texte}@}
+\parbox@{@var{largeur}@}@{@var{contenu}@}
+\parbox[@var{position}]@{@var{largeur}@}@{@var{contenu}@}
+\parbox[@var{position}][@var{hauteur}]@{@var{largeur}@}@{@var{contenu}@}
+\parbox[@var{position}][@var{hauteur}][@var{pos-interne}]@{@var{largeur}@}@{@var{contenu}@}
@end example
@cindex mode paragraphe
@cindex paragraphe, mode
-La commande @code{\parbox} produit une boîte dont le contenu est créé en
-@dfn{mode paragraphe}. On devrait l'utiliser pour fabriquer une boîte à
-partir de petits moreaux de texte, avec rien de trop élaboré à
-l'intérieur. En particulier, vous ne devriez utiliser aucun
-environnement de fabrication de paragraphe au sein de l'argument
-@var{texte} d'une @code{\parbox}. Pour des morceaux de texte de plus
-grande taille, y compris ceux comprenant un environnement de
-fabrication de paragraphe, vous devriez utiliser un environnement
-@code{minipage} (@pxref{minipage}).
-
-@code{\parbox} a deux arguments obligatoires :
+La commande @code{\parbox} produit une boîte de texte de largeur
+@code{largeur}. 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 (@pxref{\protect}).
-@table @var
-@item largeur
-la largeur de la parbox;
-@item texte
-le texte qui à mettre dans la parbox.
-@end table
-
-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'argument optionnel @var{position} est présent et
-vaut soit @samp{t} soit @samp{b}, cela vous permet respectivement
-d'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
-@var{position} à @samp{m} pour avoir le comportement par défaut.
-
-L'argument optionnel @var{hauteur} l'emporte sur la hauteur naturelle de la
-boîte.
-
-L'argument @var{pos-interne} contrôle la position du texte au sein de la
-boîte, comme suit ; s'il n'est pas spécifié, @var{position} est utilisé.
-
-@table @code
-@item t
-le texte est placé en haut de la boîte.
-@item c
-le texte est centré dans la boîte.
-@item b
-le texte est placé en bas de la boîte.
-@item s
-dilatation (stretch) verticale ; le texte doit contenir de l'espaces
-dilatable verticalement pour que cela fonctionne.
-@end table
+@example
+\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@}
+@end example
+Le @var{contenu} est taité en mode texte (@pxref{Modes}) ainsi
+@LaTeX{} fait des sauts de ligne de sorte à former un paragraphe. Mais
+il ne fabriquera pas plusieurs paragraphes ; pour cela, utilisez un
+environnement @code{minipage} (@pxref{minipage}).
+
+Les options d'une @code{\parbox} (à l'exception du @var{contenu}) sont
+les mêmes que pour une @code{minipage}. Par commodité on rappelle ces
+options ici plus bas, mais se référer à @ref{minipage} pour une
+description complète.
+
+Il y a deux arguments obligatoires. La @var{largeur} est une longueur
+rigide (@pxref{Lengths}). Elle règle la largeur de la boîte dans
+laquelle @LaTeX{} compose le @code{contenu}. Le @code{contenu} est le
+texte qui est placé dans cette boîte. Il ne devrait pas avoir de
+composants qui fabriquent des paragraphes.
+
+Il y a trois arguments optionnels, @var{position}, @var{hauteur}, et
+@var{pos-interne}. La @var{position} donne l'alignement vertical de la
+@dfn{parbox} relativement au texte alentour. La valeurs prises en charge
+sont @code{c} ou @code{m} pour que le centre selon la dimension
+verticale de la parbox soit aligné avec le centre de la ligne de texte
+adjacente (c'est le réglage par défaut), ou @code{t} pour s'accorder la
+ligne du haut de la parbox avec la ligne de base du texte alentour, ou
+@code{b} pour accorder la ligne du bas.
+
+L'argument optionnel @var{hauteur} l'emporte sur la hauteur naturelle de
+la boîte.
+
+L'argument optionnel @var{pos-interne} contrôle la position du
+@var{contenu} au sein de la parbox. Les valeurs possibles sont :
+@code{t} pour le centrer verticalement, @code{b} pour le place en bas de
+la boîte, et @code{s} pour le dilater verticalement (pour cela, le texte
+doit contenir de l'espace vertical eslastique).
@node \raisebox
@section @code{\raisebox}
@@ -9218,6 +11402,1394 @@ Synopsis :
@code{\usebox} produit la boîte la plus récemment sauvegardée dans le
bac @var{\boxcmd} par une commande @code{\savebox} (@pxref{\savebox}).
+@node Color
+@chapter Couleur
+
+@cindex couleur
+
+Vous pouvez colorer du texte, des filets, etc. Vous pouvez également
+colorer l'intérieur d'une boîte ou une page entière et écrire du texte
+par dessus.
+
+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
+@code{\usepackage@{color@}}, qui fournit le paquetage standard.
+
+Beaucoup d'autres paquetages complémentent également les possibilité de
+@LaTeX{} en matière de couleurs. Notamment @file{xcolor} est largement
+utilisé et étend significativement les possibilités décrites ici, y
+compris par l'ajout des modèles de couleur @samp{HTML} et @samp{Hsb}.
+
+@menu
+* Option du paquetage color: Color package options. Options de chargement du paquetage standard.
+* Modèles de couleur: Color models. Comment sont représentées les couleurs.
+* Commandes pour @code{color}: Commands for color. Les commandes disponibles.
+@end menu
+
+
+@node Color package options
+@section Options du paquetage @code{color}
+@cindex color options du paquetage
+@cindex options, paquetage color
+
+Synopsis (à mettre dans le préambule du document) :
+
+@example
+\usepackage[@var{liste d'option séparées par des virgules}]@{color@}
+@end example
+
+Quand vous chargez le paquetage @file{color} il y a deux types d'options
+disponbiles.
+
+Le premier spécifie le @dfn{pilote d'impression}. @LaTeX{} ne contient
+pas d'information sur les diférents système de sortie, mais au lieu de
+cela dépend de l'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 : @file{dvipdfmx},
+@file{dvips}, @file{dvisvgm}, @file{luatex}, @file{pdftex},
+@file{xetex}. Les deux pilotes @file{xdvi} et @file{oztex} sont pour
+l'essentiel des alias de @file{dvips} (et @file{xdvi} est monochrome).
+Ceux qui ne devraient pas être utilisés pour de nouveaux systèmes récent
+sont : @file{dvipdf}, @file{dvipdfm}, @file{dviwin}, @file{dvipsone},
+@file{emtex}, @file{pctexps}, @file{pctexwin}, @file{pctexhp},
+@file{pctex32}, @file{truetex}, @file{tcidvi}, @file{vtex} (et
+@file{dviwindo} est un alias de @file{dvipsone}).
+
+Les options du second type, autres que les pilotes, sont listées ci-dessous.
+
+@table @code
+
+@item monochrome
+Désactive les commande de couleur, de sorte qu'elles ne produisent pas
+d'erreur, mais ne produisent pas non plus de couleurs.
+
+@item dvipsnames
+Rend disponible une liste de 68 noms de couleur qui sont d'usage
+fréquent, en particulier dans des documents qui ne sont pas modernes.
+Ces noms de couelurs étaient à l'origine fournis par le pilote
+@file{dvips}, d'où le nom de l'option.
+
+@item nodvipsnames
+Ne charge pas cette liste de noms de couleur, faisant faire à @LaTeX{}
+une toute petite économie d'espace mémoire.
+
+@end table
+
+
+@node Color models
+@section Modèles de couleur
+
+@cindex modèles de couleur
+
+Un @dfn{modèle de couleur} est une façon de représenter les couleurs.
+Les possibilité de @LaTeX{} dépendent du pilote d'impression. Toutefois,
+les pilotes @file{pdftex}, @file{xetex}, et @file{luatex} 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'impression utilisés
+aujourd'hui.
+
+Il est à noter qu'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.
+
+@table @code
+@anchor{color models cmyk}
+@item cmyk
+Un liste séparée de virgule avec quatre nombres réel compris entre 0 et
+1 inclus. Le premier nombre est l'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'intensité minimale, alors que 1 correspond à
+l'intensité pleine. Ce modèle est fréquemment utilisé pour l'impression
+de couleur. C'est un modèle soustractif.
+
+@anchor{color models gray}
+@item gray
+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{color models rgb}
+@item rgb
+Une liste séparée de virgules avec trois nombres réèls compris entre 0
+et 1, inclusive. Le premier nombre est l'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'en rien cette composante n'est
+ajouté à la couleur, alors que 1 signifie que cela est fait à pleine
+intensité. C'est un modèle additif.
+
+@anchor{color models RGB}
+@item RGB
+(pilotes @file{pdftex}, @file{xetex}, @file{luatex}) 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 @code{rgb} étant donnée qu'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 @code{rgb} en divisant par 255.
+
+@anchor{color models named}
+@item named
+On accède au couleur par des noms tels que @samp{PrussianBlue}. La
+liste des noms dépend du pilote, mais tous prennennt en charge les noms
+@samp{black}, @samp{blue}, @samp{cyan}, @samp{green}, @samp{magenta},
+@samp{red}, @samp{white}, et @samp{yellow} (Voir l'option
+@code{dvipsnames} dans @ref{Color package options}).
+
+@end table
+
+
+@node Commands for color
+@section Commandes pour @code{color}
+
+@cindex color, commandes du paquetage
+
+Voici les commandes disponibles avec le paquetage @file{color}.
+
+@menu
+* Define colors:: Nommer une couleur.
+* Colored text:: Du texte ou des filets en couleur.
+* Colored boxes:: Une boîte en couleur, par dessus laquelle écrire.
+* Colored pages:: Une page entière en couleur.
+@end menu
+
+
+@node Define colors
+@subsection Definir des couleurs
+
+@cindex couleur
+@cindex définir une couleur
+@cindex couleur, définir
+
+Synopsis :
+
+@example
+\definecolor@{@var{nom}@}@{@var{model}@}@{@var{spécification}@}
+@end example
+
+Donne le nom @var{nom} à la couleur. Par exemple, après
+@code{\definecolor@{silver@}@{rgb@}@{0.75,0.75,0.74@}} vous pouvez
+utiliser cette couleur avec @code{Hé ho,
+\textcolor@{silver@}@{Silver@}~!}.
+
+Cet exemple donne à la couleur un nom plus abstrait, de sort qu'on
+puisse la changer sans que cela prête à confusion.
+
+@example
+\definecolor@{logocolor@}@{RGB@}@{145,92,131@} % RGB nécessite pdflatex
+\newcommand@{\logo@}@{\textcolor@{logocolor@}@{Les Brioches de Robert@}@}
+@end example
+
+Il est fréquent que les couleurs d'un document soient définies dans son
+préambule, ou dans sa classe
+@c différence entre classe et style ?
+ou style, plutôt que dans le corps du document.
+
+@node Colored text
+@subsection Mettre du texte en couleur
+
+@cindex couleur
+@cindex coloré, texte
+@cindex texte en couleur
+
+Synopsis :
+
+@example
+\textcolor@{@var{nom}@}@{...@}
+\textcolor[@var{modèle de couleur}]@{@var{spécification de couleur}@}@{...@}
+@end example
+
+ou
+
+@example
+\color@{@var{nom}@}
+\color[@var{modèle de couleur}]@{@var{spécification}@}
+@end example
+
+Le texte affecté prend la couleur correspondante. La ligne suivante
+
+@example
+\textcolor@{magenta@}@{Je suis Ozymandias, roi des rois~:@} Voyez mon œuvre, ô puissants, et desespérez~!
+@end example
+
+@noindent
+met la première moitié en magenta alors que le reste est en noir. Vous
+pouvez utiliser une couleur déclarée avec @code{\definecolor} exactement
+de la même façon dont nous venons d'utiliser la couleur prédéfinie
+@samp{magenta}.
+
+@example
+\definecolor@{CriseDeLaQuarantaine@}@{rgb@}@{1.0,0.11,0.0@}
+Je considère l'idée de m'acheter une \textcolor@{CriseDeLaQuarantaine@}@{voiture de sport@}.
+@end example
+
+Les deux formes de commandes @code{\textcolor} et @code{\color}
+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 @code{La
+lune est composé de fromage @{\color@{vert@}@}}, de sorte qu'elle est en
+vigueur jusqu'à la fin du groupe ou de l'environnement courant. Ceci
+est parfois utile quand on écrit des macros, ou comme ci-dessous où on
+colore tout le contenu de l'environnement @code{center}, y compris les
+lignes verticales et horizontales.
+
+@example
+\begin@{center@} \color@{blue@}
+ \begin@{tabular@}@{l|r@}
+ HG &HD \\ \hline
+ BG &BD
+ \end@{tabular@}
+\end@{center@}
+@end example
+
+Vous pouvez utiliser des couleurs dans les équations. Un document peut
+avoir @code{\definecolor@{couleurvedette@}@{RGB@}@{225,15,0@}} dans le
+préambule, et ensuite contenir cette équation :
+
+@example
+\begin@{equation@}
+ \int_a^b \textcolor@{couleurvedette@}@{f'(x)@}\,dx=f(b)-f(a)
+\end@{equation@}
+@end example
+
+Typiquement les couleurs utilisées dans un document sont déclarée dans
+une classe ou dans un style mais il arrive qu'on désire fonctionner au
+coup par coup. C'est le cas d'usage des secondes forme du synopsis.
+
+@example
+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
+@end example
+
+Le format de @var{spécification de couleur} dépend du modèle de couleur
+(@pxref{Color models}). Par exemple, alors que @code{rgb} prend trois
+nombbres, @code{gray} n'en prend qu'un.
+
+@example
+La sélection a été \textcolor[gray]@{0.5@}@{grisée@}.
+@end example
+
+Des couleurs au sein d'autres couleurs ne se combinent pas. Ainsi
+
+@example
+\textcolor@{green@}@{une sorte de \textcolor@{blue@}@{bleu@}@}
+@end example
+
+@noindent
+se termine par un mot en bleu, et non pas dans une combinaison de bleu
+et de vert.
+
+@c xx address coloring a line of a table?
+
+
+@node Colored boxes
+@subsection Faire des boîtes en couleur
+
+@cindex couleur
+@cindex colorées, boîtes
+@cindex boîtes colorées
+
+Synopsis :
+
+@example
+\colorbox@{@var{nom}@}@{...@}
+\colorbox[@var{nom modèle}]@{@var{spécification couleur arrière-plan boîte}@}@{...@}
+@end example
+
+@noindent
+ou
+
+@example
+\fcolorbox@{@var{couleur cadre}@}@{@var{couleur arrière-plan boîte}@}@{...@}
+\fcolorbox[@var{nom modèle}]@{@var{spécification couleur cadre}@}@{@var{spécification arrière-plan boîte}@}@{...@}
+@end example
+
+Fabrique une boite avec la couleur d'arrière-plan indiquée. La commande @code{\fcolorbox}
+place un cadre autour de la boîte. Par exemple ceci :
+
+@example
+Nom~:~\colorbox@{cyan@}@{\makebox[5cm][l]@{\strut@}@}
+@end example
+
+@noindent
+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 @code{\strut}
+(de sorte que la profondeur est @code{-.3\baselineskip} et la hauteur
+est @code{\baselineskip}). Ceci met un texte blanc sur un arrière plan
+bleu :
+
+@example
+\colorbox@{blue@}@{\textcolor@{white@}@{Welcome to the machine.@}@}
+@end example
+
+La commande @code{\fcolorbox} utilise les mêmes paramètres que
+@code{\fbox} (@pxref{\fbox and \framebox}), à savoir @code{\fboxrule} et
+@code{\fboxsep}, pour régler l'épaisseur du filet et de la séparation
+entre l'intérieur de la boîte et le filet l'entourant. Les valeurs par
+défaut de @LaTeX{} sont @code{0.4pt} et @code{3pt} respectivement.
+
+L'exemple suivant change l'épaisseur de la bordure en 0,8 points.
+Notez qu'il est entre accolades de sorte que le changement cesse d'être
+en vigueur à la fin de la seconde ligne.
+
+@example
+@{\setlength@{\fboxrule@}@{0.8pt@}
+\fcolorbox@{black@}@{red@}@{En aucun cas ne tournez cette poignée.@}@}
+@end example
+
+@node Colored pages
+@subsection Faire des pages en couleur
+
+@cindex couleur
+@cindex colorée, page
+@cindex page colorée
+@cindex arrière-plan coloré
+
+Synopsis :
+
+@example
+\pagecolor@{@var{nom}@}
+\pagecolor[@var{modèle de couleur}]@{@var{spécification de couleur}@}
+\nopagecolor
+@end example
+
+Les deux premières commandes règlent l'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 @pxref{Colored text}. La
+troisième fait revenir l'arrière-plan à la normale, c-à-d.@: un
+arrière-plan transparent. (Si cela n'est pas pris en charge, alors
+utilisez @code{\pagecolor@{white@}}, bien que cela produit un
+arrière-plan blanc au lieu de l'arrière-plan transparent par défaut.)
+
+@example
+ ...
+\pagecolor@{cyan@}
+ ...
+\nopagecolor
+@end example
+
+
+@node Graphics
+@chapter Graphiques
+
+@cindex graphiques
+@cindex graphics, paquetage
+
+Vous pouvez utiliser des graphiques tel que des fichier PNG ou PDF dans
+vos documents @LaTeX{}. Vous aurez besoin d'un paquetage supplémentaire
+standard de @LaTeX{}. Cet exemple montre en bref comment :
+
+@example
+\include@{graphicx@} % dans le préambule
+ ...
+\includegraphics[width=0.5\linewidth]@{graphique.pdf@}
+@end example
+
+Pour utiliser les commandes décrite ici, le préambule de votre document
+doit contenir soit @code{\usepackage@{graphicx@}}, soit
+@code{\usepackage@{graphics@}}. (Le plus souvent, c'est @file{graphicx}
+qui est préférable.)
+
+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'instructions telles que @samp{dessin un cercle avec
+tel rayon et tel centre}. Un exemple de ceci est le dessin d'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.
+
+Il y a des systèmes particulièrement bien adapté pour produire des
+graphiques pour un document @LaTeX{}. Par exemple, qui vous permettent
+d'utiliser les mêmes polices que dans votre document. @LaTeX{} comprend
+un environnement @code{picture} (@pxref{picture}) qui a des possibilités
+de base. En plus de cela, il y a d'autres façons d'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'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'application de ce document ; reportez vous à leur documentation sur le
+CTAN.
+
+@menu
+* Options du paquetage graphics: Graphics package options. Options au chargement du paquetage.
+* Configuration du paquetage graphics: Graphics package configuration. Où sont les fichiers, quels types de fichiers.
+* Commandes pour graphiques: Commands for graphics. Les commandes disponibles.
+@end menu
+
+
+@node Graphics package options
+@section Options du paquetage @code{graphics}
+
+@cindex graphics, options du paquetage
+@cindex options, paquetage graphics
+
+Synopsis (à placer dans le préambule du document) :
+
+@example
+\usepackage[@var{liste d'option séparée par des virgules}]@{graphics@}
+@end example
+
+ou
+
+@example
+\usepackage[@var{liste d'option séparée par des virgules}]@{graphicx@}
+@end example
+
+Le paquetage @code{graphicx} a un format pour les arguments optionnels
+passés à @code{\includegraphics} qui est commode (c'est le format
+clef/valeur), ainsi c'est le meilleur des deux choix pour les nouveaux
+documents. Quand vous chargez les paquetages @file{graphics} ou
+@code{graphicx} avec @code{\usepackage} il y a deux sortes d'options
+disponibles.
+
+La première est que @LaTeX{} ne contient pas d'information concernant
+les différents systèmes de sortie, mais au lieu de cela dépend de
+l'informtion stockée dans un fichier @dfn{pilote d'impression}.
+Normalment vous ne devriez pas spécifier l'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.
+
+Pour être complet voici une liste des pilotes. Ceux qui sont
+actuellement pertinents sont : @file{dvipdfmx}, @file{dvips},
+@file{dvisvgm}, @file{luatex}, @file{pdftex}, @file{xetex}. Les deux
+pilotes @file{xdvi} and @file{oztex} sont essentiellement des alias de
+@file{dvips} (et @file{xdvi} est monochrome). Ceux qu'on ne devrait pas
+utiliser pour de nouveaux systèmes sont : @file{dvipdfmx}, @file{dvips},
+@file{dvisvgm}, @file{luatex}, @file{pdftex}, @file{xetex}. Les deux
+pilotes @file{xdvi} et @file{oztex} sont essentiellement des alias de
+@file{dvips} (et @file{xdvi} est monochrome). Ceux qui ne devraient pas
+être utilisés pour de nouveaux systèmes sont : @file{dvipdf},
+@file{dvipdfm}, @file{dviwin}, @file{dvipsone}, @file{emtex},
+@file{pctexps}, @file{pctexwin}, @file{pctexhp}, @file{pctex32},
+@file{truetex}, @file{tcidvi}, @file{vtex} (et @file{dviwindo} est un
+alias de @file{dvipsone}). Ces pilotes sont stockés dans des fichiers
+avec une extension @file{.def}, tels que @file{pdftex.def}.
+
+La seconde sorte d'options est décrite ci-après.
+
+@table @code
+@item demo
+Au lieu d'un fichier d'image, @LaTeX{} met un rectangle de 150 pt
+sur 100 pt (à moins qu'une autre taille soit spécifiée dans la
+commande @code{\includegraphics}).
+
+@item draft
+Aucun des fichier grahpique n'est affiché, mais au lieu de cela le nom
+du fichier est imprimé au sein d'une boîte de la bonne taille. De sorte
+à ce que la taille soit déterminée, le fichier doit être présent.
+
+@item final
+(Option par défaut) L'emporte sur toute options @code{draft} précédente,
+de sorte que le document afficher le contenu des fichiers graphiques.
+
+@item hiderotate
+Ne montre pas le texte ayant subi une rotation. (Ceci permet d'utiliser
+une visionneuse ne prenant pas en charge le texte ayant subi une
+rotation).
+@c what does it show?
+
+@item hidescale
+Ne montre pas le texte rétréci/dilaté. (Ceci permet d'utiliser une
+visionneuse ne prenant pas en charge le texte ayant subi un
+rétrécissment/une dilatation.)
+@c what does it show?
+
+@item hiresbb
+Dans un fichier PS ou EPS la taille du graphique peut être spécifiée de
+deux façons. Les lignes @code{%%BoundingBox} décrivent la taille du
+graphique en utilisant des multiples entiers d'un point PostScript,
+c-à-d.@: des multiples entiers d' 1/72 de pouce. Une addition plus
+récente au langage PostScript autorise les multiples décimaux, tel que
+1.23, dans les lignes @code{%%HiResBoundingBox}. Cette option fait que
+@LaTeX{} lit la taille à partir de @code{%%HiResBoundingBox} plutôt que
+de @code{%%BoundingBox}.
+
+@end table
+
+@node Graphics package configuration
+@section Configuration du paquetage @code{graphics}
+
+@cindex graphics
+@cindex graphics, paquetage
+@cindex configuration du paquetage graphics
+@cindex EPS, fichiers
+@cindex JPEG, fichiers
+@cindex JPG, fichiers
+@cindex PDF, fichiers graphiques
+@cindex PNG, fichiers
+
+Ces commandes configurent la façon dont @LaTeX{} recherche le graphique
+dans le système le fichier.
+
+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 @file{grfguide.pdf}, ou le source @LaTeX{}, ou la
+documentationn de votre distribution @TeX{}.
+
+@menu
+* \graphicspath:: Répertoire dans lequels chercher.
+* \DeclareGraphicsExtensions:: Types de fichier, tels que JPG ou EPS.
+* \DeclareGraphicsRule:: Comment manipuler les types de fichier.
+@end menu
+
+
+@node \graphicspath
+@subsection @code{\graphicspath}
+
+@findex \graphicspath
+
+Synopsis :
+
+@example
+\graphicspath@{@var{liste des répertoires entre les accolades}@}
+@end example
+
+Déclare une liste de répertoires dans lesquels rechercher des fichiers
+graphiques. Ceci permet d'écrire plus tard quelque chose du genre de
+@code{\includegraphics@{lion.png@}} au lieu de donner son chemin.
+
+@LaTeX{} recherche toujours en premier les fichiers graphiques dans le
+répertoire courant (et dans le répertoire de sortie, si spécifié ;
+@pxref{output directory}). La déclaration ci-dessous dit au système de
+regarder ensuite dans le sous-répertoire @file{img}, et ensuite
+@file{../img}.
+
+@example
+\usepackage@{graphicx@} % ou graphics; à mettre dans le préambule
+ ...
+\graphicspath@{ @{img/@} @{../img/@} @}
+@end example
+
+La déclaration @code{\graphicspath} est optionnelle. Si vous ne
+l'incluez pas, alors le comportement par défaut de @LaTeX{} est de
+rechercher dans tous les endroits où il recherche d'habitude un fichier
+(il utilise la commande @code{\input@@path} de @LaTeX{}). En
+particulier, dans ce cas l'un l'un des endroit où il regarde est le
+répertoire courant.
+
+Mettez chaque nom de répertoire entre accolades ; en particulier,
+ci-dessus on a écrit @samp{@code{@{img@}}}. Faites ainsi même si il n'y
+a qu'un seul répertoire. Chaque nom de répertoire doit se terminer par
+une oblique vers l'avant @file{/}. Ceci est vrai même sur Windows, où
+la bonne pratique est d'utilise des obliques vers l'avant pour tous les
+séparateur de répertoire puisque cela rend le document portable vers
+d'autres plateformes. Si vous avez des espace dans votre nom de
+répertoire alors utilisez des guillemets anglais, comme dans
+@code{@{"mes docs/"@}}. Enfreindre l'une de ces règles aura pour effet
+que @LaTeX{} rapportera une erreur @code{Error: File `@var{filename}' not found}.
+
+Pour faire simple, l'algorithme est que dans l'exemple qui suit, après
+avoir regardé dans le répertoire courant,
+
+@example
+\graphicspath@{ @{img/@} @{../img/@} @}
+...
+\usepackage@{lion.png@}
+@end example
+
+@noindent
+pour chacun des répertoires listés, @LaTeX{} le concatène avec le nom du
+fichier et recherche le fichier ainsi nommé, eh cherchant
+@file{img/lion.png} et puis @file{../img/lion.png}. Cet algorithme
+signifie que la commande @code{\graphicspath} ne recherche pas
+récursivement dans les sous-répertoires : si vous faites
+@code{\graphicspath@{@{a/@}@}} et que le graphique est dans
+@file{a/b/lion.png} alors @LaTeX{} ne le trouvera pas. Cela signifie
+aussi que vous pouvez utiliser des chemins absolus tels que
+@code{\graphicspath@{@{/home/jim/logos/@}@}} ou
+@code{\graphicspath@{@{C:/Users/Albert/Pictures/@}@}}. Toutefois, faire
+cela rend votre document non portable. (Vous pourriez préserver la
+portabilité en ajustant vos le paramètre @code{TEXINPUTS} du fichier de
+configuration des réglages système @TeX{} ; voir la documentation de
+votre système).
+
+Vous pouvez utiliser @code{\graphicspath} n'improte-où dans le
+document. Vous pouvez l'utiliser plus d'une fois. Sa valeur peut être
+affichée avec @code{\makeatletter\typeout@{\Ginput@@path@}\makeatother}.
+
+Les répertoires sont à donner relativement au fichier de base. Pour
+faire clair, supposez que vous travaillez sur un document basé sur
+@file{livre/livre.tex} et qu'il contienne
+@code{\include@{chapitres/chap1@}}. Si dans @file{chap1.tex} vous
+mettez @code{\graphicspath@{@{graphiques/@}@}} alors @LaTeX{} ne
+cherchera pas les graphiques dans @file{livre/chapitres/graphiques},
+mais dans @file{livre/graphiques}.
+
+
+@node \DeclareGraphicsExtensions
+@subsection @code{\DeclareGraphicsExtensions}
+
+@findex \DeclareGraphicsExtensions
+
+Synopsis :
+
+@example
+\DeclareGraphicsExtensions@{@var{liste séparée par des virgules d'extentions de fichier}@}
+@end example
+
+Déclare les extensions de nom de fichier à essayer. Ceci vous permet de
+spécifier l'ordre dans lequel les formats graphiques sont choisis quant
+les fichiers graphiques sont inclus en donnant le nom de fichier sans
+l'extension, comme dans @code{\includegraphics@{courbe_de_fonction@}}.
+
+Dans l'exemple qui suit, @LaTeX{} trouve les fichiers au format PNG
+avant les fichiers PDF.
+
+@example
+\DeclareGraphicsExtensions@{.png,PNG,.pdf,.PDF@}
+ ...
+\includegraphics@{lion@} % trouve @file{lion.png} avant @file{lion.pdf}
+@end example
+
+@noindent
+Du fait que le nom @file{lion} ne contient pas de point, @LaTeX{}
+utilise la liste d'extension. Pour chacun des répertoires dans la liste
+de chemins graphiques (@pxref{\graphicspath}), @LaTeX{} essaie les
+extensions dans l'ordre donné. S'il ne trouve aucun fichier
+correspondant après avoir essayé tous les répertoires et toutes les
+extensions, alors il renvoie une erreur @samp{! LaTeX Error: File
+`@file{lion}' not found}. Notez que vous devez inclure le point au
+début de chaque extension.
+
+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'est pas sensible
+à la casse.
+
+Vous n'êtes pas tenu d'inclure @code{\DeclareGraphicsExtensions} dans
+votre document ; le pilote d'impression a une valeur par défaut
+raisonnable. Par exemple, la version la plus récente de
+@file{pdftex.def} a cette liste d'extensions.
+
+@example
+.png,.pdf,.jpg,.mps,.jpeg,.jbig2,.jb2,.PNG,.PDF,.JPG,.JPEG,.JBIG2,.JB2
+@end example
+
+Vous pouvez utiliser cette commande n'importe où dans le document. Vous
+pouvez l'utiliser plus d'une fois. On peut afficher la valeur courante
+avec @code{\makeatletter\typeout@{\Gin@@extensions@}\makeatother}.
+
+
+@node \DeclareGraphicsRule
+@subsection @code{\DeclareGraphicsRule}
+
+@findex \DeclareGraphicsRule
+
+Synopsis :
+
+@example
+\DeclareGraphicsRule@{@var{extension}@}@{@var{type}@}@{@var{extension taille-fic}@}@{@var{commande}@}
+@end example
+
+Declare comment gérer les fichiers graphiques dont le nom se termine en
+@var{extension}.
+
+L'exemple suivant déclare que tous le fichiers dont ele est de la forme
+@file{nomfichier-sans-point.mps} doivent être traité comme une sortie de
+MetaPost, ce qui signifie que le pilote d'impression utilisera son code
+de gestion MetaPost pour traiter le fichier en entrée.
+
+@example
+\DeclareGraphicsRule@{.mps@}@{mps@}@{.mps@}@{@}
+@end example
+
+La déclaration suivante
+
+@example
+\DeclareGraphicsRule@{*@}@{mps@}@{*@}@{@}
+@end example
+
+@noindent
+dit à @LaTeX{} qu'il doit traiter comme une sortie MetaPost tout fichier
+avec extension non couverte par une autre règle, ainsi il couvre
+@file{nomfichier.1}, @file{nomfichier.2}, etc.
+
+Ici on décrit les quatre arguments.
+
+@table @var
+@item extension
+L'extension de nom de fichier à laquelle la règle considérée
+s'applique. L'extension commence au premier point dans le nom de
+fichier, en incluant le point. Utiliser l'astérisque, @code{*}, pour
+désigner la comportement par défaut pour toutes les extensions non
+déclarées.
+
+@item type
+Le type du fichier considéré. Ce type est une chaîne de caractères qui
+doit être définie dans le pilote d'impression. Par exemple, les fichiers
+avec les extensions @file{.ps}, @file{.eps}, ou @file{.ps.gz} peuvent
+tous être classifiés sous le type @code{eps}. Tous les fichiers de même
+type sont traités en entrée avec la même commande interne par le pilote
+d'impression. Par exemple, les types de fichiers reconnus par
+@file{pdftex} sont : @code{jpg}, @code{jbig2}, @code{mps}, @code{pdf},
+@code{png}, @code{tif}.
+
+@item extension taille-fic
+L'extension du fichier à lire pour déterminer la taille du graphique, si
+un tel fichier existe. Elle peut être la même que @var{extension} mais
+aussi être différente.
+
+Considérons par exemple un graphique PostScript. Pour le rendre plus
+petit, il peut être compressé en un fichier @file{.ps.gz}. Les fichiers
+compressé ne sont pas lu simplement par @LaTeX{} aussi vous pouvez
+mettre l'information de boîte englobante dans une fichier séparé. Si
+@var{extension taille-fic} est vide, alors vous devez spécifier
+l'information de taill dans les arguments de @code{\includegraphics}.
+
+Si le fichier pilote a un procédure pour lire les tailles de fichier
+pour @code{type} alors elle est utilisée, sinon il utilise la procédure
+pour lire les fichiers @file{.eps}. (Ainsi vous pourriez spécifier la
+taille d'un fichier bitmap dans un fichier avec une ligne
+@code{%%BoundingBox} de style PostScript style si aucun autre format
+n'est disponible).
+
+@item commande
+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,
+@code{\DeclareGraphicsRule@{.eps.gz@}@{eps@}@{.eps.bb@}@{`gunzip -c
+#1@}} spécifie que tout fichier ayant une extension @file{.eps.gz} doit
+être traité comme un fichier @code{eps}, avec l'information de boîte
+englobante stockée dans le fichier ayant l'extension @file{.eps.bb}, et
+que la commande @code{gunzip -c} sera exécuté sur votre plateforme pour
+décompresser le fichier.
+
+Une telle commande est spécifique à votre plateforme. De plus, votre
+système @TeX{} doit autoriser l'exécution de commandes externes ; par
+mesure de sécurité les système moderne restreigne l'exécution de
+commandes à moins que vous l'autorisiez explicitement. Se référer à la
+documentation de votre distribution @TeX{}.
+
+@end table
+
+@node Commands for graphics
+@section Commandes du paquetage @code{graphics}
+
+@cindex graphics, commandes du paquetage
+@cindex commandes, paquetage graphics
+
+Voici les commandes disponibles dans les paquetages @file{graphics} et
+@file{graphicx}.
+
+@menu
+* \includegraphics:: Utiliser un graphique dans votre document.
+* \rotatebox:: Faire une rotation sur une boîte incluant un graphique.
+* \scalebox:: Dilater ou rétrécir une boîte incluant un graphique.
+* \resizebox:: Dilater ou rétrécir une boîte incluant un graphique à un taille donnée.
+@end menu
+
+
+@node \includegraphics
+@subsection @code{\includegraphics}
+
+@cindex graphiques
+@cindex graphics, paquetage
+@cindex inclure des graphiques
+@cindex importer des graphiques
+@cindex EPS, fichiers
+@cindex JPEG, fichiers
+@cindex JPG, fichiers
+@cindex PDF, fichiers graphiques
+@cindex PNG, fichiers
+@findex \includegraphics
+
+Synopsis pour le paquetage @file{graphics} :
+
+@example
+\includegraphics@{@var{nomfichier}@}
+\includegraphics[@var{urx},@var{ury}]@{@var{nomfichier}@}
+\includegraphics[@var{llx},@var{lly}][@var{urx},@var{ury}]@{@var{nomfichier}@}
+\includegraphics*@{@var{nomfichier}@}
+\includegraphics*[@var{urx},@var{ury}]@{@var{nomfichier}@}
+\includegraphics*[@var{llx},@var{lly}][@var{urx},@var{ury}]@{@var{nomfichier}@}
+@end example
+
+Synopsis pour le paquetage @file{graphicx} :
+
+@example
+\includegraphics@{@var{nomfichier}@}
+\includegraphics[@var{liste-à-clefs-valeurs}]@{@var{nomfichier}@}
+\includegraphics*@{@var{nomfichier}@}
+\includegraphics*[@var{liste-à-clefs-valeurs}]@{@var{nomfichier}@}
+@end example
+
+Inclut un fichier graphique. La forme étoilée @code{\includegraphics*}
+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'entoure.
+
+Dans cet exemple
+
+@example
+\usepackage@{graphicx@} % dans le préambule
+ ...
+\begin@{center@}
+ \includegraphics@{trace.pdf@}
+\end@{center@}
+@end example
+
+@noindent
+on incorpore dans le document le graphique dans @file{plot.pdf}, centré
+et à sa taille nominale. Vous pouvez aussi donner un chemin au fichier,
+comme dans @code{\includegraphics@{graphiques/trace.pdf@}}. Pour
+spécifier une liste de répertoire ou rechercher le fichier,
+@pxref{\graphicspath}.
+
+Si votre nom de fichier comprend des espaces, alors placer le entre
+guillemets anglais. Par exemple comme dans
+@code{\includegraphics@{"image complementaire.jpg"@}}.
+
+La commande @code{\includegraphics@{@var{nomfichier}@}} décide du type
+de graphique en segmentant @var{nomfichier} sur le premier point
+(@samp{.}). Vous pouvez utiliser @var{nomfichier} sans extension de nom
+de fihcier, comme dans @code{\includegraphics@{turing@}} et @LaTeX{}
+essaie une séquence d'extension telle que @code{.png} et @code{.pdf}
+jusqu'à ce qu'il trouve un fichier avec cette extension
+(@pxref{\DeclareGraphicsExtensions}).
+
+Si votre fichier comprend des points avantr l'extension alors vous
+pouvez les cacher avec des accolades, comme dans
+@code{\includegraphics@{@{plot.2018.03.12.a@}.pdf@}}. Ou, si vous
+utilisez le paquetage @file{graphicx} alors vous pouvez utiliser les
+options @code{type} et @code{ext} ; voir plus bas. Ces problèmes de
+noms de fichiers, et d'autres sont aussi traités par le paquetage
+@file{grffile}.
+
+L'exemple ci-après place un graphique dans un environnement
+@code{figure} de sorte que @LaTeX{} puisse le déplacer sur la page
+suivante si le faire rentrer dans la page courante rend mal
+(@pxref{figure}).
+
+@example
+\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@}
+@end example
+
+L'exemple suivant place un graphique non flottant, de sorte
+à garantir qu'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.
+
+@example
+\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@}
+@end example
+
+L'exemple suivant place une boîte avec un graphique le long d'une autre
+boîte contenant du texte, les deux boîtes étant verticalement centrées :
+
+@example
+\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@}
+@end example
+
+Si vous utilisez le paquetage @file{graphics} alors les seules options
+disponibles concernent la taille du graphique (mais voir
+@ref{\rotatebox} et @ref{\scalebox}). Quand un argument optionnel est
+présent alors c'est @code{[@var{urx},@var{ury}]} et il donne les
+coordonnées du coin en haut à droite de l'image, comme une paire de
+dimensions @TeX{} (@pxref{Units of length}). Si les unités sont omises,
+alors par défaut l'unité considérée est le @code{bp}. Dans ce cas, le
+coin en bas à gaéuche de l'image est supposée être à (0,0). Si deux
+arguments optionnels sont présents alors le premier est
+@code{[@var{llx},@var{lly}]}, et il spécifie les coordonnées du coin en
+bas à gauche de l'image. Ainsi,
+@code{\includegraphics[1in,0.618in]@{...@}} 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).
+
+Le paquetage @file{graphicx} vous offre beaucoup plus d'options.
+Spécifiez les sous la forme de paires clef-valeur, comme ci-après :
+
+@example
+\begin@{center@}
+ \includegraphics[width=3cm,angle=90]@{lion@}
+ \hspace@{2em@}
+ \includegraphics[angle=90,width=3cm]@{lion@}
+\end@{center@}
+@end example
+
+@noindent
+Les options sont lues de gauche à doite. Ainsi le premier graphique
+ci-dessus est dilaté à une largeur de 3@dmn{cm}, et ensuite subit une
+rotation de 90@dmn{degrés}, alors que le second subit la rotation en
+premier et ensuite est dilaté à 3@dmn{cm} de largeur. Ainsi, à moins
+que le graphique soit parfaitement carré, à la fin les deux n'ont pas
+les mêmes largeurs et hauteurs.
+
+Il y a beaucoup d'options. Les principales sont listées en premier.
+
+@cindex boîte englobante
+@cindex englobante, boîte
+Notez qu'un graphique est placé par @LaTeX{} dans une boîte, qu'on
+désigne traditionnellement comme sa @dfn{boîte englobante} (distincte de
+la BoundingBox PostScript décrite plus bas). La zone sur laquelle le
+graphique s'imprime peut aller au delà de cette boîte, ou s'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.
+
+@table @code
+@anchor{includegraphics width}
+@item width
+Le graphique est affiché de sorte que sa boîte englobante ait cette
+largeur. Un exemple est @code{\includegraphics[width=2.5cm]@{trace@}}.
+Vous pouvez utiliser les unités de longueur standardes de @TeX{}
+(@pxref{Units of length}) et également il est commode d'utiliser
+@code{\linewidth}, ou, dans un document recto-verso, @code{\columnwidth}
+(@pxref{Page layout parameters}). Un exemple est qu'en utilisant le
+paquetage @file{calc} vous pouvez rendre le graphique 1@dmn{cm} plus
+étroit que la largeur du texte avec
+@code{\includegraphics[width=\linewidth-1.0cm]@{hefferon.jpg@}}.
+
+@item height
+@anchor{includegraphics height}
+
+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{} (@pxref{Units of length}), et également il est commode d'utiliser
+@code{\pageheight} et @code{\textheight} (@pxref{Page layout
+parameters}). Par exemple, la commande
+@code{\includegraphics[height=0.25\textheight]@{godel@}} rend le
+graphique d'une hauteur d'un quart de celle de la zone de texte.
+
+@item totalheight
+@anchor{includegraphics totalheight}
+
+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'il a subi une rotation de -90 degrès
+alors il a une hauteur nulle mais une grande profondeur.
+
+@item keepaspectratio
+@anchor{includegraphics keepaspectratio}
+Si réglé à @code{true}, ou juste spécifié comme ci-dessous
+
+@example
+@code{\includegraphics[...,keepaspectratio,...]@{...@}}
+@end example
+
+@noindent
+et que vous donnez en option à la fois @code{width} et @code{height} (ou
+@code{totalheight}), alors @LaTeX{} rendra le graphique aussi grand que
+possible sans le déformer. C'est à dire que @LaTeX{} assure que le
+graphique n'est ni plus large que @code{width} ni plus haut que
+@code{height} (ou @code{totalheight}).
+
+@item scale
+Facteur par lequel dilater/contracter le graphique. On peut rendre
+ graphique à deux fois sa taille nominale avec
+ @code{\includegraphics[scale=2.0]@{...@}}. Ce nombre peut prendre
+ n'importe quelle valeur ; un nombre entre 0 et 1 contracte le graphique
+ et un nombre négatif lui applique une réflexion.
+
+@item angle
+Applique une rotation au graphique. L'angle est exprimé en degrès et
+dans le sens anti-horaire. La rotation est effectuée autour de
+l'origine donnée par l'option @code{origin} ; s'y référer. Pour une
+descrition complète de la compositiion de matériel ayant subi une
+rotation, @pxref{\rotatebox}.
+
+@item origin
+Le point du graphique autour duquel la rotation s'effectue. Les valeurs
+possibles sont toute chaîne contenant un ou deux caractères parmi :
+@code{l} pour gauche (left), @code{r} pour droite (right), @code{b} pour
+bas, @code{c} pour centré, @code{t} pour haut (top), et @code{B} pour
+ligne de base. Ainsi, saisir la commande
+@code{\includegraphics[angle=180,origin=c]@{moon@}} a pour effet de
+mettre la figure tête en bas en tournant autour du centre de l'image,
+alors que la commande
+@code{\includegraphics[angle=180,origin=lB]@{LeBateau@}} fait la
+rotation autour du point gauche de la ligne de base. (Le caractère
+@code{c} désigne le centre horizontal dans @code{bc} ou @code{tc}, mais
+le centre vertical dans @code{lc} @code{rc}). Le réglage par défaut est
+@code{lB}.
+
+Pour faire une rotation autour d'un point arbitraire,
+@pxref{\rotatebox}.
+
+@end table
+
+Voici maintenant des options moins usuelles.
+
+@table @code
+@anchor{includegraphics viewport}
+@item viewport
+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 @code{\includegraphics[.., viewport=0in 0in 1in
+0.618in]@{...@}}. Quand l'unité est omise, les dimensions sont par
+défaut en big points, @code{bp}. Elle sont prises relativement à
+l'origine spécifiée par la boîte englobante. Voir aussi l'option
+@code{trim}.
+
+@anchor{includegraphics trim}
+@item trim
+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 @code{\includegraphics[.., trim= 0in 0.1in
+0.2in 0.3in, ...]@{...@}}. Ceci donne la quantité du graphique à ne pas
+afficher, c-à-d.@: que @LaTeX{} rogne l'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'option @code{viewport}.
+
+@anchor{includegraphics clip}
+@item clip
+Si réglé à @code{true}, ou juste spécifié comme ci-dessous
+
+@example
+\includegraphics[...,clip,...]@{...@}
+@end example
+
+@noindent
+alors le graphique est rogné à sa boîte englobante. Ceci revient au
+même que d'utiliser la forme étoilée de la commande,
+@code{\includegraphics*[...]@{...@}}.
+
+@anchor{includegraphics page}
+@item page
+Donne le numéro de page pour un fichier PDF multi-page. La valeur par
+défaut est @code{page=1}.
+
+@anchor{includegraphics pagebox}
+@item pagebox
+Spécifie quelle boîte englobante utiliser pour les fichier PDF parmi les
+suivantes @code{mediabox}, @code{cropbox}, @code{bleedbox},
+@code{trimbox}, ou @code{artbox}. Les fichier PDF n'ont pas la
+BoundingBox que les fichiers PostScript ont, mais peuvent spécifier
+jusqu'à 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'étendu du contenu de la
+page ayant du sens. Le pilote règle la taille de l'image en se basant
+sur la CropBox si elle est présente, sinon il n'utilise pas les autres,
+avec un ordre de préférence propre au pilote. La MediaBox est toujours
+présente.
+
+@anchor{includegraphics interpolate}
+@item interpolate
+Active ou désactive l'interpolation des images matricielles par la
+visionneuse. On peut régler l'option avec @code{interpolate=true} ou
+juste comme ci-dessous :
+
+@example
+\includegraphics[...,interpolate,...]@{...@}
+@end example
+
+@anchor{includegraphics quiet}
+@item quiet
+N'écrit pas d'information dans le journal. On peut régler l'option avec
+@code{quiet=true} ou juste en la spécifiant avec
+@code{\includegraphics[...,quiet,...]@{...@}},
+
+@anchor{includegraphics draft}
+@item draft
+Lorsqu'on règle l'option avec @code{draft=true} ou juste ainsi
+
+@example
+\includegraphics[...,draft,...]@{...@}
+@end example
+
+@noindent
+alors le graphique n'apparaît pas dans le document, ce qui permet
+éventuellement d'économiser l'imprimante couleur. À la place @LaTeX{}
+place une boîte vide de la bonne taille avec le nom du fichier imprimé
+dedans.
+
+@end table
+
+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 @code{%%BoundingBox} qui apparaît dans le fichier. Elle a
+quatre valeurs donant la coordonnée @math{x} inférieure, la coordonnée
+@math{y} inférieure, la coordonnée @math{x} supérieure, et la coordonnée
+@math{y} supérieure. L'unité est le point PostScript, équivalent au big
+point de @TeX{}, à savoir 1/72 de pouce. Par exemple, si un fichier
+@file{.eps} a la ligne @code{%%BoundingBox 10 20 40 80} alors sa taille
+naturelle est 30/72 de pouche de large pour 60/72 de pouce de haut.
+
+@table @code
+@anchor{includegraphics bb}
+@item bb
+Spécifie la boîte englobante de la région affichée. L'argument est
+constitué de quatre dimensions séparées par des espaces, comme dans
+@code{\includegraphics[.., bb= 0in 0in 1in 0.618in]@{...@}}.
+D'ordinaire @code{\includegraphics} lit les ces nombre BoundingBox dans
+le fichier EPS automatiqument, de sorte que cette option n'est utile que
+si la définition de la boîte englobante est absente du fihcier ou si
+vous désirez la changer.
+
+@anchor{includegraphics bbllx}
+@anchor{includegraphics bblly}
+@anchor{includegraphics bburx}
+@anchor{includegraphics bbury}
+@item bbllx, bblly, bburx, bbury
+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.
+
+@anchor{includegraphics natwidth}
+@anchor{includegraphics natheight}
+@item natwidth, natheight
+Une alternative à @code{bb}. Régler
+
+@example
+\includegraphics[...,natwidth=1in,natheight=0.618in,...]@{...@}
+@end example
+
+@noindent
+revient au même que régler @code{bb=0 0 1in 0.618in}.
+
+@anchor{includegraphics hiresbb}
+@item hiresbb
+Si réglé à @code{true}, ou juste spécifié comme dans
+
+@example
+\includegraphics[...,hiresbb,...]@{...@}
+@end example
+
+@noindent
+alors @LaTeX{} recherche la ligne @code{%%HiResBoundingBox} plutôt que
+la ligne @code{%%BoundingBox}. (La ligne @code{BoundingBox} n'utilise
+que des nombres entiers naturels alors que la ligne
+@code{HiResBoundingBox} utilise des décimaux ; les deux utilisent une
+unité équivalente au big point de @TeX{}, 1/72 de pouce). Pour
+l'emporter sur un réglage précédent à @code{true}, on peut la régler à
+@code{false}.
+
+@end table
+
+Les options suivantes permettent à l'utilisateur de l'emporter sur la
+méthode par laquelle @LaTeX{} choisit le type d'un graphique en fonction
+de son extension de nom de fichier. Par exemple avec
+@code{\includegraphics[type=png,ext=.xxx,read=.xxx]@{lion@}} le fichier
+@file{lion.xxx} est lu comme s'il s'agissait de @file{lion.png}. Pour
+plus ample information, @pxref{\DeclareGraphicsRule}.
+
+@table @code
+@anchor{includegraphics type}
+@item type
+Spécifie le type de graphique.
+
+@anchor{includegraphics ext}
+@item ext
+Spécifie l'extension du graphique. À n'utiliser qu'en conjonction avec
+l'option @code{type}.
+
+@anchor{includegraphics read}
+@item read
+Spécifie l'extension du fichier lu. À n'utiliser qu'en conjonction avec
+l'option @code{type}.
+
+@anchor{includegraphics command}
+@item command
+Spécifie une commande à appliquer à ce fichier. À n'utiliser qu'en
+conjonction avec l'option @code{type}. @xref{Command line options},
+pour une discussion sur l'activation de la fonctionalité @code{\write18}
+pour exécuter des commandes externes.
+
+@end table
+
+
+@node \rotatebox
+@subsection @code{\rotatebox}
+
+@cindex rotation
+@cindex rotating graphics
+@cindex rotating text
+@findex \rotatebox
+
+Synopsis for @file{graphics} package:
+
+@example
+\rotatebox@{@var{angle}@}@{@var{material}@}
+@end example
+
+Synopses for @file{graphicx} package:
+
+@example
+\rotatebox@{@var{angle}@}@{@var{material}@}
+\rotatebox[@var{liste-à-clefs-valeurs}]@{@var{angle}@}@{@var{material}@}
+@end example
+
+Put @var{material} in a box and rotate it @var{angle} degrees counterclockwise.
+
+This example rotates the table column heads forty five degrees.
+
+@example
+\begin@{tabular@}@{ll@}
+ \rotatebox@{45@}@{Character@} &\rotatebox@{45@}@{NATO phonetic@} \\
+ A &AL-FAH \\
+ B &BRAH-VOH
+\end@{tabular@}
+@end example
+
+The @var{material} can be anything that goes in a box, including a graphic.
+
+@example
+ \rotatebox[origin=c]@{45@}@{\includegraphics[width=1in]@{lion@}@}
+@end example
+
+You can get the same effect using the @file{graphicx} package alone
+(@pxref{\includegraphics}).
+
+To place the rotated material, the first step is that @LaTeX{} sets
+@var{material} 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.
+
+If you use the @file{graphics} package then the rotation is about the
+reference point of the box. If you use @file{graphicx} then these are
+the options that can go in the @var{liste-à-clefs-valeurs}.
+
+@table @code
+@item origin
+The point of the @var{material}'s box about which the rotation happens.
+Possible values are any string containing one or two of: @code{l} for
+left, @code{r} for right, @code{b} for bottom, @code{c} for center,
+@code{t} for top, and @code{B} for baseline. Thus,
+@code{\includegraphics[angle=180,origin=c]@{moon@}} will turn the
+picture upside down from the center, while
+@code{\includegraphics[angle=180,origin=lB]@{LeBateau@}} will turn its
+picture upside down about its left baseline. (The character @code{c}
+gives the horizontal center in @code{bc} or @code{tc} but gives the
+vertical center in @code{lc} or @code{rc}.) The default is @code{lB}.
+
+@item x, y
+Specify an arbitrary point of rotation with
+@code{\rotatebox[x=@var{@TeX{} dimension},y=@var{@TeX{}
+dimension}]@{...@}} (@pxref{Units of length}). These give the offset
+from the box's reference point.
+
+@item units
+This key allows you to change the default of degrees counterclockwise.
+Setting @code{units=-360} changes the direction to degrees clockwise and
+setting @code{units=6.283185} changes to radians counterclockwise.
+
+@end table
+
+
+@node \scalebox
+@subsection @code{\scalebox}
+
+@cindex graphics, scaling
+@cindex graphics, resizing
+@cindex scaling
+@cindex resizing
+@cindex text, scaling
+@cindex text, resizing
+@findex \scalebox
+@findex \reflectbox
+
+Synopses:
+
+@example
+\scalebox@{@var{horizontal factor}@}@{@var{material}@}
+\scalebox@{@var{horizontal factor}@}[@var{vertical factor}]@{@var{material}@}
+\reflectbox@{@var{material}@}
+@end example
+
+Scale the @var{material}.
+
+This example halves the size, both horizontally and vertically, of the
+first text and doubles the size of the second.
+
+@example
+\scalebox@{0.5@}@{DRINK ME@} and \scalebox@{2.0@}@{Eat Me@}
+@end example
+
+If you do not specify the optional @var{vertical factor} then it
+defaults to the same value as the @var{horizontal factor}.
+
+You can use this command to resize a graphic, as with
+@code{\scalebox@{0.5@}@{\includegraphics@{lion@}@}}. If you use the
+@file{graphicx} package then you can accomplish the same thing with
+optional arguments to @code{\includegraphics}
+(@pxref{\includegraphics}).
+
+The @code{\reflectbox} command abbreviates
+@code{\scalebox@{-1@}[1]@{@var{material}@}}. Thus, @code{Able was
+I\reflectbox@{Able was I@}} will show the phrase @samp{Able was I}
+immediately followed by its mirror reflection.
+
+
+@node \resizebox
+@subsection @code{\resizebox}
+
+@cindex graphics, scaling
+@cindex graphics, resizing
+@cindex scaling
+@cindex resizing
+@cindex text, scaling
+@cindex text, resizing
+@findex \resizebox
+
+Synopses:
+
+@example
+\resizebox@{@var{horizontal length}@}@{@var{vertical length}@}@{@var{material}@}
+\resizebox*@{@var{horizontal length}@}@{@var{vertical length}@}@{@var{material}@}
+@end example
+
+Given a size, such as @code{3cm}, transform @var{material} to make it
+that size. If either @var{horizontal length} or @var{vertical length}
+is an exclamation point @code{!} then the other argument is used
+to determine a scale factor for both directions.
+
+This example makes the graphic be a half inch wide and scales it
+vertically by the same factor to keep it from being distorted.
+
+@example
+\resizebox@{0.5in@}@{!@}@{\includegraphics@{lion@}@}
+@end example
+
+The unstarred form @code{\resizebox} takes @var{vertical length} to be
+the box's height while the starred form @code{\resizebox*} takes it to
+be height+depth. For instance, make the text have a height+depth of a
+quarter inch with @code{\resizebox*@{!@}@{0.25in@}@{\parbox@{1in@}@{This
+box has both height and depth.@}@}}.
+
+You can use @code{\depth}, @code{\height}, @code{\totalheight}, and
+@code{\width} to refer to the original size of the box. Thus, make the
+text two inches wide but keep the original height with
+@code{\resizebox@{2in@}@{\height@}@{Two inches@}}.
+
@node Special insertions
@chapter Insertions spéciales
@@ -9228,10 +12800,11 @@ que vous pouvez taper.
@menu
* Caractères réservés: Reserved characters. Insérer @samp{# $ % & @{ @} _ ~ ^ \}
+* Capitale et bas de casse: Upper and lower case. Changer la casse du texte.
* Symboles d'une police: Symbols by font position. Insérer des symboles d'une police par leur numéro.
* Symboles dans du texte: Text symbols. Insérer d'autres symboles non-lettre dans le texte.
* Accents:: Insérer des accents.
-* Caractères non-anglais: Non-English characters. Insérer d'autres caractères non-Américain.
+* Lettres latines supplémentaires: Additional Latin letters. Insérer d'autres caractères non-Américain.
* \rule:: Insérer des lignes et des rectangles.
* \today:: Insérer la date du jour.
@end menu
@@ -9246,7 +12819,8 @@ que vous pouvez taper.
@LaTeX{} réserve les caractères suivant à un usage spécial (par exemple,
le signe pourcent @code{%} sert aux commentaires) c'est pourquoi on les
-appelle @dfn{caractères réservés} ou @dfn{caractères spéciaux}.
+appelle @dfn{caractères réservés} ou @dfn{caractères spéciaux}. Ils sont
+chacun l'objet d'une discussion ailleurs dans ce manuel.
@example
# $ % & @{ @} _ ~ ^ \
@@ -9259,7 +12833,7 @@ appelle @dfn{caractères réservés} ou @dfn{caractères spéciaux}.
@findex \_
@findex \@{
@findex \@}
-Si vous voulez qu'un caractère réservés soit imprimé comme lui-même,
+Si vous voulez qu'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'une contr'oblique @code{\}. Ainsi @code{\$1.23}
@@ -9275,8 +12849,9 @@ un accent circonflexe dans la police du corps du texte utilisez
@code{\^@{@}}. Une contr'oblique dans la police du corps de texte se
fait avec @code{\textbackslash@{@}}.
-Pour produire les caractères réservé dans la police d'une machine à écrire utilisez
-@code{\verb!!} comme ci-dessous :
+Pour produire les caractères réservés dans la police tapuscrite utilisez
+@code{\verb!!} comme ci-dessous (la double contr'oblique @code{\\} n'est
+là que pour aller à la ligne en sortie) :
@example
\begin@{center@}
@@ -9289,6 +12864,75 @@ Dans cet exemple la double contr'oblique @code{\\} n'est là que pour
sauter à la ligne.
+@node Upper and lower case
+@section Capitales et bas de casse
+
+@cindex Capitales
+@cindex Bas de casse
+@cindex Casse de caractères
+@cindex Changer la casse de caractères
+
+Synopsis :
+
+@example
+\uppercase@{@var{texte}@}
+\lowercase@{@var{texte}@}
+\MakeUppercase@{@var{texte}@}
+\MakeLowercase@{@var{texte}@}
+@end example
+
+Change la casse des caractères. Les commandes primitives de @TeX{}
+@code{\uppercase} et @code{\lowercase} ne fonctionnent que pour les
+26 lettres sans diacritiques a-z et A-Z. Les commandes @LaTeX{}
+@code{\MakeUppercase} et @code{\MakeLowercase} changent aussi les
+caractères accessibles par des commandes telles que @code{\ae} ou
+@code{\aa}. Ces commandes @code{\MakeUppercase} et
+@code{\MakeLowercase} sont robustes, mais elles ont des arguments
+mouvants (@pxref{\protect}).
+
+Ces commandes ne changent pas la casse des lettres utilisées dans le nom
+d'une commande au sein de @var{texte}. Mais par contre elles changent la
+casse de tout autre lettre latine au sein de l'argument @var{texte}.
+Ainsi, @code{\MakeUppercase@{Soit $y=f(x)$}@} produit @samp{SOIT
+Y=F(X)}. Un autre exemple est que le nom de tout environnement est
+changé, de sorte que @code{\MakeUppercase@{\begin@{tabular@}
+... \end@{tabular@}@}} produit une erreur puisque la première moitié est
+changée en @code{\begin@{TABULAR@}}.
+
+@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'autres alphabets.
+
+Pour changer la casse du texte qui résulte d'une macro au sein de
+@var{texte} il est nécessaire de faire un développement. Dans l'exemple
+qui suit la macro @code{\Nomecole} produit @samp{UNIVERSITÉ DE MATHÉMATIQUES}.
+
+@example
+\newcommand@{\nomecole@}@{Universit\'e de math\'ematiques@}
+\newcommand@{\Nomecole@}@{\expandafter\MakeUppercase\expandafter@{\nomecole@}@}
+@end example
+
+@PkgIndex{textcase}
+Le paquetage @file{textcase} comble certaines des lacunes des commandes
+standardes @code{\MakeUppercase} et @code{\MakeLowerCase} de @LaTeX{}.
+
+@PkgIndex{mfirstuc}
+Pour mettre en capitale seulement la première lettre d'un mot, on peut
+utiliser le paquetage @file{mfirstuc}.
+
+@PkgIndex{expl3}
+@cindex Wright, Joseph
+
+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'origine. Cela
+a été implémenté dans le paquetage @code{expl3} à compter de
+2020. L'article « Case changing: From @TeX{} primitives to the Unicode
+algorithm », (Joseph Wright, @cite{TUGboat} 41:1,
+@url{https://tug.org/TUGboat/tb41-1/tb127wright-case.pdf}), donne un bon
+aperçu du sujet, passé et présent.
+
@node Symbols by font position
@section Symboles appelés par leur position dans une police
@@ -9400,7 +13044,7 @@ Guillemets-virgule inférieur double et simple : @quotedblbase{} et
@cindex fermant, guillemet-apostrophe simple
@cindex droite, guillemet anglais simple
@cindex fermant, guillemet anglais simple
-Guillemet-apostrophe simple de gauche (fermant) : '.
+Guillemet-apostrophe simple de droite (fermant) : '.
@item \S
\itemx \textsection
@@ -9604,7 +13248,7 @@ Tiret bas : _.
@item \textvisiblespace
@cindex visible, symbole espace, dans le texte
@cindex espace visible, symbole, dans le texte
-Symbol espace visible.
+Symbole espace visible.
@end ftable
@@ -9811,8 +13455,9 @@ Produit un accent h@'a@v{c}ek (caron), comme dans `@v{o}'.
@end table
-@node Non-English characters
+@node Additional Latin letters
@section Lettres latines supplémentaires
+@anchor{Non-English characters}
@cindex caractères speciaux
@cindex speciaux, caractères
@@ -9978,68 +13623,262 @@ d'autres formats de date.
@cindex partitionner le fichier d'entrée
@cindex fichier d'entrée
-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
+@LaTeX{} vous permet de partitionner un document de grande taille en
+plusieurs plus petits. Ceci peut simplifier son édition et permette à
+plusieurs auteurs d'y travailler. Cela peut aussi accélerer le
+traitement.
+
+Indépendamment du nombre de fichiers distincts que vous
+utilisez, il y a toujours un seul
@cindex racine, fichier
@cindex fichier racine
-@dfn{fichier racine} ; c'est le fichier dont vous passer le nom à la
-ligne de commande quand vous exécutez @LaTeX{}.
+@dfn{fichier racine} sur lequel la compilation @LaTeX{}
+démarre. L'exemple ci-dessous illuste un tel fichier avec cinq fichiers
+inclus.
+
+@example
+\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@}
+@end example
-@xref{filecontents}, pour un environnement qui permet de grouper un
-fichier externe à créer avec le document principal.
+@noindent
+Dans cet example on prend le matériel de @file{pref.tex},
+@file{chap1.tex}, @file{chap2.tex}, @file{append.tex}, et
+@file{bib.tex}. Si vous compilez ce fichier, et ensuite mettez en
+commentaire toutes les lignes au sein de @code{\includeonly@{...@}}
+hormis @code{chap1}, 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'avantage
+de la commande @code{\includeonly} est que @LaTeX{} retient les numéros
+de page et toute l'information de renvoi des autres parties du document
+de sorte qu'elles apparaissent correctement en sortie.
+
+@xref{Larger book template} pour un autre exemple de @code{\includeonly}.
+
+@c xxx Pourquoi avoir supprimer cette ref.
+@c @xref{filecontents}, pour un environnement qui permet de grouper un
+@c fichier externe à créer avec le document racine.
@menu
-* \include:: Inclure conditionnellement un fichier.
-* \includeonly:: Determiner quels fichiers sont à inclure.
-* \input:: Inclure inconditionnellement un fichier.
+* \endinput:: Ne plus include le matériel d'un fichier.
+* \include & \includeonly:: Inclure conditionnellement des fichiers.
+* \input:: Inclure inconditionnellement un fichier.
@end menu
-@node \include
-@section @code{\include}
-@findex \include
+@node \endinput
+@section @code{\endinput}
+
+@findex \endinput
Synopsis :
@example
-\include@{@var{fichier}@}
+\endinput
@end example
-Si aucune commande @code{\includeonly} n'est présente, la commande
-@code{\include} exécute un @code{\clearpage} pour commencer une nouvelle
-page (@pxref{\clearpage}), puis elle lit @var{fichier}, et ensuite fait
-encore un @code{\clearpage}.
+Quand vous écrivez @code{\include@{nomfichier@}}, alors au sein de
+@file{nomfichier.tex} le matériel qui vient après @code{\endinput} n'est
+pas inclus. Cette commande est optionnelle ; si @file{nomfichier.tex}
+ne comprend pas de @code{\endinput} alors @LaTeX{} lit tout le fichier.
-Précédé d'une commande @code{\includeonly}, les actions de
-@code{\include} ne sont exécutées que si @var{fichier} est un élément des
-fichiers listés en argument de l'@code{\includeonly}. Voir @ref{\includeonly}.
+Par exemple, supposons que le fichier racine d'un document a un
+@code{\input@{chap1@}} que ce le contenu de @file{chap1.tex} est ce qui
+suit :
+
+@example
+\chapter@{One@} Ce matériel apparaît dans le document. \endinput Ceci
+n'apparaît pas.
+@end example
-@cindex @code{\include} emboîtés interdits
-La commande @code{\include} ne doit apparaître ni dans le préambule, ni
-au sein d'un fichier lu par une autre commande @code{\include}.
+Ceci peut être utile pour placer de la documentation ou des commentaire
+à la fin d'un fichier, ou pour éviter des caractères indésirable qui
+pourraît s'ajouter si le fichier est transmis dans le corps d'un
+courriel. C'est également utile pour déboguer : une stratégie pour
+localiser des erreurs est de placer un @code{\endinput} à mi-chemin en
+cours des fichiers inclus et de voir si l'erreur disparaît. Ensuite,
+sachant quelle moitié contient l'erreur, en déplaçant le
+@code{\endinput} à mi-chemin de cette zone circonscrit de plus près
+l'endroit où elle se trouve. Ainsi on trouve rapidement la ligne
+fautive.
+Après avoir lu @code{\endinput}, @LaTeX{} continue à lire jusqu'à 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 @code{\if...} par un @code{\fi}.
-@node \includeonly
-@section \@code{includeonly}
+@node \include & \includeonly
+@section @code{\include} & @code{\includeonly}
+@findex \include
@findex \includeonly
Synopsis :
@example
-\includeonly@{@var{fichier1},@var{fichier2},...@}
+\includeonly@{ % dans le préambule du document
+ ...
+ @var{nomfichier},
+ ...
+ @}
+ ...
+\include@{@var{nomfichier}@} % dans le corps du document
+@end example
+
+Apporte du matériel d'un fichier externe @file{@var{nomfichier}.tex}
+dans un document @LaTeX{}.
+
+La commande @code{\include} fait trois choses : elle exécute
+@code{\clearpage} (@pxref{\clearpage & \cleardoublepage}), puis elle
+insère le matériel à partir du fichier @file{@var{nomfichier}.tex} dans
+le document, ensuite fait encore un @code{\clearpage}. Cette commande ne
+peut apparaître que dans le corps du document.
+
+La commande @code{\includeonly} contrôle quels fichiers seront lus par
+@LaTeX{} lors des commandes @code{\include} 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.
+
+Dans le document racine en exemple ci-dessous, @file{constitution.tex}, on
+inclut trois fichiers, @file{preambule.tex}, @file{articles.tex}, et
+@file{amendements.tex}.
+
+@example
+\documentclass@{book@}
+\includeonly@{
+ preambule,
+ articles,
+ amendements
+ @}
+\begin@{document@}
+\include@{preambule@}
+\include@{articles@}
+\include@{amendements@}
+\end@{document@}
+@end example
+
+@noindent
+Le fichier @file{preambule.tex} ne contient aucun code spécial ; vous
+avez juste extrait ce chapitre de @file{consitution.tex} pour le mettre
+dans un fichier séparé pour rendre son édition plus commode.
+
+@example
+\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, ...
+@end example
+
+@noindent
+Exécuter @LaTeX{} sur @file{constitution.tex} fait apparaître le
+matériel issu de ces trois fichiers dans le document mais génère
+également les fichiers auxiliaires @file{preamble.aux},
+@file{articles.aux}, et @file{amendements.aux}. Ceux-ci contiennent de
+l'information telle que les numéros de page et les renvois (@pxref{Cross
+references}). Si maintenant vous mettez en commentaire les lignes de
+@code{\includeonly} contenant @code{preambule} et @code{amendements} et
+exécutez @LaTeX{} de nouveau alors le document résultant ne contiendra
+que le matériel issu de @file{articles.tex}, mais pas celui de
+@file{preamblue.tex} ni de @file{amendements.tex}. Néanmois, la
+totalité de l'information auxiliaire issue des fichiers omis est
+toujours là, y compris le numéro de la page où commence le chapitre.
+
+S'il n'y a pas de @code{\includeonly} dans le préambule du document,
+alors @LaTeX{} inclut tous les fichiers demandés par des commandes
+@code{\include}.
+
+La commande @code{\include} fabrique une nouvelle page. Pour éviter
+cela, voir @ref{\input} (ce qui, cependant, ne retient pas l'information
+auxiliaire).
+
+@xref{Larger book template} pour un autre exemple utilisant
+@code{\include} et @code{\includeonly}. Cet exemple utilise également
+@code{\input} pour certain matériel qui ne débute pas nécessairement sur
+une nouvelle page.
+
+Les noms de fichiers peuvent impliquer un chemin.
+
+@example
+\documentclass@{book@}
+\includeonly@{
+ chapitres/chap1,
+ @}
+\begin@{document@}
+\include@{chapitres/chap1@}
+\end@{document@}
+@end example
+
+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 @samp{amo amas amat}, ce qui suit
+fonctionne sous @TeX{} Live sur GNU/Linux:
+
+@example
+\documentclass@{book@}
+\includeonly@{
+ "amo\space amas\space amat"
+ @}
+\begin@{document@}
+\include@{"amo\space amas\space amat"@}
+\end@{document@}
+@end example
+
+et ceci fonctionne sous MiK@TeX{} sur Windows:
+
+@example
+\documentclass@{book@}
+\includeonly@{
+ @{"amo amas amat"@}
+ @}
+\begin@{document@}
+\include@{@{"amo amas amat"@}@}
+\end@{document@}
@end example
-La commande @code{\includeonly} contrôle quels fichiers sont lisible par
-toute commande @code{\include} venant ensuite. La liste des noms de
-fichier est à éléments séparés par des virgules. Chaque élément
-@var{fichier1}, @var{fichier2}, @dots{} doit exactement correspondre à
-un nom de fichier spécifié en argument d'une commande @code{\include}
-pour que la sélection soit effective.
+@cindex @code{\include} imbriqués non autorisés
+@cindex imbrication de @code{\include} non autorisée
+Vous ne pouvez pas utiliser @code{\include} au sein d'un fichier qui
+lui-même est inclus via @code{\include}, sans quoi vous obtenez l'erreur
+@samp{LaTeX Error: \include cannot be nested}. La commande
+@code{\include} ne peut pas apparaître dans le préambule ; sans quoi
+vous obtenez l'erreur @samp{LaTeX Error: Missing \begin@{document@}}.
-Cette commande ne peut apparaître que dans le préambule.
+Si un fichier que vous incluez par @code{\include} n'existe pas, par
+exemple si vous tapez la commande @code{\include@{athiesme@}} par erreur
+à la place de @code{\include@{atheisme@}}, alors @LaTeX{} ne produit pas
+une erreur mais un avertissement @samp{No file athiesme.tex.} (Il crée
+également le fichier @file{athiesme.aux}).
+
+Si vous faites un @code{\include} du fichier racine dans lui-même alors
+vous obtenez tout d'abord @samp{LaTeX Error: Can be used only in
+preamble}. Les exécutions suivantes donnent @samp{TeX capacity
+exceeded, sorry [text input levels=15]}. Pour réparer cela, vous devez
+enlever l'inclusion @code{\include@{@var{racine}@}} mais aussi détruire
+le fichier @file{@var{racine}.aux} et exécuter de nouveau @LaTeX{}.
+
+
+@c xxx \includeonly omis = mettre plus haut dans le nœeud, pour la
+@c xxx progressivité de l'exposé.
@node \input
@@ -10063,53 +13902,162 @@ n'est trouvé avec ce nom, alors on essaie le @var{nomfichier} original
(c.-à-d.@: @samp{toto} ou @samp{toto.tata}).
@node Front/back matter
-@chapter Prologue et épilogue
+@chapter Parties pré/post-liminaires
@menu
-* Table des matières: Tables of contents.
-* Glossaires: Glossaries.
-* Index:Indexes.
+* Table des matières etc.: Table of contents etc.. Table des matière, liste des figures, liste des tableaux.
+* Glossaires: Glossaries. Génère un glossaire.
+* Index:Indexes. Génère un indexe.
@end menu
-@node Tables of contents
-@section Tables des matières
+@node Table of contents etc.
+@section Table des matières etc.
@cindex table des matière, création
@findex \tableofcontents
@findex .toc, @r{fichier}
-On produit une table des matières avec la commande
-@code{\tableofcontents}. Placez la commande à l'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'un fichier
-@file{.toc} ait été produit à la précédente.
-
-La commande @code{\tableofcontents} 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
-@code{\newpage} après la commande @code{\tableofcontents}.
-
@findex \listoffigures
@findex \listoftables
-Les commandes analogues @code{\listoffigures} et @code{\listoftables}
-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.
+@findex .lof @r{fichier}
+@findex .lot @r{fichier}
-@findex \nofiles
-La commande @code{\nofiles} l'emporte sur ces commandes, et
-@emph{empèche} la génération de ces listes.
+Synopsis, l'un parmi ceux qui suivent :
+
+@example
+\tableofcontents
+\listoffigures
+\listoftables
+@end example
+
+Produit une table des matières, ou une liste des figures, ou une liste
+des tableaux. Placez la commande à l'endroit même où vous voulez que la
+table ou liste apparaisse. Vous n'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
+@code{\chapter}, etc.
+
+L'exemple ci-dessous illustre la première commande,
+@code{\tableofcontents}. @LaTeX{} produit une table des matières sur la
+première page du livre.
+
+@example
+\documentclass@{book@}
+% \setcounter@{tocdepth@}@{1@}
+\begin@{document@}
+\tableofcontents\newpage
+ ...
+\chapter@{...@}
+ ...
+\section@{...@}
+ ...
+\subsection@{...@}
+ ...
+\end@{document@}
+@end example
+
+@noindent
+En décommentant la deuxième ligne on peut limiter la table à ne lister
+que les rubriques issues de @code{\chapter} et @code{\section}, mais pas
+celle issue de @code{\subsection}, parce que la commande @code{\section}
+a pour niveau 1. @xref{Sectioning} pour les numéros de niveaux des
+rubriques. Pour plus ample information sur @code{tocdepth}
+@pxref{Sectioning/tocdepth}.
+
+Un autre exemple de l'utilisation de @code{\tableofcontents} est dans
+@ref{Larger book template}.
+
+Si vous désirez un saut de page après la table des matières, insérez une commande
+@code{\newpage} après la commande @code{\tableofcontents}, comme ci-dessus.
+
+Pour fabriquer la table des matières, @LaTeX{} stocke l'information dans
+un fichier auxiliaire nommé @file{@var{fichier-racine}.toc}
+(@pxref{Splitting the input}). Par exemple, le fichier
+@LaTeX{} @file{test.tex} ci-dessous :
+
+@example
+\documentclass@{article@}
+\begin@{document@}
+\tableofcontents\newpage
+\section@{Premièrement@}
+\subsection@{Deuxièmement@}
+ ...
+@end example
+
+@noindent
+écrit la ligne suivante dans @file{test.toc} :
+
+@example
+\contentsline @{section@}@{\numberline @{1@}Premièrement@}@{2@}
+\contentsline @{subsection@}@{\numberline @{1.1@}Deuxièmement@}@{2@}
+@end example
+
+@noindent
+L'indication @code{section} ou @code{subsection} donne le type de
+rubrique. Le crochet @code{\numberline} vous permet de changer la façon
+dont l'information apparaît au sein de la table des matières. Son
+unique argument, @code{1} ou @code{1.1}, est le numéro de la rubrique
+alors que le reste du deuxième argument de @code{\contentsline},
+@code{Premièrement} ou @code{Deuxièmement}, est le titre. Finalement,
+le troisième argument, @code{2}, est le numéro de la page à laquelle les
+rubriques débutent.
+
+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'information et une
+fois pour l'obtenir.
+@c xxx Et avec les .lot et .lof c'est aussi 2 fois, mais parce que le
+@c .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
+@samp{Table des matières}. Il suffit de l'exécuter de nouveau.
+
+@c xxx ajouter que les fichier .lot et .lof sont renseignés par la commande \caption
+Les commandes @code{\listoffigures} et @code{\listoftables} 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'information stockée dans des fichiers
+@file{.lof} et @file{.lot}.
+
+Pour modifier le titre de la page de table des matières, inspirez vous
+la la première ligne de l'exemple suivant :
+
+@example
+\renewcommand@{\contentsname@}@{Table des matières@}
+\renewcommand@{\listfigurename@}@{Tracé de courbes@}
+\renewcommand@{\listtablename@}@{Tableaux@}
+@end example
+
+@noindent
+@PkgIndex{babel}
+@PkgIndex{polyglossia}
+De même, les deux autres lignes s'occupent des deux autres. Des
+paquetages d'internationalisation tels que @file{babel} ou
+@file{polyglossia} modifient les titres en fonction de la langue de base
+sélectionnée.
+
+@PkgIndex{tocloft}
+@PkgIndex{tocbibbind}
+Le CTAN a beaucoup de paquetages traitant de la table des matières et
+des listes de figures et de tableaux. L'un d'eux bien commode pour
+ajuster certains aspects du traitement par défaut, tels que
+l'espacement, est @file{tocloft}. Et @file{tocbibbind} permet d'ajouter
+automatiquement la bibliograpghie, les indexes, etc. à la table des
+matières.
@menu
* \addcontentsline:: Ajouter une entrée dans la table des matières etc.
* \addtocontents:: Ajouter du texte directement au fichier table des matières etc.
+* \nofiles:: Empêche l'écriture dans les fichiers auxiliaires.
@end menu
@node \addcontentsline
@subsection @code{\addcontentsline}
@findex \addcontentsline@{@var{ext}@}@{@var{unit}@}@{@var{texte}@}
-@cindex table of contents entry, manually adding
+@cindex table des matières, ajouter manuellement un article
+@c xx Revoir la trad.
Synopsis :
@@ -10175,6 +14123,39 @@ figures), ou @file{lot} (liste des tableaux).
Le texte à écrire.
@end table
+@node \nofiles
+@subsection @code{\nofiles}
+
+@findex \nofiles
+
+Synopsis :
+
+@example
+\nofiles
+@end example
+
+Empêche @LaTeX{} d'écrire quelque fichier auxiliaire que ce soit. Les
+seules sorites seront les fichiers @file{.log} et @file{.pdf} (ou
+@file{.dvi}). Cette commande ne peut être placée que dans le preambule.
+
+À cause de la commande @code{\nofiles} dans cet exemple aucun fichier
+@file{.toc} n'est produit.
+
+@example
+\documentclass@{book@}
+\nofiles
+\begin@{document@}
+\tableofcontents\newpage
+\chapter@{...@}
+ ...
+@end example
+
+@noindent
+@LaTeX{} n'efface pas les fichiers auxiliaires existants, de sorte que
+si vous insérer la commande @code{\nofiles} après avoir compilé le
+fichier et obtenu un fichier @file{.toc} alors la page de table des
+matières contiendra l'ancienne information.
+
@node Glossaries
@section Glossaires
@@ -10197,7 +14178,7 @@ est la valeur courante de @code{\thepage}.
Le paquetage @code{glossary} disponible sur le CTAN fournit une prise en
charge de glossaires plus élaborée.
-
+@c Revoir la trad.
@node Indexes
@section Index
@cindex index
@@ -10217,7 +14198,8 @@ Plus précisément, ce qui est écrit est la commande
@code{\indexentry@{@var{texte}@}@{@var{numpage}@}}, où @var{numpage} est
la valeur courante de @code{\thepage}.
-@cindex « Voir » et « Voir aussi », article d'index
+@cindex Voir et Voir aussi, article d'index
+@cindex article d'index, « Voir » et « Voir aussi »
Pour générer un article d'index pour « toto » qui dit « Voir titi »,
utilisez une barre verticale : @code{\index@{toto|see@{titi@}@}}.
Utilisez @code{seealso} au lieu de @code{see} pour fabriquer un article
@@ -10225,6 +14207,7 @@ en « Voir aussi ».
@findex \seename
@findex \alsoname
+@PkgIndex{babel} @PkgIndex{polyglossia}
Le texte « Voir » est défini par la macro @code{\seename}, et le texte
« Voir aussi » par la macro @code{\alsoname}. Ils peuvent être redéfinis
pour d'autres langages.
@@ -10680,10 +14663,147 @@ il apparaît en bas à droite de la page.
@cindex entrée/sortie console
@menu
+* \openin & \openout:: Ouvrir un fichier.
+* \read:: Lire du texte à partir d'un fichier.
* \typein:: Lire du texte à partir de la console.
* \typeout:: Écrire du texte vers la console.
+* \write:: Écrire du texte dans un fichier ou le terminal.
@end menu
+@node \openin & \openout
+@section @code{\openin} & @code{\openout}
+
+@findex \openin
+@findex \openout
+@findex \closein
+@findex \closeout
+@cindex file, opening
+@cindex file, closing
+@cindex open a file
+
+Synopsis :
+
+@example
+\openin @var{numéro}=@var{nomfichier}
+@end example
+
+ou :
+
+@example
+\openout @var{numéro}=@var{nomfichier}
+@end example
+
+Ouvre un fichier pour y lire, ou pour y écrire. Le @var{numéro} doit
+être entre 0 et 15, comme dans @code{\openin3} (dans Lua@LaTeX{} @var{numéro}
+peut être entre 0 et 255).
+
+Ici @TeX{} ouvre le fichier le fichier @file{presidents.tex} en lecture.
+
+@example
+\newread\fichierpresidents
+\openin\fichierpresidents=presidents
+\typeout@{fichierpresidents vaut \the\fichierpresidents@}
+\read\fichierpresidents to\presidentligne
+\typeout@{\presidentligne@}
+@end example
+
+@noindent
+La commande @code{\newread} alloue des numéros de flux d'entrée de 0
+à 15 (il y a aussi une commande @code{\newwrite}). La variable
+@code{\fichierpresidents} est plus facile à mémoriser mais sous le capot
+ce n'est rien de plus qu'un numéro ; le premier @code{\typeout} donne
+queleque-chose du genre de @samp{fichierpresidents vaut 1}. De plus,
+@code{\newread} garde la trace de l'allocation de sorte que si vous en
+utilisez trop alors vous obtiendrez une erreur du genre de @samp{! No
+room for a new \read}. Le second @code{\typeout} produit la première
+ligne du fihcier, quelque-chose du genre de @samp{1 Bonaparte,
+Louis-Napoléon}.
+
+D'ordinaire @TeX{} n'essaie pas d'ouvrir le fichier jusqu'à la prochaine
+éjection de page. Pour changer cela, utilisez
+@code{\immediate\openin @var{numéro}=@var{nomfichier}} ou
+@code{\immediate\openout @var{numéro}=@var{nomfichier}}.
+
+Fermez les fichiers avec @code{\closein @var{numéro}} et
+@code{\closeout @var{numéro}}.
+
+La façon dont @LaTeX{} manipule les noms de fichiers varie selon les
+distributions, et peut même varier d'une version à l'autre d'une même
+distribution. Si le nom de fichier n'a pas d'extension alors @TeX{} y
+ajoute un @file{.tex}. L'exemple suivant crée @file{presidents.tex}, y
+écrit une ligne, et le ferme.
+
+@example
+\newwrite\fichierpresidents
+\openout\fichierpresidents=presidents
+\write\fichierpresidents@{1 Bonaparte, Louis-Napoléon@}
+\closeout\fichierpresidents
+@end example
+
+@noindent
+Mais les noms de fichier avec un point peuvent causer des problèmes : si
+@TeX{} tombe sur un @var{nomfichier} comme @file{presidents.dat} il se
+peut qu'il cherche d'abord @file{presidents.dat.tex} et ensuite
+@file{presidents.dat}, 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'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 @samp{_} et de 6 @samp{-}, et en particulier sans point
+ni espace.
+
+Pour @code{\openin}, 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'est
+pas ouvert (ce qu'on peut vérifier avec @code{\ifeof} ; on peut
+également recourir à la commande @code{\InputIfFileExists}, @pxref{Class
+and package commands}). Si vous essayer d'utiliser le même numéro deux
+fois, @LaTeX{} ne produit pas d'erreur. Si vous essayer d'utiliser un
+mauvais numéro, alors vous obtiendrez un message d'erreur du genre de
+@samp{! Bad number (16). <to be read again> = l.30 \openin16=test.jh}.
+
+@node \read
+@section @code{\read}
+
+@findex \read
+@cindex fichier, lecture d'un
+@cindex lire un fichier
+@cindex lecture d'un fichier
+
+Synopsis :
+
+@example
+\read @var{numéro} to@var{macro}
+@end example
+
+Fait que la commande @var{macro} contienne la ligne suivante d'entrée du
+flux de texte @var{numéro}, comme dans @code{\read5 to\data}.
+
+L'exemple suivant ouvre le fichier @file{mel.tex} en lecture, me le
+contenu de la première ligne dans la commande @code{\courriel}, et
+ensuite ferme le fichier.
+
+@example
+\newread\fichierreception
+\openin\fichierreception=mel
+\read\fichierreception to\courriel
+\typeout@{Adresse mél : \courriel@}
+\closein\fichierreception
+@end example
+
+Si @var{numéro} est hors de l'intervalle de 0 à 15 ou si aucun fichier
+avec ce numéro n'est ouvert, ou si le fichier est à sa fin, alors
+@code{\read} 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 @code{\typein} (@pxref{\typein}).
+
+Pour lire un fichier entier en une fois utilisez @code{\input}
+(@pxref{\input}) ou @code{\include} (@pxref{\include & \includeonly}).
+
+@PkgIndex{datatool}
+
+Une raison usuelle de vouloir lire d'un fichier de données est de faire
+du publipostage. CTAN a plusieurs paquetage pour cela ; parmi lesquels
+@file{datatool}.
@node \typein
@section @code{\typein[@var{cmd}]@{@var{msg}@}}
@@ -10726,47 +14846,735 @@ commande s'appliquent à @code{msg}. Une commande @code{\space} dans
@code{msg} provoque un unique espace tapé, indépendant des espaces qui
l'entourent. Un @code{^^J} dans @code{msg} tape un saut à la ligne.
+@node \write
+@section @code{\write}
+
+@findex \write
+
+Synopsis :
+
+@example
+\write @var{numéro}@{@var{chaîne}@}
+@end example
+
+Écrit @var{chaîne} vers le fichier journal (@file{.log}), vers le
+terminal, ou vers un fichier ouvert par @code{\openout}. Par exemple,
+@code{\write6} écrit vers le flux textuel numéro 6
+
+Si le code suivant apparaît dans le fichier @file{@var{fichierbase}.tex}
+alors cela ouvre le fichier @file{@var{fichierbase}.jh}, y écrit
+@samp{Bonjour tout le monde !} et un saut le ligne, et ferme ce fichier.
+
+@example
+\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
+@end example
+
+@findex \newwrite
+@noindent
+Le @code{\newwrite} alloue un numéro de flux, en lui donnant un nom
+symbolique pour se faciliter la vie, de sorte que @code{flux
+\newwrite\monfichier\the\monfichier} produit quelque-chose du genre de
+@samp{flux 3}. Ensuite @code{\openout} associe le numéro de flux avec
+le nom de fichier fourni. Et puis à la fin @TeX{} exécute
+@code{\write3} ce qui place la chaîne dans le fichier.
+
+@cindex journal, écrire vers le fichier
+@cindex terminal, écrire vers le
+@cindex @math{-1}, écrire dans le flux numéro
+Typiquement @var{numéro} est compris entre 0 et 15, parce que typiquement
+les auteurs @LaTeX{} suivent l'exemple précédent et le numéro est alloué
+par le système. Si @var{numéro} est hors de l'intervalle de 0 à 15 ou
+si il n'est pas associé à un fichier ouvert alors @LaTeX{} écrit
+@var{chaîne} vers le fichier journal. Si @var{numéro} est positif alors
+ne plus @LaTeX{} écrit @var{chaîne} vers le terminal. Ainsi, @code{test
+\write-1@{Bonjour tout le monde !@}} place @samp{Bonjour tout le
+monde !} suivi d'un saut de ligne dans le fichier journal (c'est cez que
+la commande @code{\wlog} fait ; @pxref{\wlog}). Et
+@code{\write100@{Bonjour tout le monde !@}} met la même chose dans le
+fichier jornal mais aussi met @samp{Bonjour tout le monde !} suivi d'un
+saut de ligne dans la sortie terminal. (Mais 16, 17, et 18 sont des
+valeurs spéciales de @var{numéro} ; voir ci-dessous.)
+
+@cindex Lua@TeX{}, 256 flux de sortie dans
+Dans Lua@TeX{}, au lieu de 16 flux de sortie il y en a 256
+(@pxref{@TeX{} engines}).
+
+@findex \@@auxout
+@findex \@@mainaux
+Utilisez @code{\write\@@auxout@{@var{chaîne}@}} pour écrire vers le
+fichier @file{.aux} courant qui est associé soit au fichier racine soit
+au fichier inclus courant ; et utilisez
+@code{\write\@@mainaux@{@var{chaîne}@}} pour écrire le fichier
+@file{.aux} principal. Ces noms symboliques sont définis par @LaTeX{}.
+
+@c credit: David Carlisle https://tex.stackexchange.com/a/115933/121234
+Par défaut @LaTeX{} n'écrit pas @var{chaîne} vers le fichier
+immediatement. C'est ainsi parce que, par exemple, vous pourriez avoir
+besoin de @code{\write} pour sauvegarder le numéro de page courant, mais
+au moment où @TeX{} rencontre une commande @code{\write} tpyiquement il
+ne connaît pas quel est le numéro de page, puisque il n'a pas encore
+découpé la sortie en pages. Ainsi, vous utilisez @code{\write} dans
+l'un des trois contextes suivants :
+
+@example
+\immediate\write\@@auxout@{@var{chaîne}@} %1
+\write\@@auxout@{@var{chaîne}@} %2
+\protected@@write\@@auxout@{@}@{@var{chaîne}@} %3
+@end example
+
+@enumerate
+@item
+@cindex @code{\write} immédiat
+@findex \immediate\write
+Avec le premier, @LaTeX{} écrit @var{chaîne} vers le fichier
+immédiatement. Toutes les macros dans @var{chaîne} sont développées à
+fond (exactement comme dans @code{\edef} de sorte que pour empêcher le
+développement vous devez utiliser @code{\noexpand}, un @code{toks}, etc.
+mais avec la différence que vous devez utiliser @code{#} au lieu de
+@code{##}).
+
+@item
+@cindex @code{\write} retardé
+@cindex élément extraordinaire
+@findex \shipout @r{et développement}
+Avec le deuxième, @var{chaîne} est stocké dans la liste courante des
+choses (comme un élémént « extraordinaire » de @TeX{}) et conservé
+jusqu'à ce que la page soit éjectée et de la même manière les macros ne
+sont pas développées jusqu'à l'éjection (@code{\shipout}). Au moment du
+@code{\shipout}, @var{chaîne} est développée à fond.
+
+@item
+@findex \protected@@write
+Le troisième, @code{\protected@@write}, est sembable au deuxième sauf
+que vous pouvez utiliser @code{\protect} pour éviter le
+développement. Le premier argument qui est en plus vous permet d'insérer
+locallement des définitions supplémentaires pour que plus de macros
+soient protégées ou pour avoir d'autres définitions spéciales pendant
+l'écriture.
+@end enumerate
+
+
+Voici un exemple simple de développement avec @code{\write} dans lequel
+@var{chaîne} contient une séquence de contrôle @code{\triplex} que l'on
+a définie comme le texte @samp{XYZ} :
+
+@example
+\newwrite\fichierjh
+\openout\fichierjh=test.jh
+\newcommand@{\triplex@}@{XYZ@}
+\write\fichierjh@{test \triplex test@}
+@end example
+
+@noindent
+Ceci résulte en ce que le fichier @file{test.jh} contienne le texte
+@samp{test XYZtest} suivi d'un saut de ligne.
+
+@cindex @code{\write}, flux 16, 17, 18
+Les cas où @var{numéro} vaut 16, 17, ou 18 sont spéciaux. À cause du
+comportement de @code{\write} quand @var{numéro} est hors de
+l'intervalle de 0 à 15 qu'on a déjà décrit plus haut, dans Plain @TeX{}
+@code{\write16} et @code{\write17} é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'utiliser @code{\typeout}
+(@pxref{\typeout}). La commande @code{\write18} est encore plus
+spéciale ; les systèmes @TeX{} modernes l'utilisent pour passer des
+commandes au système d'exploitation (@pxref{\write18}).
+
+@cindex saut de ligne, dans @code{\write}
+@cindex @code{^^J}, dans @code{\write}
+D'ordinaire @code{\write} produit en sortie une unique ligne. On peut y
+insérer un saut de ligne avec @code{^^J}. Ainsi, l'exemple suivant
+produit deux lignes dans le fichier journal :
+
+@example
+\wlog@{Les lignes parallèles ont beaucoup en commun.^^JMais elles ne se
+rencontrent jamais.@}
+@end example
+
+@PkgIndex{answers}
+Un cas usuel dans lequel des auteurs tentent d'é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
+@file{answers}.
+
+@menu
+* \write et la securité: \write and security. Sécurité.
+* \message:: Écrit du texte vers le fichier journal et le terminal.
+* \wlog:: Écrit du texte vers le fichier journal.
+* \write18:: Exécute une commande du système d'exploitation.
+@end menu
+
+@node \write and security
+@subsection @code{\write} et la sécurité
+
+@cindex securité et @code{\write}
+@cindex @code{\write} et sécurité
+
+La possibilité d'écrire dans des fichier soulève des problèmes de
+sécurtié. Si vous compilez un fichier @LaTeX{} téléchargé et qu'il
+écrase votre fichier de mots de passe alors vous serez à juste titre
+embêté.
+
+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'exemple suivant
+
+@example
+\newwrite\fichierjh
+\openout\fichierjh=../test.jh
+@end example
+
+@noindent
+produit une erreur du genre de :
+@example
+Not writing to ../test.jh (openout_any = p).
+! I can't write on file `../test.jh'
+@end example
+
+@cindex répertoires parents, impossible d'écrire vers
+Il est possible d'avoir une telle erreur lorsqu'on essaie d'utiliser une
+commande telle que @code{\include@{../nomfichier@}} puisque @LaTeX{} va
+essayer d'ouvrir @file{../filename.aux}. 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.
+
+@node \message
+@subsection @code{\message}
+
+@findex \message
+
+Synopsis :
+
+@example
+\message@{@var{chaîne}@}
+@end example
+
+Écrit @var{chaîne} vers le fichier journal en @file{.log} et le
+terminal.
+
+Typiquement, les auteurs @LaTeX{} utilisent @code{\typeout}
+(@pxref{\typeout}) qui permet d'utiliser @code{\protect} sur toute
+commande fragile au sein de @var{chaîne} (@pxref{\protect}). Mais la
+commande @code{\typeout} insère un saut de ligne à la fin de
+@var{chaîne} contrairement à @code{\message}, aussi cette dernière peut
+être utile.
+
+Dans l'exemple ci-dessous dans le corps du document
+
+@example
+avant\message@{Un Deux@}\message@{Trois@}\message@{Quatre^^JLes@}
+\message@{pouces vont se battre.@}Après
+@end example
+
+@noindent
+dans certaines circonstances (voir ci-dessous) @LaTeX{} écrit ce qui suit
+à la fois vers le terminal et le fichier journal.
+
+@example
+Un Deux Trois Quatre
+Les pouces vont se battre.
+@end example
+
+@noindent
+Un @code{^^J} produit un saut de ligne. Aussi, dans le document
+en sortie, on a entre @samp{avant} et @samp{Après} un seul espace (issu
+de la fin de ligne suivant @samp{Les@}}).
+
+Alors que @code{\message} vous permet de mieux contrôler le formatage,
+un truc à piger c'est que @LaTeX{} peut très bien bousiller ce formatage
+là en insérant des sauts de ligne selon ce qu'il a déjà sorti. Comparez
+ce corps de document, où le @samp{Deux} a été déplacé, à celui donné en
+exemple plus haut.
+
+@example
+avant\message@{Un@}\message@{Deux Trois@}\message@{Quatre^^JLes@}
+\message@{pouces vont se battre.@}Après
+@end example
+
+La chose suivante peut se produire : lorsque @LaTeX{} produit les
+messages en sortie vers le terminal, le message avec @samp{Un} 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 @samp{Deux Trois}. 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'est pourquoi il est difficile de produire
+des lignes formatées précisément et d'une façon qui soit portable, et de
+même de demander que votre message commence au début d'une ligne.
+
+
+@node \wlog
+@subsection @code{\wlog}
+
+@findex \wlog
+
+Synopsis :
+
+@example
+\wlog@{@var{chaîne}@}
+@end example
+
+Écrit @var{chaîne} vers le fichier journal @file{.log}.
+
+@example
+\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.@}
+@end example
+
+D'ordinaire @var{chaîne} apparaît sur une seule ligne séparée. Utilisez
+@code{^^J} pour insérer un saut de ligne.
+
+@example
+\wlog@{C'est Helvetica qui téléphone à Times Roman :@}
+\wlog@{Change de ligne !^^JJe t'entends très mal.@}
+@end example
+
+
+@node \write18
+@subsection @code{\write18}
+@findex \write18
+@cindex externes, commandes
+@cindex commandes exécutées depuis @LaTeX{}
+@cindex système, commandes exécutées depuis @LaTeX{}
+@cindex interpréteur de commandes du système d'exploitation, accès à
+@c Derived from: Joseph Wright: https://tex.stackexchange.com/a/20446/121234
+
+Synopsis :
+
+@example
+\write18@{@var{commande_shell}@}
+@end example
+
+Émet une commande vers l'interpréteur du système d'exploitation. Le
+système d'exploitation exécute la commande et l'exécution de @LaTeX{}
+est bloquée jusqu'à ce que cela soit fini.
+
+@PkgIndex{Asymptote}
+La séquence suivante (sur Unix)
+
+@example
+\usepackage@{graphicx@} % dans le préambule
+ ...
+\newcommand@{\numerofig@}@{1@}
+\immediate\write18@{cd pix && asy figure\numerofig@}
+\includegraphics@{pix\figure\numerofig.pdf@}
+@end example
+
+@noindent
+exécute Asymptote (le programme @code{asy}) sur le fichier
+@file{pix/figure1.asy}, de sorte que le document peut par la suite lire
+le graphique en résultant (@pxref{\includegraphics}). Comme pour tout
+@code{\write}, ici @LaTeX{} développe les macros contenues dans
+@var{commande_shell} de sorte que @code{\numerofig} est remplacé par
+@samp{1}.
+
+Un autre exemple est que vous pouvez exécuter automatiquement Bib@TeX{}
+au début de chaque exécution de @LaTeX{} (@pxref{Using BibTeX}) en
+incluant @code{\immediate\write18@{bibtex8 \jobname@}} comme première
+ligne du fichier. Notez que @code{\jobname} se développe par défaut en
+le nom de base du fichier racine, ou bien l'argument de l'option
+@code{--jobname} si celle-ci est passée sur la ligne de commande.
+
+Il peut arriver que vous ayez besoin de plusieurs étapes pour obtenir
+l'information désirée. L'exemple suivant insère en entrée une liste de
+tous les fichiers PDF du répertoire courant (voir aussi
+@file{texosquery} plus bas) :
+
+@example
+\immediate\write18@{ls *.pdf > tmp.dat@}
+\input@{tmp.dat@}
+@end example
+
+Le comportement standard de tout @code{\write} est d'attendre jusqu'à la
+prochaine éjection de page avant de développer les macros ou d'écrire
+dans le flux (@pxref{\write}). Mais il se peut que vous désiriez que
+cela soit immédiat. Pour cela, utilisez
+@code{\immediate\write18@{@var{commande_shell}@}}.
+
+Autoriser l'usage de commandes système au sein d'un fichier @LaTeX{}
+pose des problème de sécurité évidents. Si vous télécharger un fichier
+depuis la Toile et qu'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'interdire l'accès complet à
+l'interpréteur de commande du système d'exploitation. Vous pouvez
+l'autoriser, si vous êtes sûr qu'il n'y a pas de danger, en compilant
+avec @code{latex --enable-write18 @var{nomfichier}} (@pxref{Command line
+options}). (L'option @code{--shell-escape} est un synonyme dans @TeX{}
+Live.)
+
+@cindex restreint, accès shell
+@cindex restreint, accès interpréteur de commande du système d'exploitation
+Au lieu de l'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'utilisez pas l'option
+@code{enable-write18}. 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 (@pxref{Command line options}).
+
+Certains paquetage ont besoin d'exécuter des commandes système
+externes. Par exemple @file{sagetex} vous permet de faire faire des
+calcul ou tracer des graphiques au logiciel de mathématiques @i{Sage},
+puis d'incorporer ces sorties dans votre document. Pour cela vous devez
+exécuter @LaTeX{} avec la fonction @code{\write18} pleinement débridée.
+
+@findex /bin/sh@r{, utilisé par @code{\write18}}
+@findex sh@r{, utilisé par @code{\write18}}
+@findex cmd.exe@r{, utilisé par @code{\write18}}
+@findex SHELL@r{, environnement, variables de}
+@findex SHELL@r{, variables d'environnement}
+Le texte @var{commande_shell} est toujours passé à @file{/bin/sh} sur
+les systèmes d'exploitation unixiens, et à l'interpréteur de commande DOS
+@file{cmd.exe} sur Windows. @LaTeX{} ignore tout réglage d'un autre
+interpréteur de commande par l'utilisateur, ainsi que la variable
+d'environnement @code{SHELL}.
+
+@PkgIndex{texosquery}
+@cindex système, information
+@cindex exploitation, information système de
+@cindex locale, information, du système
+@cindex répertoire, listage, du système
+Si votre besoin c'est d'avoir de l'information sur le système, comme le
+nom du système d'exploitation, celui de la locale, ou le contenu d'un
+répertoire, alors jeter un coup d'œil au paquetage @file{texosquery} qui
+fournit une interface commode et sûre pour cela, contrairement aux
+exemples donnés plus haut utilisant @code{\write18} à l'état brut :
+@url{https://ctan.org/pkg/texosquery}.
+
@node Command line
@chapter Ligne de commande
@cindex ligne de commande
-La spécification du fichier d'entrée indique le fichier à être formaté ;
-@TeX{} utilise @file{.tex} comme extension de fichier par défaut. Si
-vous omettez complètment le fichier d'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.
+Synopsis (depuis la ligne de commande d'un terminal) :
@example
-latex '\nonstopmode\input foo.tex'
+pdflatex @var{options} @var{argument}
+@end example
+
+Exécute @LaTeX{} sur @var{argument}. À la place de @command{pdflatex}
+vous pouvez aussi utiliser @command{xelatex}, ou @command{lualatex}, ou
+@command{latex}.
+
+L'exemple suivant exécute @LaTeX{} sur le fichier @file{these.tex}
+produisant en sortie @file{these.pdf}.
+
+@example
+pdflatex these
@end example
@noindent
-Traitera @file{foo.tex} sans faire de pause après chaque erreur.
+@findex .tex, @r{extension par défaut}
+Notez que @file{.tex} est l'extension par défault des noms de fichier.
+
+pdf@TeX{} est une évolution du programme original @TeX{}, comme le sont
+Xe@TeX{} et Lua@TeX{} (@pxref{@TeX{} engines}). 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'images tels que JPG et PNG, et les programmes de
+visionnage que l'on trouve de partout. En bref, si vous exécutez
+@command{pdflatex} ou @command{xelatex} ou @command{lualatex} alors par
+défaut vous obtenez un PDF et avez accès à toutes ses fonctions
+modernes. Si vous exécutez @command{latex}, ou @code{dvilualatex},
+alors vous obtenez un DVI. La description faite ici suppose
+pdf@LaTeX{}.
+
+@xref{Command line options}, pour une sélection des options de ligne de
+commande les plus utiles. Quant à @var{argument}, le cas habituel est
+qu'il ne commence pas par une contr'oblique, dans ce cas le système le
+prend pour un nom de fichier, et compile ce fichier. Si @var{argument}
+commence avec une contr'oblique, alors le système l'interprète comme une
+ligne d'entrée à @LaTeX{}, ce qui peut être utilisé pour obtenir
+certains effets spéciaux (@pxref{Command line input}).
+
+Si vous ne donnez aucun arguments ni options alors @command{pdflatex}
+invite à saisir à partir du terminal. Vous pouvez vous échapper de cela
+en entrant @kbd{CTRL-D}.
+
+Si @LaTeX{} trouve une erreur dans votre document alors par défaut il
+s'arrête et vous interroge à ce propos. @xref{Recovering from errors}
+pour un aperçu de quoi faire.
+
+@menu
+* Command line options:: Options usuelles de ligne de commande.
+* Command line input:: Spécifier du code LaTeX sur la ligne de commande.
+* Recovering from errors:: Quand quelque chose se passe mal.
+@end menu
+
+
+@node Command line options
+@section Options passées à la ligne de commande
+
+@cindex options passée à la ligne de commande
+
+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'exécuter @samp{latex --help} depuis la ligne de commande.
+
+Les implementations permettent en général de spécifier les options de
+ligne de commande avec un prefixe @samp{-} ou @samp{--}. C'est le cas à
+la fois pour @TeX{} Live (et Mac@TeX{}) et MiK@TeX{}. Ici on utilise
+les deux conventions indistinctement.
+
+@table @code
+@findex --version @r{ligne de commande, option}
+@item -version
+Affiche la version courante, comme @samp{pdfTeX 3.14159265-2.6-1.40.16
+(TeX Live 2015/Debian)} ainsi qu'une petite quantité d'information
+supplémentaire, et se termine.
+
+@findex --help @r{ligne de commande, option}
+@item -help
+Produit un message bref d'utilisation servant d'aide-mémoire et se
+termine.
+
+@anchor{interaction modes}
+@findex --interaction @r{ligne de commande, option}
+@item -interaction=@var{mode}
+@cindex batchmode
+@cindex scrollmode
+@cindex errorstopmode
+@cindex nonstopmode
+z@TeX{} compile un document en l'un parmi quatre modes possibles
+d'interaction : @code{batchmode}, @code{nonstopmode}, @code{scrollmode},
+@code{errorstopmode}. Dans le mode @dfn{errorstopmode} (le mode par
+défaut), @TeX{} s'arrête à chaque erreur et demande une intervention de
+l'utilisateur. Dans le mode @dfn{batchmode} il n'imprime rien sur le
+terminal, on défile sur les erreurs comme si l'utilisateur appuyait
+@kbd{RETURN} à chaque erreur, et les fichiers manquants entrainent la
+terminaison de la tâche. Dans le mode @dfn{nonstopmode}, les messages de
+diagnostic apparaissent sur le terminal mais comme dans le mode batch il
+n'y as pas d'interaction avec l'utilisateur. Dans le mode
+@dfn{scrollmode}, @TeX{} s'arrête en cas de fichiers manquants ou
+d'entrée clavier, mais pour nulle autre raison.
+
+Par exemple, en démarrant @LaTeX{} avec cette ligne de commande :
+
+@example
+pdflatex -interaction=batchmode @var{nomfichier}
+@end example
+
+@noindent
+on élimine la plupart des sorties terminal.
+
+@cindex jobname
+@cindex nom de fichier de la tâche courante
+@findex --jobname @r{ligne de commande, option}
+@item -jobname=@var{chaîne}
+Règle la valeur du @dfn{nom de tâche} de @TeX{} à la chaîne de
+caractères @var{chaîne}. Le fichier journal et le fichier de sortie
+s'appeleront @file{@var{chaîne}.log} et @file{@var{chaîne}.pdf}.
+
+Quand vous exécutez @code{@command{pdflatex} @var{options}
+@var{argument}}, si @var{argument} ne commence pas par une contr'oblique
+alors @TeX{} considère que c'est le nom d'un fichier à lire en
+entrée. Autrement il attend la première instruction @code{\input} et le
+nom du fichier en entrée devient le nom de tâche
+(@code{\jobname}). Celui-ci est utilisé pour nommer le fichier journal
+et le fichier de sortie. L'option @code{jobname} l'emporte et spécifie
+directement le nom. @xref{Command line input}, pour un examples
+d'usage.
+
+@anchor{output directory}
+@cindex répertoire de sortie pour tous les fichiers externes
+@cindex sortie, pour tous les fichiers externes, répertoire de
+@findex --output-directory @r{ligne de commande, option}
+@item -output-directory=@var{répertoire}
+Écrit les fichiers dans le répertoire @var{répertoire}. Il doit déjà
+exister. Ceci s'applique à tous les fichiers externes créés par @TeX{}
+ou @LaTeX{}, tels que le fichier @file{.log} de l'exécution, les
+fichiers @file{.aux}, @file{.toc}, etc., créés par @LaTeX{}, de même que
+le fichier de sortie principal @file{.pdf} ou @file{.dvi} lui-même.
+
+Lorsqu'il est spécifié, le répertoire de sortie @var{répertoire} 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.
+
+@cindex shell escape
+@cindex @code{\write18}, activation
+@findex --enable-write18 @r{ligne de commande, option}
+@findex --disable-write18 @r{ligne de commande, option}
+@findex --shell-escape @r{ligne de commande, option}
+@findex --no-shell-escape @r{ligne de commande, option}
+@item --enable-write18
+@itemx --disable-write18
+@itemx --shell-escape
+@itemx --no-shell-escape
+Activation et desactivation @code{\write18@{@var{commande_shell}@}}
+(@pxref{\write18}). 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.
+
+Activer cette fonction a des implications lourdes de sécurité, puisque
+cela permet à un fichier @LaTeX{} d'exécuter n'importe quelle commande.
+Ainsi, par défaut, le @code{\write18} non restreint n'est pas autorisé.
+(Le réglage par défaut de @TeX{} Live, Mac@TeX{}, et MiK@TeX{} est
+d'autoriser l'exécution d'un nombre limité de programmes en relation
+avec @TeX{}, et qu'elles distribuent).
+
+Pa exemple, si vous invoquez @LaTeX{} avec l'option
+@code{no-shell-escape}, et que dans votre document vous appelez
+@code{\write18@{ls -l@}}, alors vous n'obtenez pas d'erreur mais votre
+fichier journal dit @samp{runsystem(ls -l)...disabled}.
+
+@findex --halt-on-error @r{ligne de commande, option}
+@item -halt-on-error
+Arrête le traitement sur la première erreur.
+
+@findex --file-line-error @r{ligne de commande, option}
+@findex --no-file-line-error @r{ligne de commande, option}
+@item -file-line-error
+@item -no-file-line-error
+Active ou désactive le style
+@code{@var{nomfichier}:@var{numéroligne}:@var{erreur}} des messages
+d'erreur. Ces options ne sont disponibles qu'avec @TeX{} Live ou
+Mac@TeX{}.
+@end table
+
+
+@node Command line input
+@section Spécifier du code LaTeX sur la ligne de commande
+
+@cindex code entré sur la ligne de commande
+@cindex entré, code sur la ligne de commande
+
+Au sein de l'invocation de ligne de commande @code{pdflatex
+@var{options} @var{argument}} vous pouvez spécifier du code @LaTeX{}
+arbitraire en entrée en commençant @var{argument} par une
+contr'oblique. Ceci permet de faire certains effet spéciaux.
+
+@PkgIndex{hyperref}
+@c
+Par exemple, ce fichier (qui utilise le paquetage @file{hyperref} pour
+les hyperliens) peut produire deux types de sortie, l'un pour
+l'impression papier et l'autre pour une consultation PDF.
+
+@example
+\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
+ ...
+@end example
+
+@noindent
+Lorsqu'on compile ce document @file{book.tex} avec la ligne de commande
+@code{pdflatex book} le lien @samp{CTAN} sera en bleu. Mais si on le
+compile avec @code{pdflatex "\def\paperversion@{@}\input book.tex"},
+alors le lien sera en noir. (Notez l'utilise des guillemets anglais
+pour empécher l'interpretation des symboles par l'interpréteur de ligne
+de commande ; votre système fait peut-être cela différemment).
+
+De même, à partir d'un seul fichier @file{principal.tex} vous pouvez
+compiler deux versions distinctes.
+
+@c credit Paul Gaborit: https://tex.stackexchange.com/a/220101/121234
+@example
+pdflatex -jobname=etudiants "\def\etudiants@{@}\input@{principal@}"
+pdflatex -jobname=professeurs "\def\profs@{@}\input@{principal@}"
+@end example
+
+@noindent
+L'option @code{jobname} est là parce que sinon les deux fichiers en
+sortie s'appeleraient @file{principal.pdf} et le second écraseraient le
+premier.
+
+Dans ce dernier exemple on charge le paquetage @file{graphicx} avec l'option
+@code{draft}
+
+@c credit Herbert Voss: https://tex.stackexchange.com/a/17236/121234
+@example
+pdflatex -jobname=aa "\RequirePackage[draft]@{graphicx@}\input@{aa.tex@}"
+@end example
+
+@noindent
+de sorte que les fichiers graphiques ne sont lus que pour l'information
+de dimension de boîte englobante, mais non incorporés dans le PDF.
+(L'option @code{jobname} est la parce que sinon autrement le fichier de
+sortie s'appelerait @file{graphicx.pdf}, comme @code{\RequirePackage}
+fait lui-même un @code{\input}).
+
+
+@node Recovering from errors
+@section Quand quelque chose se passe mal
+
+Si @LaTeX{} trouve une erreur dans votre document alors il vous produit
+un message d'erreur et vous invite à la saisie par un point
+d'interrogation, @code{?}. Par exemple, exécuter @LaTeX{} sur ce fichier
+
+@example
+\newcommand@{\NP@}@{\ensuremath@{\textbf@{NP@}@}@}
+Le problème \PN@{@} est mis à prix à un million de dollars.
+@end example
+
+@noindent
+a pour effet qu'il affiche ceci, et attende une saisie :
+
+@example
+! Undefined control sequence.
+l.5 Le problème \PN
+ @{@} est mis à prix à un million de dollars.
+?
+@end example
+
+@noindent
+Le plus simple est de saisir @kbd{x} et @kbd{RETURN} et de corriger la
+coquille. Alternativement vous pourriez saisir @kbd{?} et @kbd{RETURN}
+pour voir les autres options.
-@cindex invite @samp{*}
@cindex @samp{*}, invite
+@cindex invite @samp{*}
@findex \stop
-Si @LaTeX{} s'arrête au milieu du document et vous fait une invite en
-@samp{*}, c'est qu'il attend que vous saisissiez quelque chose. Vous
-pouvez taper @code{\stop} (et retour-chariot) et il terminera
-prématurément le document.
+Il y a deux autres scénarios. Le premier est que vous ayez omis le
+@code{\end@{document@}} ou fait une faute de frappe dessus. Dans ce cas
+@LaTeX{} produit en invite @samp{*}. Vous pouvez revenir à la ligne de
+commande en tapant @kbd{\stop} et @kbd{RETURN}.
+
+Le dernier scénario est que vous ayez fait une faute de frappe sur le
+nom de fichier. Par exemple, au lieu de @code{pdflatex test} vous
+auriez tapé @code{pdflatex tste}.
+
+@example
+! I can't find file `tste'.
+<*> tste
+
+(Press Enter to retry, or Control-D to exit)
+Please type another input file name:
+@end example
+
+@noindent
+Le plus simple est de saisir @kbd{CTRL D} (en appuyant sur les touches
+Control et d simultannément), et d'ensuite retaper la ligne de commande
+correcte.
-@xref{@TeX{} engines}, pour les autres commandes système invoquant @LaTeX{}.
@node Document templates
@appendix Patrons de documents
@cindex patron de document
@cindex modèle de document
-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é à @url{http://tug.org/interest.html#latextemplates}.
+Bien qu'ils soient illustratifs, ces patrons de document vous seront
+put-être utiles. Davantage de ressources de patrons sont listées à
+@url{https://tug.org/interest.html#latextemplates}.
@menu
* patron @code{beamer}: beamer template.
+* patron @code{article}: article template.
* patron @code{book}: book template.
-* patron @code{tugboat}: tugboat template.
+* patron @code{book} plus élaboré: Larger book template.
@end menu
@@ -10775,6 +15583,7 @@ patrons sont listé à @url{http://tug.org/interest.html#latextemplates}.
@cindex @code{beamer} patron et classe
@cindex patron, @code{beamer}
+@PkgIndex{beamer}
La classe @code{beamer} crée des présentations en diapositives. Elle a
de très nombreuses possibilités, mais voici un patron de base :
@@ -10785,7 +15594,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}
@@ -10804,15 +15613,43 @@ de très nombreuses possibilités, mais voici un patron de base :
\end{document}
@end verbatim
-Une ressource web pour cela :
-@url{http://robjhyndman.com/hyndsight/beamer/}.
+Le paquetage Beamer sur le CTAN :
+@url{https://ctan.org/pkg/beamer}.
+@node article template
+@section Patron @code{article}
+
+@cindex patron (simple), @code{article}
+
+Un patron simple pour un article.
+
+@verbatim
+\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}
+@end verbatim
@node book template
@section Un patron @code{book}
@cindex patron, @code{book}
+Voici un patron simple pour un livre. @xref{Larger book template} pour
+un patron plus élaboré.
@verbatim
\documentclass{book}
@@ -10830,101 +15667,73 @@ Et du texte.
\section{Un sujet secondaire}
La fin.
+
\end{document}
@end verbatim
-@node tugboat template
-@section Un patron @code{tugboat}
-
-@cindex patron, TUGboat
-@cindex classe @code{ltugboat}
-
-@cite{TUGboat} est la revue du groupe des utilisateur de @TeX{} (@TeX{}
-Users Group), @url{http://tug.org/TUGboat}.
+@node Larger book template
+@section Un patron @code{book} plus élaboré
-@verbatim
-\documentclass{ltugboat}
-\usepackage{graphicx}
-\usepackage{ifpdf}
-\ifpdf
-\usepackage[breaklinks,hidelinks]{hyperref}
-\else
-\usepackage{url}
-\fi
+@cindex patron @code{book}
-\title{Exemple d'article \TUB}
+Voici un patron quelque peu élaboré pour un livre. @xref{book template}
+pour un patron plus simple.
-% 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/}
+Ce patron utilise un @code{\frontmatter}, @code{\mainmatter}, et
+@code{\backmatter} pour contrôler la typographie des trois zones
+principales d'un livre (@pxref{\frontmatter & \mainmatter &
+\backmatter}). Le livre a une bibliographie et un index.
- %%% Fin des métadonnées %%%
+Il est également à noter qu'il utilise @code{\include} et
+@code{\includeonly} (@pxref{Splitting the input}). 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 @code{\includeonly}. Ceci accélère la compilation sans
+perdre aucune information telle que les renvois. (Le matériel qu'il
+n'est pas nécessaire de mettre sur une nouvelle page est inclus avec
+@code{\input} au lieu de @code{\include} ; mais ceci au dépens du
+bénéfice de maintenir les valeurs de renvois).
-\begin{document}
-
-\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} -> {\small[er] fred} % prière d'utiliser !
-\cs{fred} -> \fred
-\meta{fred} -> <fred>
-\nth{n} -> 1st, 2nd, ...
-\sfrac{3/4} -> 3/4
-\booktitle{Book of Fred}
-\end{verbatim}
+@verbatim
+\documentclass[titlepage]{book}
+\usepackage{makeidx}\makeindex
-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}.
+\title{Book Class Template}
+\author{Alex Author}
-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}}.)
+\includeonly{%
+ frontcover,
+ preface,
+ chap1,
+ ...
+ }
-Écrivez par mél à \verb|tugboat@tug.org| en cas de problèmes ou
-questions.
+\begin{document}
+\frontmatter
+\include{frontcover}
+ % maybe comment out while drafting:
+\maketitle \input{dedication} \input{copyright}
+\tableofcontents
+\include{preface}
-\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}
@end verbatim
+
@node License translation, Concept Index, Document templates, Top
@comment node-name, next, previous, up
@appendix Traduction de la licence