summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/latex2e-help-texinfo-fr/latex2e-fr.dbk
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/latex/latex2e-help-texinfo-fr/latex2e-fr.dbk')
-rw-r--r--Master/texmf-dist/doc/latex/latex2e-help-texinfo-fr/latex2e-fr.dbk1394
1 files changed, 1138 insertions, 256 deletions
diff --git a/Master/texmf-dist/doc/latex/latex2e-help-texinfo-fr/latex2e-fr.dbk b/Master/texmf-dist/doc/latex/latex2e-help-texinfo-fr/latex2e-fr.dbk
index 0b0bc592ce0..8771be8b353 100644
--- a/Master/texmf-dist/doc/latex/latex2e-help-texinfo-fr/latex2e-fr.dbk
+++ b/Master/texmf-dist/doc/latex/latex2e-help-texinfo-fr/latex2e-fr.dbk
@@ -4,19 +4,22 @@
<!ENTITY latex "LaTeX">
]>
<book id="latex2e-fr.dbk" lang="fr">
-<title>manuel de référence de &latex;2e (Novembre 2016)</title>
+<title>manuel de référence officieux de &latex;2e (Août 2017)</title>
<!-- % ** fin de tête (c'est pour courir Texinfo sur une région.) -->
<!-- latex 2.09 commandes devraient tous être présents maintenant, -->
<!-- xx mais LaTeX2e substance est manquant. -->
<!-- xx une liste aléatoire de quelques items manquant est à la fin de ce fichier -->
<!-- -->
-<!-- xx \ProvidesPackage etc. -->
+<!-- xx misc commands from clsguide.pdf: MakeUpperCase, \ignorespacesafterend, -->
+<!-- \normalsfcodes -->
+<!-- xx color (include info from clsguide.pdf) -->
+<!-- xx ending a run with errors -->
<!-- xx ctan, distributions, composant de TeX -->
<!-- xx mention \nocorr, \textit et ic -->
<!-- xx donner réelle smallskip / etc. par défaut -->
<!-- -->
-<!-- xx fusionner http://www.ctan.org/pkg/latex-info (paquetage CTAN latex-info) -->
+<!-- xx fusionner http://ctan.org/pkg/latex-info (paquetage CTAN latex-info) -->
<!-- xx fusionner permutée-index -->
<!-- xx fusionner latex manuel de la savane -->
<!-- xx fusionner style mathématique hors texte -->
@@ -25,7 +28,7 @@
<!-- xx Le source2e typographie a un index avec tous noyau -->
<!-- commandes xx, même si certains sont internes et ne devraient pas être inclus. -->
<!-- xx classes.dtx et al. définir des commandes supplémentaires. -->
-<!-- xx Voir aussi http://www.ctan.org/pkg/macros2e. -->
+<!-- xx Voir aussi http://ctan.org/pkg/macros2e. -->
<!-- -->
<!-- packages xx - requis, plus, utile; Oberdiek; polices -->
@@ -33,9 +36,13 @@
<!-- http://david.carella.free.fr/fr/typographie/glossaire-typographique.html -->
<!-- http://www.cavi.univ-paris3.fr/phalese/desslate/index.htm -->
<!-- http://cahiers.gutenberg.eu.org/cg-bin/article/CG_2007___49_19_0.pdf -->
+<!-- Ainsi que http://gdt.oqlf.gouv.qc.ca/ -->
+<!-- -->
+<!-- Autres ressources: -->
+<!-- https://www.latex-project.org/help/books/lc2fr-apb.pdf -->
<bookinfo><legalnotice><para>Ce document est un manuel de référence officieux pour &latex;, un
-système de préparation de documents, version « Novembre 2016 ».
+système de préparation de documents, version « Août 2017 ».
</para>
<para>Ce manuel a été traduit du fichier <filename>LATEX.HLP</filename> v1.0a de la
bibliothèque d&#8217;aide VMS. La version pré-traduction a été rédigé par
@@ -49,10 +56,10 @@ C. Biemesderfer (publié par le &tex; Users Group en tant que
<citetitle>&tex;niques</citetitle> numéro 10), il l&#8217;a utilisé en tant que matériel de
référence (aucun texte n&#8217;était directement copié).
</para>
-<para>Tous droits réservés &#169; 2015, 2016 Vincent Belaïche &#8212; traduction.
+<para>Tous droits réservés &#169; 2015-2017 Vincent Belaïche &#8212; traduction.
Tous droits réservés &#169; 2007, 2008, 2009, 2010, 2011, 2012, 2013,
-2014, 2015, 2016 Karl Berry.
+2014, 2015, 2016, 2017 Karl Berry.
Tous droits réservés &#169; 1988, 1994, 2007 Stephen Gilmore.
@@ -61,6 +68,7 @@ Tous droits réservés &#169; 1994, 1995, 1996 Torsten Martinsen.
<para>Ci-après se trouve la licence sous laquelle est distribuée ce manuel,
une traduction en est donnée en annexe, voir <link linkend="License-translation">License translation</link>.
</para>
+<!-- start of License -->
<para>Permission is granted to make and distribute verbatim copies of
this manual provided the copyright notice and this permission notice
are preserved on all copies.
@@ -73,11 +81,12 @@ notice identical to this one.
</para>
<para>Permission is granted to copy and distribute translations of this manual
into another language, under the above conditions for modified versions.
+<!-- end of License -->
</para></legalnotice></bookinfo>
<para>Ce document est un manuel de référence officieux pour &latex;, un
-système de préparation de documents, version « Novembre 2016 ».
+système de préparation de documents, version « Août 2017 ».
</para>
<para>Ce manuel a été traduit du fichier <filename>LATEX.HLP</filename> v1.0a de la
bibliothèque d&#8217;aide VMS. La version pré-traduction a été rédigé par
@@ -91,10 +100,10 @@ C. Biemesderfer (publié par le &tex; Users Group en tant que
<citetitle>&tex;niques</citetitle> numéro 10), il l&#8217;a utilisé en tant que matériel de
référence (aucun texte n&#8217;était directement copié).
</para>
-<para>Tous droits réservés &#169; 2015, 2016 Vincent Belaïche &#8212; traduction.
+<para>Tous droits réservés &#169; 2015-2017 Vincent Belaïche &#8212; traduction.
Tous droits réservés &#169; 2007, 2008, 2009, 2010, 2011, 2012, 2013,
-2014, 2015, 2016 Karl Berry.
+2014, 2015, 2016, 2017 Karl Berry.
Tous droits réservés &#169; 1988, 1994, 2007 Stephen Gilmore.
@@ -103,6 +112,7 @@ Tous droits réservés &#169; 1994, 1995, 1996 Torsten Martinsen.
<para>Ci-après se trouve la licence sous laquelle est distribuée ce manuel,
une traduction en est donnée en annexe, voir <link linkend="License-translation">License translation</link>.
</para>
+<!-- start of License -->
<para>Permission is granted to make and distribute verbatim copies of
this manual provided the copyright notice and this permission notice
are preserved on all copies.
@@ -115,6 +125,7 @@ notice identical to this one.
</para>
<para>Permission is granted to copy and distribute translations of this manual
into another language, under the above conditions for modified versions.
+<!-- end of License -->
</para>
@@ -122,12 +133,10 @@ into another language, under the above conditions for modified versions.
<chapter label="" id="Top">
-<title>&latex;2e</title>
+<title>&latex;2e : un manuel de référence officieux</title>
-<para>Ce document est un manuel de référence officieux pour &latex;, un
-système de préparation de document, la version « Novembre 2016 ». Il
-est destiné à couvrir &latex;2e, qui a été la version standard de
-&latex; pendant de nombreuses années.
+<para>Ce document est un manuel de référence officieux pour &latex;2e, un
+système de préparation de document, dans sa version « Août 2017 ».
</para>
@@ -135,43 +144,64 @@ est destiné à couvrir &latex;2e, qui a été la version standard de
<chapter label="1" id="About-this-document">
<title>À propos de ce document</title>
-<indexterm role="cp"><primary>Knuth, Donald E.</primary></indexterm>
-<indexterm role="cp"><primary>Lamport, Leslie</primary></indexterm>
+<indexterm role="fn"><primary><ulink url="http://puszcza.gnu.org.ua/software/latexrefman/">http://puszcza.gnu.org.ua/software/latexrefman/</ulink> page d&#8217;accueil</primary></indexterm>
+<para>Ceci est un manuel de référence officieux pour le système &latex;2e de
+préparation de document, ce système est mis en oeuvre sous forme d&#8217;un
+paquet de macros pour le programme de composition &tex;
+(voir <link linkend="Overview">Overview</link>). La page d&#8217;accueil de ce document est
+<ulink url="http://puszcza.gnu.org.ua/software/latexrefman/">http://puszcza.gnu.org.ua/software/latexrefman/</ulink>. Cette page contient des liens vers
+les produits courants de fabrication du document dans différents
+formats, les sources, les listes de diffusion, et d&#8217;autres
+infrastructures.
+</para>
+<indexterm role="cp"><primary>&latex; ou &latex;2e, que choisir ?</primary></indexterm>
+<para>Dans ce document, on utilise principalement juste le terme « &latex; »
+plutôt que « &latex;2e », étant donné que la version précédente de
+&latex; (2.09) est gelée depuis des dizaines d&#8217;années.
+</para>
+<indexterm role="cp"><primary>officieuse, nature de ce document</primary></indexterm>
<indexterm role="cp"><primary>L&#8217;équipe de projet &latex;</primary></indexterm>
-<para>Le système &latex; de préparation de document est mis en oeuvre sous
-forme de macro forfait pour le programme de composition &tex; de
-Donald E. Knuth. &latex; a été créé à l&#8217;origine par Leslie
-Lamport ; c&#8217;est désormais maintenu par un groupe de bénévoles
+<indexterm role="fn"><primary><email>latexrefman@tug.org</email> adresse mél.</primary></indexterm>
+<para>&latex; est désormais maintenu par un groupe de bénévoles
(<ulink url="http://latex-project.org">http://latex-project.org</ulink>). La documentation officielle écrite
-par le projet &latex; est disponible à partir de leur site web.
-</para>
+par le projet &latex; est disponible à partir de leur site web.
+Le présent document est complètement officieux et n&#8217;a pas été examiné
+par les mainteneurs de &latex;.
+<indexterm role="cp"><primary>rapports d&#8217;anomalies</primary></indexterm>
<indexterm role="cp"><primary>rapports de bogues</primary></indexterm>
-<indexterm role="fn"><primary><email>latexrefman-discuss@gna.org</email> adresse mél</primary></indexterm>
-<para>Le présent document est complètement non officiel et n&#8217;a pas été examiné
-par les responsables &latex;. Ne pas envoyer des rapports de bugs ou
-rien d&#8217;autre sur ce document pour eux. Au lieu de cela, s&#8217;il vous plaît
-envoyer tous commentaires à <email>latexrefman-discuss@gna.org</email>.
+<indexterm role="cp"><primary>bogues, rapports</primary></indexterm>
+<indexterm role="cp"><primary>anomalies, rapports</primary></indexterm>
+Ne leur envoyez donc pas de rapports d&#8217;anomalie ou quoi que ce soit
+d&#8217;autre. Au lieu de cela, s&#8217;il vous plaît envoyez tous commentaires à
+<email>latexrefman@tug.org</email>.
</para>
-<para>La page d&#8217;accueil de ce document est
-<ulink url=""></ulink> http://home.gna.org/latexrefman. Cette page contient des liens vers la
-courant de sortie dans différents formats, sources, listes de diffusion, et d&#8217;autres
-infrastructure.
+<para>Ce document est un manuel de référence. Il y a une vaste gamme d&#8217;autres sources d&#8217;information sur
+&latex;, de tous niveaux. Voici quelques introductions :
</para>
-<para>Bien sûr, il ya beaucoup, beaucoup d&#8217;autres sources d&#8217;information sur
-&latex;. Voici quelques-unes:
+<!-- voir http://mirror.ctan.org/help/ctan/CTAN-upload-addendum.html#urls -->
+<variablelist><varlistentry><term><ulink url="http://ctan.org/pkg/latex-doc-ptr">http://ctan.org/pkg/latex-doc-ptr</ulink>
+</term><listitem><indexterm role="fn"><primary>latex-doc-ptr document</primary></indexterm>
+<para>Deux pages de références recommandées à &latex; documentation.
</para>
-<variablelist><varlistentry><term><ulink url="http://www.ctan.org/pkg/latex-doc-ptr">http://www.ctan.org/pkg/latex-doc-ptr</ulink>
-</term><listitem><para>Deux pages de références recommandées à &latex; documentation.
+</listitem></varlistentry><varlistentry><term><ulink url="http://ctan.org/pkg/first-latex-doc">http://ctan.org/pkg/first-latex-doc</ulink>
+</term><listitem><indexterm role="fn"><primary>first-latex-doc document</primary></indexterm>
+<para>Rédaction de votre premier document, avec un peu de texte et de mathématiques.
</para>
-</listitem></varlistentry><varlistentry><term><ulink url="http://www.ctan.org/pkg/first-latex-doc">http://www.ctan.org/pkg/first-latex-doc</ulink>
-</term><listitem><para>Rédaction de votre premier document, avec un peu de texte et de mathématiques.
+</listitem></varlistentry><varlistentry><term><ulink url="http://ctan.org/pkg/usrguide">http://ctan.org/pkg/usrguide</ulink>
+</term><listitem><indexterm role="fn"><primary>usrguide documentation officielle</primary></indexterm>
+<para>Le guide pour les auteurs de documents maintenu par le projet
+&latex;. Bien d&#8217;autres guides écrits par bien d&#8217;autres gens sont aussi
+disponibles, indépendamment du projet &latex; ; l&#8217;article suivant en
+est un.
</para>
-</listitem></varlistentry><varlistentry><term><ulink url="http://www.ctan.org/pkg/usrguide">http://www.ctan.org/pkg/usrguide</ulink>
-</term><listitem><para>Le guide pour les auteurs de documents conservés dans le cadre de &latex;; là
-plusieurs autres.
+</listitem></varlistentry><varlistentry><term><ulink url="http://ctan.org/pkg/lshort">http://ctan.org/pkg/lshort</ulink>
+</term><listitem><indexterm role="fn"><primary>lshort document</primary></indexterm>
+<para>Une courte (?) indoduction à &latex;, traduite en de nombreuses langues
+(traduction française : <ulink url="http://ctan.org/pkg/lshort-french">http://ctan.org/pkg/lshort-french</ulink>).
</para>
+
</listitem></varlistentry><varlistentry><term><ulink url="http://tug.org/begin.html">http://tug.org/begin.html</ulink>
-</term><listitem><para>Introduction à l&#8217;&tex; système, y compris &latex;.
+</term><listitem><para>Introduction au système &tex;, y compris &latex;, et plus amples références.
</para></listitem></varlistentry></variablelist>
</chapter>
@@ -223,8 +253,8 @@ brut, écrivez le &#8216;<literal>LaTeX</literal>&#8217;.
<title>Début et fin</title>
<anchor id="Starting-_0026-ending"/><!-- ancien nom du noeud -->
-<indexterm role="cp"><primary>de démarrage et de fin</primary></indexterm>
-<indexterm role="cp"><primary>fin et à partir</primary></indexterm>
+<indexterm role="cp"><primary>début et fin</primary></indexterm>
+<indexterm role="cp"><primary>fin et début</primary></indexterm>
<indexterm role="cp"><primary>Bonjour le monde</primary></indexterm>
<para>Les fichiers &latex; ont une structure globale simple, avec un début et
@@ -255,7 +285,7 @@ aucun autre) est obligatoire dans tous les documents &latex;
d&#8217;environnements, et bien plus encore sont définis séparément.
Voir <link linkend="Environments">Environments</link>.
</para>
-<para>Les sections suivantes discute de la façon de produire des PDF et
+<para>Les rubriques suivantes discutent de la façon de produire des PDF et
d&#8217;autres format de sortie à partir d&#8217;un fichier d&#8217;entrée &latex;.
</para>
@@ -275,12 +305,12 @@ soit en <filename>.dvi</filename> soit en <filename>.pdf</filename>.
<indexterm role="fn"><primary>commande dvipdfmx</primary></indexterm>
<indexterm role="fn"><primary>commande dvitype</primary></indexterm>
<para>Si il est invoqué avec la commande système <command>latex</command>, alors il
-produit un fichier &#8220;Device Independent&#8221;<footnote><para>Indépendant du
+produit un fichier « DeVice Independent<footnote><para>Indépendant du
périphérique de sortie, ce n&#8217;est toutefois pas un format portable de
-document</para></footnote> (<filename>.dvi</filename>). Vous pouvez visualiser ce fichier avec une
+document</para></footnote> » (<filename>.dvi</filename>). Vous pouvez visualiser ce fichier avec une
commande comme <command>xdvi</command>, ou le convertir en fichier PostScript
-<literal>.ps</literal> avec <command>dvips</command> ou en fichier &#8220;Portable Document
-Format&#8221;<footnote><para>Format portable de document</para></footnote> <literal>.pdf</literal> avec
+<literal>.ps</literal> avec <command>dvips</command> ou en fichier « Portable Document
+Format<footnote><para>Format portable de document</para></footnote> » <literal>.pdf</literal> avec
<command>dvipdfmx</command>. Un grand nombre d&#8217;autres progammes utilitaires DVI
sont disponibles (<ulink url="http://mirror.ctan.org/dviware">http://mirror.ctan.org/dviware</ulink>).
</para>
@@ -317,7 +347,7 @@ les polices et images incorporées.
</term><listitem><indexterm role="cp"><primary>fichier de transcription</primary></indexterm>
<indexterm role="cp"><primary>fichier journal</primary></indexterm>
<indexterm role="fn"><primary>fichier .log</primary></indexterm>
-<para>La &#8220;fichier de transcription&#8221; ou fichier <filename>.log</filename> qui contient des
+<para>Ce fichier de transcription, ou <firstterm>fichier journal</firstterm>, contient des
informations sommaires telles que la liste des paquetages chargés. Il
contient aussi des messages de diagnostic
<!-- - pour toutes les erreurs découvertes dans le fichier d'entrée. -->
@@ -334,7 +364,7 @@ erreurs.
telles que les doubles renvois. Par exemple, la première fois que
&latex; trouve un renvoi en aval &#8212; une double référence à
quelque-chose qui n&#8217;est pas encore apparu dans le code source &#8212; il
-apparâtra dans la sortie comme un double point d&#8217;interrogation
+apparaîtra dans la sortie comme un double point d&#8217;interrogation
<literal>??</literal>. Quand l&#8217;endroit auquel le renvoi fait référence finit par
appraître dans le code source, alors &latex; écrit son information de
localisation dans ce fichier <literal>.aux</literal>. À l&#8217;invocation suivante,
@@ -347,11 +377,11 @@ d&#8217;interrogation avec la localisation mémorisée.
<!-- - les énumérer tous. Composants Xxx? -->
<indexterm role="fn"><primary>.lof fichier</primary></indexterm>
-<indexterm role="cp"><primary>list of figures file</primary></indexterm>
+<indexterm role="cp"><primary>liste des figures, fichier</primary></indexterm>
<indexterm role="fn"><primary>.lot fichier</primary></indexterm>
-<indexterm role="cp"><primary>list of tables file</primary></indexterm>
+<indexterm role="cp"><primary>liste des tableaux, fichier</primary></indexterm>
<indexterm role="fn"><primary>.toc fichier</primary></indexterm>
-<indexterm role="cp"><primary>fichier table des matières</primary></indexterm>
+<indexterm role="cp"><primary>table des matières, fichier</primary></indexterm>
<indexterm role="cp"><primary>matières, fichier</primary></indexterm>
<para>&latex; peut produire encore d&#8217;autres fichiers, caractérisés par la
terminaison du nom de fichier. Ceux-ci incluent un fichier <literal>.lof</literal>
@@ -394,8 +424,8 @@ original de Knuth (<ulink url="http://ctan.org/pkg/etex">http://ctan.org/pkg/ete
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</command>, mais le
-langage du fichier d&#8217;entrée est &tex; (et le fichier produit est un
-<filename>.dvi</filename>).
+langage du fichier d&#8217;entrée est du &tex; de base (et le fichier produit
+est un <filename>.dvi</filename>).
</para>
<para>Dans d&#8217;autres distributions &tex;, <command>latex</command> peut invoquer
e-&tex; plutôt que pdf&tex;. Dans tous les cas, on peut faire
@@ -430,7 +460,7 @@ en sortie ; il ne prend pas en charge la sortie DVI.
<para>En interne, Xe&tex; crée un fichier <literal>.xdv</literal> file, une variante de
DVI, et traduit cela en PDF en utilisant le
programme (<literal>x</literal>)<literal>dvipdfmx</literal>, mais ce processus est automatique.
-LE fichier <literal>.xdv</literal> n&#8217;est utile que pour le débogage.
+Le fichier <literal>.xdv</literal> n&#8217;est utile que pour le débogage.
</para>
</listitem></varlistentry></variablelist>
<para>D&#8217;autres vairantes de &latex; et &tex; existent, par ex. pour fournir
@@ -453,8 +483,8 @@ chaîne de lettres ou (b) une unique non-lettre.
</para>
<para>Les noms de commandes &latex; sont sensibles à la casse de sorte que
<literal>\pagebreak</literal> diffère de <literal>\Pagebreak</literal> (ce dernier n&#8217;est pas une
-commande standarde). La plupart des nom de commandes sont en bas de
-casse, mais en tout cas vous devez saisir toutes les commande dans la
+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.
</para>
<para>Une commande peut être suivie de zéro, un ou plus d&#8217;arguments. Ces
@@ -482,9 +512,10 @@ involontaires, ou bogues de ce manuel).
</para>
-<anchor id="Environment"/>
+<sect2 label="2.4.1" id="Environment">
+<title>Les environnements</title>
-<para>Synopsis:
+<para>Synopsis :
</para>
<screen>\begin{<replaceable>nom environnement</replaceable>}
...
@@ -517,14 +548,18 @@ obligatoire (il spécifie le format des colonnes).
\end{tabular}
</screen>
-<anchor id="Declaration"/>
+</sect2>
+<sect2 label="2.4.2" id="Declaration">
+<title>Les déclarations de commandes</title>
<para>Une commande qui change la valeur, ou change la signification, d&#8217;une
autre commande ou paramètre. Par exemple, la commande <literal>\mainmatter</literal>
change le réglage de la numérotation des pages en passant de numéros
romains à des numéros arabes.
</para>
-<anchor id="_005cmakeatletter-and-_005cmakeatother"/>
+</sect2>
+<sect2 label="2.4.3" id="_005cmakeatletter-and-_005cmakeatother">
+<title><literal>\makeatletter</literal> et <literal>\makeatother</literal></title>
<para>Synopsis :
</para>
@@ -568,79 +603,225 @@ catégorie de l&#8217;arobe à celui d&#8217;une lettre.
<indexterm role="fn"><primary>paquetage <literal>macros2e</literal></primary></indexterm>
<indexterm role="fn"><primary><literal>macros2e</literal>, paquetage</primary></indexterm>
<para>Pour une liste complète des macros contenant un arobe dans leur nom,
-voir le document <ulink url="http://www.ctan.org/pkg/macros2e">http://www.ctan.org/pkg/macros2e</ulink>. Ces macros sont
-surtout utiles aux auteurs de classe et de paquetage. Des exemples
-utiles pour les auteurs de document sont donnés ci-après :
+voir le document <ulink url="http://ctan.org/pkg/macros2e">http://ctan.org/pkg/macros2e</ulink>. Ces macros sont
+surtout à l&#8217;intention des auteurs de classes et de paquetages.
</para>
+<!-- xxxx TODO : ajouter une avertissement sur cet exemple. -->
+<para>L&#8217;exemple ci-après est typique. Une commande
+<literal>\these@nomuniversite</literal> se trouve dans le fichier de classe de
+l&#8217;utilisateur. L&#8217;utilisateur veut changer sa définition. Pour cela, il
+suffit d&#8217;insérer les trois lignes suivantes dans le préambule, avant le
+<literal>\begin{document}</literal> :
+</para>
+<screen>\makeatletter
+\renewcommand{\these@nomuniversite}{Université Lyon III Jean Moulin}
+\makeatother
+</screen>
+
-<anchor id="_005c_0040startsection"/>
+<sect3 label="2.4.3.1" id="_005c_0040startsection">
+<title><literal>\@startsection</literal></title>
<para>Synopsis :
</para>
<screen>\@startsection{<replaceable>nom</replaceable>}{<replaceable>niveau</replaceable>}{<replaceable>retrait</replaceable>}{<replaceable>avant</replaceable>}{<replaceable>après</replaceable>}{<replaceable>style</replaceable>}
</screen>
-<para>Cette commande permet de redéfinir les commandes de rubricage. Par ex.
-le code source ci-dessous, si placé dans le préambule, redéfinit la
-commande de rubricage <literal>\section</literal> pour qu&#8217;elle centre le titre, le
-mette en gras, et ajuste l&#8217;espacement :
-</para>
-<screen>\makeatletter
-\renewcommand\section{%
- \@startsection{section}% <link linkend="_005c_0040startsection_002fname">Nom</link>
- {1}% <link linkend="_005c_0040startsection_002flevel">Niveau</link> : 0=part, 1=chapter, etc.
- {0pt}% <link linkend="_005c_0040startsection_002fretrait">Renfoncement du titre</link>
- {-3.5ex plus -1ex minus -.2ex}% <link linkend="_005c_0040startsection_002fbeforeskip">Saut vertical avant (pas de renfoncement si négatif)</link>
- {2.3ex plus.2ex}% <link linkend="_005c_0040startsection_002fafterskip">Saut vertical après (si négatifif&#44; fait corps avec la suite)</link>
- {\centering\normalfont\Large
- \bfseries}}% <link linkend="_005c_0040startsection_002fstyle">Style du titre</link>
-\makeatother
-</screen>
-<para>La commande <literal>\@startsection</literal> prend six arguments.
+<para>Cette commande permet de redéfinir les commandes de rubricage telles que <literal>\section</literal> ou <literal>\subsection</literal>.
+</para>
+<para>Notez que le paquetage <filename>titlesec</filename> rend la manipulation du rubricage
+plus facile. De plus, bien que la plupart des exigences concernant les
+commandes de rubricage peuvent être remplies avec
+<literal>\@startsection</literal>, ce n&#8217;est pas le cas de toutes. Par exemple,
+dans les classes &latex; standardes <literal>book</literal> et <literal>report</literal> les
+commandes <literal>\chapter</literal> et <literal>\report</literal> ne sont pas construite de
+cette manière. Pour fabriquer une telle commande il est possible
+d&#8217;utiliser la commande <literal>\secdef</literal>.
+<!-- xx define, and make a cross reference to, secdef. -->
+</para>
+<para>Techniquement, cette commande a la forme :
+</para><screen>\@startsection{<replaceable>nom</replaceable>}{<replaceable>niveau</replaceable>}{<replaceable>retrait</replaceable>}{<replaceable>avant</replaceable>}{<replaceable>après</replaceable>}{<replaceable>style</replaceable>}
+ *[<replaceable>titretdm</replaceable>]{<replaceable>titre</replaceable>}
+</screen><para>de sorte que faire :
+</para><screen>\renewcommand{\section}{\@startsection{<replaceable>nom</replaceable>}{<replaceable>niveau</replaceable>}{<replaceable>retrait</replaceable>}%
+ {<replaceable>avant</replaceable>}{<replaceable>après</replaceable>}{<replaceable>style</replaceable>}}
+</screen><para>redéfinit <literal>\section</literal> en gardant sa forme standarde d&#8217;appel
+<literal>\section*[<replaceable>titretdm</replaceable>]{<replaceable>titre</replaceable>}</literal>. Voir <link linkend="Sectioning">Sectioning</link> et
+les exemples plus bas.
</para>
+
<variablelist>
<varlistentry><term><replaceable>nom</replaceable>
-</term><listitem><anchor id="_005c_0040startsection_002fname"/><para>Nom de la commande de rubricage, par ex. <literal>paragraph</literal>
+</term><listitem><anchor id="_005c_0040startsection_002fname"/><para>Nom du compteur (qui doit être défini
+séparément) utilisé pour numéroter le titre de rubrique. Ceux le plus
+communément utilisés sont <literal>section</literal>, <literal>subsection</literal>, ou
+<literal>paragraph</literal>. Bien que dans ces trois cas le nom du compteur soit le
+même que celui de la commande elle-même, utiliser le même nom n&#8217;est pas
+exigé.
+</para>
+<para>Alors <literal>\the</literal><replaceable>name</replaceable> affiche le numéro de titre, et
+<literal>\</literal><replaceable>name</replaceable><literal>mark</literal> sert aux en-têtes de page.
</para>
</listitem></varlistentry><varlistentry><term><replaceable>niveau</replaceable>
-</term><listitem><anchor id="_005c_0040startsection_002flevel"/><para>Profondeur de la commande de
-rubricage, par ex. 0 pour <literal>part</literal>, 1 pour <literal>chapter</literal>, 2
-pour <literal>section</literal>. Cette valeur est comparée aux compteurs
-<literal>secnumdepth</literal> et <literal>tocdepth</literal> pour contrôler la numéroation des
-rubriques et la profondeur de la table des matières.
+</term><listitem><anchor id="_005c_0040startsection_002flevel"/><para>Un entier donnant la profondeur de la
+commande de rubricage, par ex. 0 pour <literal>chapter</literal> (ceci ne
+s&#8217;applique qu&#8217;aux classes standardes <literal>book</literal> et <literal>report</literal>), 1
+pour <literal>section</literal>, 2 pour <literal>subsection</literal>, 3 pour
+<literal>subsubsection</literal>, 4 pour <literal>paragraph</literal> et 5 pour
+<literal>subparagraph</literal>. Dans les classes <literal>book</literal> et <literal>report</literal>,
+<literal>part</literal> a pour niveau -1, alors que dans la classe <literal>article</literal>,
+<literal>part</literal> a pour niveau 0.
+</para>
+<para>Si <replaceable>niveau</replaceable> est inférieur ou égal à la valeur de <literal>secnumdepth</literal>
+alors les titres pour cette commande de rubricage sont numérotés. Par
+ex. dans un <literal>article</literal>, si <literal>secnumdepth</literal> vaut 1 alors une
+commande <literal>\section{Introduction}</literal> produira en sortie quelque
+chose du genre de <literal>1 Introduction</literal> alors que
+<literal>\subsection{Historique}</literal> produit en sortie quelque chose du
+genre de <literal>Historique</literal>, sans numéro en
+préfixe. Voir <link linkend="Sectioning_002fsecnumdepth">Sectioning/secnumdepth</link>.
+</para>
+<para>Si <replaceable>niveau</replaceable> est inférieur ou égal à la valeur de <literal>secnumdepth</literal>
+alors la table des matières aura un article pour cette rubrique. Par
+exemple, dans un <literal>article</literal>, si <literal>tocdepth</literal> vaut 1 alors la
+table des matières listera les <literal>section</literal>s, mais pas les
+<literal>subsection</literal>s.
</para>
+
</listitem></varlistentry><varlistentry><term><replaceable>retrait</replaceable>
-</term><listitem><anchor id="_005c_0040startsection_002fretrait"/><para>Renfoncement du titre. Pour un
-renfoncement nul, vous pouvez utiliser la macro <literal>\z@</literal> définie à
-<literal>0pt</literal> pour que le code soit plus efficace.
+</term><listitem><anchor id="_005c_0040startsection_002findent"/><para>Une longueur donnant le renfoncement de
+toutes les lignes du titre relativement à la marge. Pour un
+renfoncement nul, utilisez <literal>0pt</literal>.
+<!-- vous pouvez utiliser la macro @code{\z@@} définie à @code{0pt} pour -->
+<!-- que le code soit plus efficace -->
+Une valeur négative telle que <literal>-1em</literal> cause un débord du titre dans
+la marge.
</para>
</listitem></varlistentry><varlistentry><term><replaceable>avant</replaceable>
-</term><listitem><anchor id="_005c_0040startsection_002fbeforeskip"/><para>Longueur dont la valeur absolue est la longueur de l&#8217;espace verticale à
-insérer avant le titre. Pour une bonne composition, utilisez une
-longueur élastique.
-</para>
-<para>Si en plus <replaceable>avant</replaceable> est négatif, alors le premier paragraphe suivant
-immédiatement le titre n&#8217;est pas renfoncé.
+</term><listitem><anchor id="_005c_0040startsection_002fbeforeskip"/><para>Longueur dont la valeur absolue est
+la longueur de l&#8217;espace vertical à insérer avant le titre de la
+rubrique. Cet espacement est ignoré si la rubrique commence au début
+d&#8217;une page. Si en plus <replaceable>avant</replaceable> est négatif, alors le premier
+paragraphe suivant immédiatement le titre n&#8217;est pas renfoncé, s&#8217;il est
+positif ou nul il l&#8217;est. (Notez que l&#8217;opposé de <literal>1pt plus 2pt
+minus 3pt</literal> est <literal>-1pt plus -2pt minus -3pt</literal>).
+</para>
+<para>Par exemple si <replaceable>avant</replaceable> vaut <literal>-3.5ex plus -1ex minus -0.2ex</literal>
+alors pour commencer la nouvelle rubrique, &latex; ajoute environ 3,5
+fois la hauteur d&#8217;une lettre x en espace veritical, et le premier
+paragraphe de la rubrique n&#8217;est pas renfoncé. Utiliser une longueur
+élastique, c.-à-d. comprenant <literal>plus</literal> et <literal>minus</literal>, est une
+bonne pratique ici car cela donne à &latex; plus de latitude lors de la
+fabrication de la page.
+</para>
+<para>La quantité totale d&#8217;espace vertical entre la ligne de base de la ligne
+précédant le titre de cette rubrique est la ligne de base du titre est
+la somme du <literal>\parskip</literal> dans la police du corps de texte, du
+<literal>\baselineskip</literal> de la police du titre, et de la valeur absolue de
+l&#8217;argument <replaceable>avant</replaceable>. Cet espace est typiquement élastique et peut se
+dilater ou se contracter. (Si la rubrique commence en début d&#8217;une page
+de sorte que cet espace soit ignoré, alors la ligne de base du titre
+correspond à la ligne de base qu&#8217;aurait la première ligne de texte sur
+cette page si celle-ci commençait par du texte).
</para>
</listitem></varlistentry><varlistentry><term><replaceable>après</replaceable>
-</term><listitem><anchor id="_005c_0040startsection_002fafterskip"/><para>Longueur. Lorsque elle est positive,
-il s&#8217;agit de l&#8217;espace verticale à insérer après le titre. Pour une
-bonne composition, utilisez dans ce cas une longueur élastique.
-</para>
-
-<para>Lorsque elle est négative, alors le titre fait corps avec le paragraphe
-le suivant immédiatement, comme c&#8217;est le cas pour les rubriques
-<literal>\paragraph</literal> dans la classe de document <literal>article</literal>, et la
-valeur absolue d&#8217;<replaceable>après</replaceable> donne l&#8217;espace horizontale entre la fin du
-dernier mot du titre et le début du premier mot du paragraphe avec
-lequel il fait corps.
+</term><listitem><anchor id="_005c_0040startsection_002fafterskip"/><para>Longueur. Lorsque elle est positive
+ou nulle, il s&#8217;agit de l&#8217;espace vertical à insérer après le titre de la
+rubrique. Lorsque elle est négative, alors le titre fait corps avec le
+paragraphe le suivant immédiatement. Dans ce cas la valeur absolue de
+la longueur donne l&#8217;espace horizontal entre la fin du titre et le début
+du paragraphe suivant. (Notez que l&#8217;opposé de <literal>1pt plus 2pt minus
+3pt</literal> est <literal>-1pt plus -2pt minus -3pt</literal>).
+</para>
+<para>Comme c&#8217;est le cas avec <replaceable>avant</replaceable>, utiliser une longueur élastique
+avec des composantes <literal>plus</literal> et <literal>minus</literal> est une bonne pratique
+ici puisque elle donne à &latex; plus de latitude pour assembler la
+page.
+</para>
+<para>Si <replaceable>après</replaceable> est positif ou nul alors la quantité totale d&#8217;espace
+vertical entre la ligne de base du titre de la rubrique et la ligne de
+base de la première ligne du paragraphe suivant est la somme du
+<literal>\parskip</literal> de la police du titre, de <literal>\baselineskip</literal> de la
+police du corps de texte, et de la valeur de <replaceable>après</replaceable>. Cet espace est
+typiquement élastique de sorte qu&#8217;il puisse se dilater ou se
+contracter. (Notez que du fait que le signe d&#8217;<replaceable>après</replaceable> contrôle que
+le titre soit indépendant du texte le suivant, ou fasse corps avec lui,
+vous ne pouvez pas utiliser un <replaceable>après</replaceable> négatif pour annuler une
+partie du <literal>\parskip</literal>).
</para>
-
</listitem></varlistentry><varlistentry><term><replaceable>style</replaceable>
-</term><listitem><anchor id="_005c_0040startsection_002fstyle"/><para>Les commandes qui règlent le style du
-titre, par ex. <literal>\bfseries</literal> pour des caractères gras.
+</term><listitem><anchor id="_005c_0040startsection_002fstyle"/><para>Contrôle le style du titre, voir les
+exemples plus bas. Les commandes typiquement utilisées ici sont
+<literal>\centering</literal>, <literal>\raggedright</literal>, <literal>\normalfont</literal>,
+<literal>\hrule</literal>, ou <literal>\newpage</literal>. La dernière commande au sein de
+<replaceable>style</replaceable> peut être une commande prenant un argument, telle que
+<literal>\MakeUppercase</literal> ou <literal>\fbox</literal>. Le titre de la rubrique est passé
+en argument à cette commande. Par exemple régler <replaceable>style</replaceable> à
+<literal>\bfseries\MakeUppercase</literal> a pour effet de produire des titres gras
+et en capitales.
</para></listitem></varlistentry></variablelist>
-<anchor id="_005c_0040ifstar"/>
+<para>Voici des exemples. Pour les utiliser mettez les soit au sein d&#8217;un
+fichier de paquetage ou de classe, ou placez les dans le préambule d&#8217;un
+document &latex; entre des commandes <literal>\makeatletter</literal> et
+<literal>\makeatother</literal>. (Le message d&#8217;erreur <literal>You can't use
+`\spacefactor' in vertical mode.</literal> est le plus probable lorsque on
+oublie de faire cela). Voir <link linkend="_005cmakeatletter-and-_005cmakeatother">\makeatletter and \makeatother</link>.
+</para>
+<para>L&#8217;exemple suivant redéfinit la commande de rubricage <literal>\section</literal>
+pour qu&#8217;elle centre le titre et le mette en gras :
+</para>
+<screen>\renewcommand\section{%
+ \@startsection{section}% <link linkend="_005c_0040startsection_002fname"><replaceable>nom</replaceable></link>.
+ {1}% <link linkend="_005c_0040startsection_002flevel"><replaceable>niveau</replaceable></link>.
+ {0pt}% <link linkend="_005c_0040startsection_002findent"><replaceable>retrait</replaceable></link>.
+ {-3.5ex plus -1ex minus -.2ex}% <link linkend="_005c_0040startsection_002fbeforeskip"><replaceable>avant</replaceable></link>.
+ {2.3ex plus.2ex}% <link linkend="_005c_0040startsection_002fafterskip"><replaceable>après</replaceable></link>.
+ {\centering\normalfont\Large\bfseries}}% <link linkend="_005c_0040startsection_002fstyle"><replaceable>style</replaceable></link>.
+</screen>
+<para>Cet exemple met les titres de <literal>subsection</literal> en petites capitales, et
+leur fait faire corps avec le paragraphe suivant.
+</para>
+<screen>\renewcommand\subsection{%
+ \@startsection{subsection}% <link linkend="_005c_0040startsection_002fname"><replaceable>nom</replaceable></link>.
+ {2}% <link linkend="_005c_0040startsection_002flevel"><replaceable>niveau</replaceable></link>.
+ {0em}% <link linkend="_005c_0040startsection_002findent"><replaceable>retrait</replaceable></link>.
+ {-1ex plus 0.1ex minus -0.05ex}% <link linkend="_005c_0040startsection_002fbeforeskip"><replaceable>avant</replaceable></link>.
+ {-1em plus 0.2em}% <link linkend="_005c_0040startsection_002fafterskip"><replaceable>après</replaceable></link>.
+ {\scshape}% <link linkend="_005c_0040startsection_002fstyle"><replaceable>style</replaceable></link>.
+ }
+</screen>
+<para>Les exemples précédents redéfinissait les commandes de titre de
+rubriques existantes. celui-ci en définit une nouvelle, illustrant la
+nécessité d&#8217;un compteur et de macros pour son affichage.
+</para>
+<!-- From https://groups.google.com/forum/#!searchin/comp.text.tex/startsection%7Csort:relevance/comp.text.tex/sB-nTS-oL08/ZZeKYdG0llMJ -->
+<screen>\setcounter{secnumdepth}{6}% affiche les compteur justqu'à ce niveau
+\newcounter{subsubparagraph}[subparagraph]% compteur pour la
+ % numérotation
+\renewcommand{\thesubsubparagraph}%
+ {\thesubparagraph.\@arabic\c@subsubparagraph}% comment afficher
+ % la numérotation
+\newcommand{\subsubparagraph}{\@startsection
+ {subsubparagraph}%
+ {6}%
+ {0em}%
+ {\baselineskip}%
+ {0.5\baselineskip}%
+ {\normalfont\normalsize}}
+\newcommand*\l@subsubparagraph%
+ {\@dottedtocline{6}{10em}{5em}}% pour la table des matières
+\newcommand{\subsubparagraphmark}[1]{}% pour les en-têtes de page
+</screen>
+
+
+</sect3>
+<sect3 label="2.4.3.2" id="_005c_0040ifstar">
+<title><literal>\@ifstar</literal></title>
+
+<indexterm role="fn"><primary>\@ifstar</primary></indexterm>
+<indexterm role="cp"><primary>commandes, variantes étoilées</primary></indexterm>
+<indexterm role="cp"><primary>étoilées, variantes de commandes</primary></indexterm>
+
<!-- Inpirée des trucs & astuces de Manuel Pégourié-Gonnard -->
<!-- (https://elzevir.fr/imj/latex/tips.html#stared) -->
@@ -709,10 +890,12 @@ arguments et sa variante étoilée <literal>\agentsecret*</literal> un seul :
du nom lui-même, et pourrait donc être à n&#8217;importe quelle position, dans le nom
d&#8217;une commande l&#8217;étoile est comme une sorte d&#8217;argument optionnel. D&#8217;un point de
vue purement &tex;nique il est donc possible de mettre un nombre indéfini
-d&#8217;espace entre la commande et l&#8217;étoile. Ainsi <literal>\agentsecret*{Bond}</literal> et
+d&#8217;espaces entre la commande et l&#8217;étoile. Ainsi <literal>\agentsecret*{Bond}</literal> et
<literal>\agentsecret *{Bond}</literal> sont équivalents. Toutefois la pratique commune
est de ne jamais insérer de tels espaces.
</para>
+</sect3>
+</sect2>
</sect1>
</chapter>
<chapter label="3" id="Document-classes">
@@ -799,7 +982,7 @@ taille du papier (ci-après hauteur sur largeur) :
<indexterm role="fn"><primary>\pdfpagewidth</primary></indexterm>
<indexterm role="fn"><primary>\pdfpageheight</primary></indexterm>
<indexterm role="fn"><primary>paquetage <literal>geometry</literal></primary></indexterm>
-<indexterm role="fn"><primary><literal>geometry</literal>, paquetage Lorsque on utilise l&#8217;un des moteurs pdf&latex;,</primary></indexterm>
+<indexterm role="fn"><primary><literal>geometry</literal>, paquetage Lorsque on utilise l'un des moteurs pdf&latex;,</primary></indexterm>
<para>Lua&latex;, ou Xe&latex; (voir <link linkend="TeX-engines">&tex; engines</link>), les options autres
que <literal>letterpaper</literal> règlent la zone d&#8217;impression mais vous devez
également régler la taille du papier physique. Un méthode pour faire
@@ -859,7 +1042,7 @@ est <literal>oneside</literal> pour recto, sauf pour la classe <literal>book</li
distance sur les pages de numéro pair (impair) entre le côté gauche de
la page et la marge gauche du texte. Les valeurs par défaut varient en
fonction de la taille du papier, de la disposition recto ou
-recto-version sélectionnée. Pour une impression en recto le texte est
+recto-verso sélectionnée. Pour une impression en recto le texte est
centré, pour recto-verso, <literal>\oddsidemargin</literal> vaut 40% de la
différence entre <literal>\paperWidth</literal> et <literal>\textwidth</literal>,
<literal>\evensidemargin</literal> valant le reste.
@@ -873,6 +1056,10 @@ est <literal>openright</literal> pour la classe <literal>book</literal>.
temps au bas de chaque note.
</para>
+</sect1>
+<sect1 label="3.2" id="Additional-packages">
+<title>Ajout de paquetages</title>
+
<indexterm role="cp"><primary>paquetages, le chargement</primary></indexterm>
<indexterm role="cp"><primary>chargement des paquetages supplémentaires</primary></indexterm>
<indexterm role="fn"><primary>\usepackage</primary></indexterm>
@@ -892,6 +1079,536 @@ paquetages chargés par <literal>\usepackage</literal>.
</para>
</sect1>
+<sect1 label="3.3" id="Class-and-package-construction">
+<title>Construction des extensions (classes et paquetages)</title>
+
+<indexterm role="cp"><primary>commandes des classes de document</primary></indexterm>
+<indexterm role="cp"><primary>classe de document, commandes</primary></indexterm>
+<indexterm role="cp"><primary>nouvelles classes, commandes</primary></indexterm>
+
+<para>Vous pouvez créer de nouvelles classes de document, et de nouveaux
+paquetages. Par exemple, si vos notes doivent répondre à des exigences
+locales, telles qu&#8217;une en-tête standarde pour chaque page, alors vous
+pourriez créer une nouvelle classe <literal>cmsnote.cls</literal> et commencer vos
+documents par <literal>\documentclass{cmsnote}</literal>.
+</para>
+<para>Ce qui distingue un paquetage d&#8217;une classe de document c&#8217;est que les
+commandes d&#8217;une paquatage sont utilisables pour différentes classes
+alors que celles dans une classes de document sont spécifiques à cette
+classes. Ainsi, une commande qui permet de régler les en-têtes de pages
+irait dans un paquetage alors qu&#8217;une commande intitulant en-têtes de
+pages par <literal>Note du service de mathématique de la CMS</literal> irait dans
+une classe.
+<indexterm role="cp"><primary>classe et paquetage, différence</primary></indexterm>
+<indexterm role="cp"><primary>différence entre classe et paquetage</primary></indexterm>
+</para>
+<para>Au sein d&#8217;un fichier classe pour paquetate on peu utiliser l&#8217;arobe
+<literal>@</literal> comme un caractère dans les noms de commande sans avoir à
+entourer le code contenant la commande en question par
+<literal>\makeatletter</literal> et <literal>\makeatother</literal>. Voir <link linkend="_005cmakeatletter-and-_005cmakeatother">\makeatletter and
+\makeatother</link>. Ceci permet de créer des commandes que les utilisateurs
+ne risquent pas de redéfinir accidentellement. Une autre technique est
+de préfixer les commandes spécifiques à une classe ou paquetage avec une
+chaîne particulière, de sorte à empêcher votre classe ou paquetage
+d&#8217;interférer avec d&#8217;autres. Par exemple, la classe <literal>notecms</literal>
+pourrait avoir des commandes <literal>\cms@tolist</literal>, <literal>\cms@fromlist</literal>,
+etc.
+</para>
+
+
+
+<sect2 label="3.3.1" id="Class-and-package-structure">
+<title>Structure d&#8217;une extension (classe ou paquetage)</title>
+
+<indexterm role="cp"><primary>classe et paquetage, structure</primary></indexterm>
+<indexterm role="cp"><primary>extension, structure</primary></indexterm>
+<indexterm role="cp"><primary>classe, disposition du fichier</primary></indexterm>
+<indexterm role="cp"><primary>paquetage, disposition du fichier</primary></indexterm>
+<indexterm role="cp"><primary>options pour classe de document</primary></indexterm>
+<indexterm role="cp"><primary>options pour paquetage</primary></indexterm>
+<indexterm role="cp"><primary>classe, options</primary></indexterm>
+<indexterm role="cp"><primary>paquetage, options</primary></indexterm>
+
+<para>Un fichier de classe pour paquetage comprend typiquement quatre parties.
+</para><orderedlist numeration="arabic"><listitem><para>Dans la <firstterm>partie d&#8217;identification</firstterm> le fichier dit s&#8217;il s&#8217;agit d&#8217;un
+paquetage ou d&#8217;une classe &latex; et s&#8217;auto-décrit, en utilisant les
+commandes <literal>\NeedsTeXFormat</literal> et <literal>\ProvidesClass</literal> ou
+<literal>\ProvidesPackage</literal>.
+</para></listitem><listitem><para>La partie des <firstterm>déclarations préliminaires</firstterm> déclare des commandes et
+peut aussi charger d&#8217;autres fichiers. D&#8217;ordinaire ces commandes sont
+celles nécessaires au code utilisé dans la partie suivante. Par exemple,
+une classe <literal>notecms</literal> pourrait être appelée avec une option pour lire
+un fichier où est défini une liste de personnes désignées comme
+destinataires de la note, comme
+<literal>\documentclass[destinataires-math]{notecms}</literal>, et donc on a
+besoin de définir une commande
+<literal>\newcommand{\defdestinataires}[1]{\def\@liste@destinataires{#1}}</literal>
+à utiliser dans ce fichier.
+</para></listitem><listitem><para>Dans la partie de <firstterm>gestion des options</firstterm> la classes ou le
+paquetage déclare et traite ses options. Les options de classes
+permette à l&#8217;utilisateur de commencer leur document comme dans
+<literal>\documentclass[<replaceable>liste d'options</replaceable>]{<replaceable>nom de la classe</replaceable>}</literal>,
+pour modifier le comportement de la classe. Un exemple est lorsque on
+déclare <literal>\documentclass[11pt]{article}</literal> pour régler la taille par
+défaut de la police du document.
+</para></listitem><listitem><para>Finalement, dans la partie des <firstterm>déclarations supplémentaires</firstterm> la
+classe ou le paquetage effectue la plus grosse partie de son travail :
+déclarant de nouvelles variables, commandes ou polices, et chargeant
+d&#8217;autres fichiers.
+</para></listitem></orderedlist>
+<para>Voici le commencement d&#8217;un fichier de classe, ce qui doit être
+sauvegardé comme <filename>souche.cls</filename> à un emplacement où &latex; peut le
+trouver, par exemple dans le même répertoire que le fichier <filename>.tex</filename>.
+</para>
+<screen>\NeedsTeXFormat{LaTeX2e}
+\ProvidesClass{souche}[2017/07/06 souche à partir de laquelle contruire des classes]
+\DeclareOption*{\PassOptionsToClass{\CurrentOption}{article}}
+\ProcessOptions\relax
+\LoadClass{article}
+</screen><indexterm role="cp"><primary>classe, fichier d&#8217;exemple</primary></indexterm>
+
+<para>Elle s&#8217;auto-identifie, traite les options de classe par défaut en les
+passant toutes à la classe <literal>article</literal>, et puis charge la classe
+<literal>article</literal> de sorte à fournir la base du code de cette classe.
+</para>
+<para>Pour plus d&#8217;information, voir le guide officiel pour les auteurs de
+classes et de paquetage, le « Class Guide »,
+<ulink url="http://www.latex-project.org/help/documentation/clsguide.pdf">http://www.latex-project.org/help/documentation/clsguide.pdf</ulink> (la
+plupart des descriptions faites ici s&#8217;inspirent de ce document), ou
+l&#8217;article suivant <ulink url="https://www.tug.org/TUGboat/tb26-3/tb84heff.pdf">https://www.tug.org/TUGboat/tb26-3/tb84heff.pdf</ulink>
+illutrant la construction d&#8217;une nouvelle classe.
+</para>
+</sect2>
+<sect2 label="3.3.2" id="Class-and-package-commands">
+<title>Commande pour extension (classe ou paquetage)</title>
+<indexterm role="cp"><primary>classe et paquetage, commandes</primary></indexterm>
+<indexterm role="cp"><primary>commandes pour classe ou paquetage</primary></indexterm>
+
+<para>Voici les commandes conçues pour aider les auteurs d&#8217;extension (classes
+ou paquetages).
+</para>
+<variablelist><varlistentry><term><literal>\AtBeginDvi{specials}</literal>
+</term><listitem><indexterm role="fn"><primary>\AtBeginDvi</primary></indexterm>
+<para>Sauvegarde dans une registre de boîte des choses qui sont à écrire dans
+le fichier <filename>.dvi</filename> au début de l&#8217;achèvement de la première page du
+</para>
+<para>document.
+</para>
+</listitem></varlistentry><varlistentry><term><literal>\AtEndOfClass{<replaceable>code</replaceable>}</literal>
+</term></varlistentry><varlistentry><term><literal>\AtEndOfPackage{<replaceable>code</replaceable>}</literal>
+</term><listitem><indexterm role="fn"><primary>\AtEndOfClass</primary></indexterm>
+<indexterm role="fn"><primary>\AtEndOfPackage</primary></indexterm>
+<para>Crochet pour inséer le <replaceable>code</replaceable> à exécuter lorsque &latex; termine le
+traiement de la classe ou du paquetage courants. On peut utiliser ces
+crochet plusieurs fois ; le <literal>code</literal> sera exécuté dans l&#8217;ordre
+d&#8217;appel. Voir aussi <link linkend="_005cAtBeginDocument">\AtBeginDocument</link>.
+</para>
+</listitem></varlistentry><varlistentry><term><literal>\CheckCommand{<replaceable>cmd</replaceable>}[<replaceable>num</replaceable>][<replaceable>défaut</replaceable>]{<replaceable>définition</replaceable>}</literal>
+</term></varlistentry><varlistentry><term><literal>\CheckCommand*{<replaceable>cmd</replaceable>}[<replaceable>num</replaceable>][<replaceable>défaut</replaceable>]{<replaceable>définition</replaceable>}</literal>
+</term><listitem><indexterm role="fn"><primary>\CheckCommand</primary></indexterm>
+<indexterm role="fn"><primary>\CheckCommand*</primary></indexterm>
+<indexterm role="cp"><primary>nouvelle commande, vérification</primary></indexterm>
+<para>Similaire à <literal>\newcommand</literal> (voir <link linkend="_005cnewcommand-_0026-_005crenewcommand">\newcommand &amp; \renewcommand</link>)
+mais ne définit pas <replaceable>cmd</replaceable> ; à la place vérifie que la définition
+actuelle de <replaceable>cmd</replaceable> est exactement celle donnée par <replaceable>définition</replaceable>
+et est ou n&#8217;est pas <firstterm>longue</firstterm> selon ce que l&#8217;on attend.
+<indexterm role="cp"><primary>commande longue</primary></indexterm>
+Une commande est dite longue lorsque elle accepte <literal>\par</literal> au sein
+d&#8217;un argument. On attend que la commande <replaceable>cmd</replaceable> soit longue avec la
+version non-étoilée de <literal>\CheckCommand</literal>. Lève une erreur en cas
+d&#8217;échec de la vérification. Ceci vous permet de vérifier avant de
+redéfinir vous-même <replaceable>cmd</replaceable> qu&#8217;aucun paquetage ne l&#8217;a pas déjà fait.
+</para>
+</listitem></varlistentry><varlistentry><term><literal>\ClassError{<replaceable>nom de la classe</replaceable>}{<replaceable>texte de l'erreur</replaceable>}{<replaceable>texte d'aide</replaceable>}</literal>
+</term></varlistentry><varlistentry><term><literal>\PackageError{<replaceable>nom du paquetage</replaceable>}{<replaceable>texte de l'erreur</replaceable>}{<replaceable>texte d'aide</replaceable>}</literal>
+</term></varlistentry><varlistentry><term><literal>\ClassWarning{<replaceable>nom de la classe</replaceable>}{<replaceable>warning text</replaceable>}</literal>
+</term></varlistentry><varlistentry><term><literal>\PackageWarning{<replaceable>nom du paquetage</replaceable>}{<replaceable>warning text</replaceable>}</literal>
+</term></varlistentry><varlistentry><term><literal>\ClassWarningNoLine{<replaceable>nom de la classe</replaceable>}{<replaceable>warning text</replaceable>}</literal>
+</term></varlistentry><varlistentry><term><literal>\PackageWarningNoLine{<replaceable>nom du paquetage</replaceable>}{<replaceable>warning text</replaceable>}</literal>
+</term></varlistentry><varlistentry><term><literal>\ClassInfo{<replaceable>nom de la classe</replaceable>}{<replaceable>info text</replaceable>}</literal>
+</term></varlistentry><varlistentry><term><literal>\PackageInfo{<replaceable>nom du paquetage</replaceable>}{<replaceable>info text</replaceable>}</literal>
+</term></varlistentry><varlistentry><term><literal>\ClassInfoNoLine{<replaceable>nom de la classe</replaceable>}{<replaceable>info text</replaceable>}</literal>
+</term></varlistentry><varlistentry><term><literal>\PackageInfoNoLine{<replaceable>nom du paquetage</replaceable>}{<replaceable>info text</replaceable>}</literal>
+</term><listitem><indexterm role="fn"><primary>\ClassError</primary></indexterm>
+<indexterm role="fn"><primary>\PackageError</primary></indexterm>
+<indexterm role="fn"><primary>\ClassWarning</primary></indexterm>
+<indexterm role="fn"><primary>\PackageWarning</primary></indexterm>
+<indexterm role="fn"><primary>\ClassWarningNoLine</primary></indexterm>
+<indexterm role="fn"><primary>\PackageWarningNoLine</primary></indexterm>
+<indexterm role="fn"><primary>\ClassInfo</primary></indexterm>
+<indexterm role="fn"><primary>\PackageInfo</primary></indexterm>
+<indexterm role="fn"><primary>\ClassInfoNoLine</primary></indexterm>
+<indexterm role="fn"><primary>\PackageInfoNoLine</primary></indexterm>
+<para>Porduit un message d&#8217;erreur, ou des messages d&#8217;avertissement ou
+d&#8217;information.
+</para>
+<para>Pour <literal>\ClassError</literal> et <literal>\PackageError</literal> le message est
+<replaceable>texte de l&#8217;erreur</replaceable>, suivi de l&#8217;invite d&#8217;erreur <literal>?</literal> de
+&tex;. Si l&#8217;utilisateur demande de l&#8217;aide en tapant
+<literal>h</literal>, il voit le <replaceable>texte d&#8217;aide</replaceable>.
+</para>
+<para>The four warning commands are similar except that they write
+<replaceable>warning text</replaceable> on the screen with no error prompt. The four info
+commands write <replaceable>info text</replaceable> only in the transcript file. The
+<literal>NoLine</literal> versions do not show the number of the line generating the
+message, while the other versions do show that number.
+</para>
+<para>Pour formatter les messages, y compris le <replaceable>texte d&#8217;aide</replaceable> : utilisez
+<literal>\protect</literal> pour empêcher une commande de se sévelopper, obtenez un
+saut de ligne avec <literal>\MessageBreak</literal>, et obtenez une espace avec
+<literal>\space</literal> lorsque l&#8217;utilisation d&#8217;un caractère espace ne le permet
+pas, comme après une commande. Notez que &latex; ajoute un point final
+à chaque message.
+</para>
+</listitem></varlistentry><varlistentry><term><literal>\CurrentOption</literal>
+</term><listitem><indexterm role="fn"><primary>\CurrentOption</primary></indexterm>
+<para>Se développe au contenu de l&#8217;option en cours de traitement. Peut
+uniquement être utilisé au sein de l&#8217;argument <replaceable>code</replaceable> soit de
+<literal>\DeclareOption</literal>, soit de <literal>\DeclareOption*</literal>.
+</para>
+</listitem></varlistentry><varlistentry><term><literal>\DeclareOption{<replaceable>option</replaceable>}{<replaceable>code</replaceable>}</literal>
+</term></varlistentry><varlistentry><term><literal>\DeclareOption*{<replaceable>option</replaceable>}{<replaceable>code</replaceable>}</literal>
+</term><listitem><indexterm role="fn"><primary>\DeclareOption</primary></indexterm>
+<indexterm role="fn"><primary>\DeclareOption*</primary></indexterm>
+<indexterm role="cp"><primary>class options</primary></indexterm>
+<indexterm role="cp"><primary>package options</primary></indexterm>
+<indexterm role="cp"><primary>options, class</primary></indexterm>
+<indexterm role="cp"><primary>options, package</primary></indexterm>
+<para>Rend un option <replaceable>option</replaceable> disponible pour l&#8217;utilisateur, de sorte à ce
+qu&#8217;il puisse la passer à leur commande <literal>\documentclass</literal>. Par
+exemple, la classe <literal>notecms</literal> pourrait avoir une option <literal>logo</literal>
+pour mettre le logo de leur organisation sur la première page avec
+<literal>\documentclass[logo]{notcms}</literal>. Le fichier de classe doit
+contenir <literal>\DeclareOption{logo}{<replaceable>code</replaceable>}</literal> (et plus loin,
+<literal>\ProcessOptions</literal>).
+</para>
+<para>Si vous invoquez une option qui n&#8217;a pas été déclarée, par défaut cela
+produit une avertissement semblable à <literal>Unused global option(s):
+[badoption].</literal> Vous pouvez changer ce comportement avec la version
+étoilée <literal>\DeclareOption*{<replaceable>code</replaceable>}</literal>. Par exemple, beaucoup de
+classeq étendent une classe existante en utilisant une déclaration du
+genre <literal>\LoadClass{article}</literal>, et pour passer les options
+suppémentaires à la classe sous-jascente utilisent un code tel que
+celui-ci :
+</para>
+<screen>\DeclareOption*{%
+\PassOptionsToClass{\CurrentOption}{article}%
+}
+</screen>
+<para>Un autre exemple est que la classes <literal>notecms</literal> permette aux
+utilisateur de tenir des listes de destinataire des notes dans des
+fichier externes. Par exemple l&#8217;utilisateur invoque
+<literal>\documentclass[math]{notecms}</literal> et la classe lit le fichier
+<literal>math.memo</literal>. Ce code gère le fichier s&#8217;il existe et sinon passe
+l&#8217;option à la classe <literal>article</literal>.
+</para>
+<screen>\DeclareOption*{\InputIfFileExists{\CurrentOption.memo}{}{%
+ \PassOptionsToClass{\CurrentOption}{article}}}
+</screen>
+</listitem></varlistentry><varlistentry><term><literal>\DeclareRobustCommand{<replaceable>cmd</replaceable>}[<replaceable>num</replaceable>][<replaceable>défaut</replaceable>]{<replaceable>définition</replaceable>}</literal>
+</term></varlistentry><varlistentry><term><literal>\DeclareRobustCommand*{<replaceable>cmd</replaceable>}[<replaceable>num</replaceable>][<replaceable>défaut</replaceable>]{<replaceable>définition</replaceable>}</literal>
+</term><listitem><indexterm role="fn"><primary>\DeclareRobustCommand</primary></indexterm>
+<indexterm role="fn"><primary>\DeclareRobustCommand*</primary></indexterm>
+<indexterm role="cp"><primary>nouvelle commande, définition</primary></indexterm>
+<para>Similaire à <literal>\newcommand</literal> et <literal>\newcommand*</literal>
+(voir <link linkend="_005cnewcommand-_0026-_005crenewcommand">\newcommand &amp; \renewcommand</link>) mais déclare une commande robuste,
+même si <replaceable>définition</replaceable> comprend du code fragile. (Pour une discussion
+sur les commandes robustes et fragiles voir <link linkend="_005cprotect">\protect</link>). Utilisez ces
+commande pour définir de nouvelles commandes robustes, ou redéfinir des
+commandes existantes en les rendant robustes. Contrairement à
+<literal>\newcommand</literal> elle ne produisent pas d&#8217;ereru si la macro <replaceable>cmd</replaceable>
+existe déjà ; au lieu de cela un message est écrit dans le fichier
+journal pour indiquer la redéfinition de la commande.
+</para>
+<para>Les commandes définies de cette manière sont légèrement moins efficace
+que celle définies avec <literal>\newcommand</literal>, c&#8217;est pourquoi, à moins que
+le contenu de la commande soit fragile et que la commande soit utilisée
+au sein d&#8217;un argument mouvant, utilisez <literal>\newcommand</literal>.
+</para>
+<indexterm role="fn"><primary>paquetage <literal>etoolbox</literal></primary></indexterm>
+<indexterm role="fn"><primary><literal>etoolbox</literal>, paquetage Le paquetage <literal>etoolbox</literal> offre les commandes</primary></indexterm>
+<para><literal>\newrobustcmd</literal>, <literal>\newrobustcmd*</literal>, <literal>\renewrobustcmd</literal>,
+<literal>\renewrobustcmd*</literal>, <literal>\providerobustcmd</literal>, et
+<literal>\providrobustcmd*</literal> qui sont similaire aux commandes standardes
+<literal>\newcommand</literal>, <literal>\newcommand*</literal>, <literal>\renewcommand</literal>,
+<literal>\renewcommand*</literal>, <literal>\providecommand</literal>, et
+<literal>\providcommand*</literal>, mais définissent une commande <replaceable>cmd</replaceable> robuste
+avec deux advanges par rapport à <literal>\DeclareRobustCommand</literal> :
+</para><orderedlist numeration="arabic"><listitem><para>Elle utilisent un mécanisme de protection de bas niveau d&#8217;e-&tex; au
+lieu du mécanisme de plus au niveau de &latex; utilisant
+<literal>\protect</literal>, ainsi elles ne subissent pas la légère perte de
+performance mentionnée plus haut, et
+</para></listitem><listitem><para>Elles font la même distinction entre <literal>\new&#8230;</literal>,
+<literal>\renew&#8230;</literal>, et <literal>\provide&#8230;</literal> que les commandes
+standardes, ainsi elle ne font pas qu&#8217;envoyer un message dans le journal
+lorsque vous redéfinissez <replaceable>cmd</replaceable> déjà existantes, dans ce cas vous
+devez utiliser soit <literal>\renew&#8230;</literal> soit <literal>\provide&#8230;</literal> ou il
+y a une erreur.
+</para></listitem></orderedlist>
+</listitem></varlistentry><varlistentry><term><literal>\IfFileExists{<replaceable>nom fichier</replaceable>}{<replaceable>si vrai</replaceable>}{<replaceable>si faux</replaceable>}</literal>
+</term></varlistentry><varlistentry><term><literal>\InputIfFileExists{<replaceable>nom fichier</replaceable>}{<replaceable>si vrai</replaceable>}{<replaceable>si faux</replaceable>}</literal>
+</term><listitem><indexterm role="fn"><primary>\IfFileExists</primary></indexterm>
+<indexterm role="fn"><primary>\InputIfFileExists</primary></indexterm>
+<para>Exécute <replaceable>si vrai</replaceable> sf &latex; peut trouver le fichier <filename><replaceable>nom
+fichier</replaceable></filename> et <replaceable>si faux</replaceable> sinon. Dans le second cas, le fichier est lu
+immédiatement aprus exécuter <replaceable>si vrai</replaceable>. Ainsi
+<literal>\IfFileExists{img.pdf}{\includegraphics{img.pdf}}{\typeout{AVERSTISSEMENT
+: img.pdf introuvable}}</literal> n&#8217;inclut le graphique <filename>img.pdf</filename> que s&#8217;il
+est trouvé, mais autrement produit seulement un avertissement.
+</para>
+<para>Cette commande cherche le fichier dans tous les chemin de recherche que
+that &latex; utilise, et non pas seulement dans le répertoire courant.
+Pour chercher uniquement dans le répertoire courant faites quelque-chose
+du genre de <literal>\IfFileExists{./<replaceable>nom fichier</replaceable>}{<replaceable>si
+vrai</replaceable>}{<replaceable>si faux</replaceable>}</literal>. Si vous demandez un fichier dont le nom n&#8217;a
+pas d&#8217;extension <literal>.tex</literal> alors &latex; commencera par chercher le
+fichier en apposant <literal>.tex</literal> à son nom ; pour plus ample information
+sur la façon dont &latex; gère les extensions de nom de fichier voir
+<link linkend="_005cinput">\input</link>.
+</para>
+</listitem></varlistentry><varlistentry><term><literal>\LoadClass[<replaceable>liste d'options</replaceable>]{<replaceable>nom de la classe</replaceable>}[<replaceable>date de parution</replaceable>]</literal>
+</term></varlistentry><varlistentry><term><literal>\LoadClassWithOptions{<replaceable>nom de la classe</replaceable>}[<replaceable>date de parution</replaceable>]</literal>
+</term><listitem><indexterm role="fn"><primary>\LoadClass</primary></indexterm>
+<indexterm role="fn"><primary>\LoadClassWithOptions</primary></indexterm>
+<para>Charge une classe, comme avec <literal>\documentclass[<replaceable>options
+list</replaceable>]{<replaceable>nom de la classe</replaceable>}[<replaceable>release info</replaceable>]</literal>. Voici un exemple :
+<literal>\LoadClass[twoside]{article}</literal>.
+</para>
+<para>La <replaceable>liste d&#8217;options</replaceable>, si présente, est une liste ponctuée par des
+virgules. La <replaceable>date de parution</replaceable> est optionnel. Si elle est
+présente, elle doit avoir le format <replaceable>AAA/MM/JJ</replaceable>. Si vous demandez
+une <replaceable>date de parution</replaceable> et que la date du paquetage installée sur
+votre sysème est antérieure, alors vous obtiendrez un avertissement à
+l&#8217;écrant et dans le journal de compilation du genre de <literal>You have
+requested, on input line 4, version `2038/01/19' of document class
+article, but only version `2014/09/29 v1.4h Standard LaTeX document
+class' is available.</literal>
+</para>
+<para>La variante de la commande <literal>\LoadClassWithOptions</literal> utilise la liste
+des options de la classe courante. Cela veut dire qu&#8217;elle ignore toute
+options passée via <literal>\PassOptionsToClass</literal>. Ceci est une commande de
+commodité qui vous permet de construire une nouvelle classe en
+l&#8217;héritant d&#8217;une classe existante, telle que la classe standarde
+<literal>article</literal>, sans avoir à gérer les options qui furent passée.
+</para>
+</listitem></varlistentry><varlistentry><term><literal>\ExecuteOptions{<replaceable>liste d'options</replaceable>}</literal>
+</term><listitem><indexterm role="fn"><primary>\ExecuteOptions</primary></indexterm>
+<para>Pour chaque option <replaceable>option</replaceable> de la <replaceable>liste d&#8217;options</replaceable>, dans
+l&#8217;ordre d&#8217;apparition, cette commande exécute la commande
+<literal>\ds@<replaceable>option</replaceable></literal>. Si cette commande n&#8217;est pas définie, alors
+l&#8217;option <replaceable>option</replaceable> est ignorée.
+</para>
+<para>Ceci peut être utilisé pour fournir d&#8217;un liste d&#8217;option par défaut avant
+le <literal>\ProcessOptions</literal>. Par exemple, si dans un fichier de classe
+vous désirez utiliser par défaut la taille de police 11pt alors vous
+devriez spécifier <literal>\ExecuteOptions{11pt}\ProcessOptions\relax</literal>.
+</para>
+</listitem></varlistentry><varlistentry><term><literal>\NeedsTeXFormat{<replaceable>format</replaceable>}[<replaceable>date du format</replaceable>]</literal>
+</term><listitem><indexterm role="fn"><primary>\NeedsTeXFormat</primary></indexterm>
+<para>Spécifie le format sous lequelle cette classe doit être utilisée. Cette
+directive est souvent donnée à la première ligne du fichier de classe,
+et le plus souvent elle est utilisée de cette façon :
+<literal>\NeedsTeXFormat{LaTeX2e}</literal>. Lorsque un document utilisant cette
+classe est traité, le nom du format donné ici doit s&#8217;accorder avec le
+format qui est en cours d&#8217;exécution (y compris le fait que la chaîne
+<replaceable>format</replaceable> est sensible à la casse). Si il ne s&#8217;y accorde pas alors
+l&#8217;exécution est interrompue par une erruer du genre de &#8216;<literal>This file
+needs format `LaTeX2e' but this is `xxx'.</literal>&#8217;
+</para>
+<para>Pour spécifier une version du format dont vous savez qu&#8217;elle prend en
+charge certaines fonctions, incluez l&#8217;argument optionnel <replaceable>date du
+format</replaceable> correspondant au format où ces fonction furent implémentés. Si
+cette argument est présent il doit être de la forme <literal>AAAA/MM/JJ</literal>.
+Si la version de format installée sur votre système est antérieur à la
+<replaceable>date du format</replaceable> alors vous obtiendrez un avertissement du genre de
+&#8216;<literal>You have requested release `2038/01/20' of LaTeX, but only release
+`2016/02/01' is available.</literal>&#8217;
+</para>
+</listitem></varlistentry><varlistentry><term><literal>\OptionNotUsed</literal>
+</term><listitem><indexterm role="fn"><primary>\OptionNotUsed</primary></indexterm>
+<para>Ajoute l&#8217;option courante à la liste des options non utilisées. Ne peut
+être utilisé qu&#8217;au sein de l&#8217;argument <replaceable>code</replaceable> de
+<literal>\DeclareOption</literal> ou <literal>\DeclareOption*</literal>.
+</para>
+<!-- I cannot reproduce this behavior as it is documented in clsguide. -->
+<!-- In the absence of a @code{\DeclareOption*} declaration, @LaTeX{} issues -->
+<!-- on the console a warning like @code{LaTeX Warning: Unused global -->
+<!-- option(s): [unusedoption].} with the list of not-used options when it -->
+<!-- reaches @code{\begin@{document@}}. -->
+
+</listitem></varlistentry><varlistentry><term><literal>\PassOptionsToClass{<replaceable>liste d'options</replaceable>}{<replaceable>nom de la classe</replaceable>}</literal>
+</term></varlistentry><varlistentry><term><literal>\PassOptionsToPackage{<replaceable>liste d'options</replaceable>}{<replaceable>nom du paquetage</replaceable>}</literal>
+</term><listitem><indexterm role="fn"><primary>\PassOptionsToClass</primary></indexterm>
+<indexterm role="fn"><primary>\PassOptionsToPackage</primary></indexterm>
+<para>Ajoute les options de la liste ponctuée par des virgules <replaceable>option
+list</replaceable> aux options utilisée par toute commande ultérieure
+<literal>\RequirePackage</literal> ou <literal>\usepackage</literal> pour le paquetage
+<replaceable>nom du paquetage</replaceable> ou la classe <replaceable>nom de la classe</replaceable>.
+</para>
+<para>La raison d&#8217;être de ces commande est que vous pouvez charger un
+paquetage autant de fois que vous le voulez sans options, mais que si
+voulez passer des options alors vous ne pouvez les fournir qu&#8217;au premier
+chargement. Charger un paquetage avec des options plus d&#8217;une fois
+produit une erreur du genre de <literal>Option clash for package toto.</literal>
+(&latex; lance l&#8217;erreur même s&#8217;il n&#8217;y a pas de conflit entre les
+options.)
+</para>
+<para>Si votre propre code introduit un paquetage deux fois alors vous pouvez
+réduire cela en une fois, par exemple en remplaçant les deux
+<literal>\RequirePackage[landscape]{geometry}\RequirePackage[margins=1in]{geometry}</literal>
+par un seul <literal>\RequirePackage[landscape,margins=1in]{geometry}</literal>.
+Mais si vous chargez un paquetage qui à son tour en charge un autre
+alors vous devez mettre en queue les options que vous désirez pour cet
+autre paquetage. Par exemple, supposons que le paquetage <literal>toto</literal>
+charge le paquetage <literal>geometry</literal>. Au lieu de
+<literal>\RequirePackage{toto}\RequirePackage[draft]{graphics}</literal> vous
+devez écrire <literal>\PassOptionsToPackage{draft}{graphics}
+\RequirePackage{toto}</literal>. (Si <literal>toto.sty</literal> charge une option en
+conflit avec ce que vous désirez alors vous devrez considérer une
+modification de son code source.)
+</para>
+<para>Ces commandes sont également utiles aux utilisateurs de base et pas
+seulement aux auteurs de classes et paquetage. Par exemple, supposons
+qu&#8217;un utilisateur veuille cherge le paquetage <literal>graphicx</literal> avec
+l&#8217;option <literal>draft</literal> et veuille également utiliser une classe
+<literal>toto</literal> qui charge le paquetage <literal>graphicx</literal>, mais sans cette
+option. L&#8217;utilisateur peut commencer son fichier &latex; avec
+<literal>\PassOptionsToPackage{draft}{graphicx}\documentclass{toto}</literal>.
+</para>
+</listitem></varlistentry><varlistentry><term><literal>\ProcessOptions</literal>
+</term></varlistentry><varlistentry><term><literal>\ProcessOptions*<replaceable>\@options</replaceable></literal>
+</term><listitem><indexterm role="fn"><primary>\ProcessOptions</primary></indexterm>
+<indexterm role="fn"><primary>\ProcessOptions*</primary></indexterm>
+<para>Exécute le code associé à chaque option que l&#8217;utilisateur a invoquée. À
+include dans le fichier classe sous la forme
+<literal>\ProcessOptions\relax</literal> (à cause de l&#8217;existance de la variant
+étoilée de la commande).
+</para>
+<para>Les options tombent dans deux catégories. Les <firstterm>options locales</firstterm>
+sont spécifiées pour un paquetage particulier au sein de l&#8217;argument
+<replaceable>options</replaceable> dans <literal>\PassOptionsToPackage{<replaceable>options</replaceable>}</literal>,
+<literal>\usepackage[<replaceable>options</replaceable>]</literal>, ou
+<literal>\RequirePackage[<replaceable>options</replaceable>]</literal>. Les <firstterm>options globales</firstterm> sont
+celles données par l&#8217;utilisateur de la classe dans
+<literal>\documentclass[<replaceable>options</replaceable>]</literal>. (Si une option est spécifiée à la
+fois localement et globalement, alors elle est locale).
+</para>
+<para>Lorsque <literal>\ProcessOptions</literal> est appelé pour un paquetage
+<filename>pkg.sty</filename>, il se produit ce qui suit :
+</para><orderedlist numeration="arabic"><listitem><para>Pour chaque option <replaceable>option</replaceable> déclarée jusqu&#8217;à ce point avec
+<literal>\DeclareOption</literal>, &latex; examine si cette option est soit globale
+soit locale pour <literal>pkg</literal>. Si c&#8217;est le cas, il exécute le code
+déclaré. Ceci est fait dans l&#8217;ordre de passage de ces options à
+<filename>pkg.sty</filename>.
+</para></listitem><listitem><para>Pour chaque option locale restante, il exécute la commande
+<literal>\ds@<replaceable>option</replaceable></literal> si elle a été défini quelque-part (autrement
+que par un <literal>\DeclareOption</literal>) ; sinon, il exécute le code de
+traitement par défaut des options donné dans <literal>\DeclareOption*</literal>. Si
+aucun code de traitement par défaut n&#8217;a été déclaré, il produit un
+message d&#8217;erreur. Ceci est fait dans l&#8217;ordre dans lequel ces options ont
+été spécifiées.
+</para></listitem></orderedlist>
+<para>Lorsque <literal>\ProcessOptions</literal> est appelé pour une classe il fonctionne
+de la même manière à ceci près que toutes les options sont locales, et
+que le code par défaut pour <literal>\DeclareOption*</literal> et
+<literal>\OptionNotUsed</literal> plutôt qu&#8217;une erreur.
+</para>
+<para>La version étoilée <literal>\ProcessOptions*</literal> exécute le traitement des
+options dans l&#8217;ordre spécifié par les commandes appelante, plutôt que
+dans l&#8217;ordre de déclaration de la classe ou du paquetage. Pour un
+paquetage, ceci signifie que les options globales sont traitées en
+premier.
+</para>
+
+</listitem></varlistentry><varlistentry><term><literal>\ProvidesClass{<replaceable>nom de la classe</replaceable>}[<replaceable>date de parution</replaceable> <replaceable>brève information supplémentaire</replaceable>]</literal>
+</term></varlistentry><varlistentry><term><literal>\ProvidesClass{<replaceable>nom de la classe</replaceable>}[<replaceable>date de parution</replaceable>]</literal>
+</term></varlistentry><varlistentry><term><literal>\ProvidesPackage{<replaceable>nom du paquetage</replaceable>}[<replaceable>date de parution</replaceable> <replaceable>brève information supplémentaire</replaceable>]</literal>
+</term></varlistentry><varlistentry><term><literal>\ProvidesPackage{<replaceable>nom du paquetage</replaceable>}[<replaceable>date de parution</replaceable>]</literal>
+</term><listitem><indexterm role="fn"><primary>\ProvidesClass</primary></indexterm>
+<indexterm role="fn"><primary>\ProvidesPackage</primary></indexterm>
+<para>Indentifie la classe ou le paquetage, en tapant un message sur la
+console et dans le fichier journal.
+</para>
+<para>Lorsqu&#8217;un utilisateur écrit <literal>\documentclass{notecms}</literal> alors
+&latex; charge le fichier <filename>notecms.cls</filename>. De même, un utilisateur
+écrivant <literal>\usepackage{essai}</literal> invite &latex; à charger le
+fichier <filename>essai.sty</filename>. Si le nom du fichier ne s&#8217;accorde pas à
+l&#8217;argument <replaceable>nom de la classe</replaceable> ou <replaceable>nom du paquetage</replaceable> alors un
+avertissement est produit. Ainsi, si vous invoquez
+<literal>\documentclass{notecms}</literal>, et que le fichier the file
+<filename>notecms.cls</filename> comprend la déclaration statement
+<literal>\ProvidesClass{xxx}</literal> alors vous obtiendrez un avertissement du
+genre de like <literal>You have requested document class `notecms', but the
+document class provides 'xxx'.</literal> Cet avertissement n&#8217;empèche pas
+&latex; de traiter le reste du fichier de la classe normalement.
+</para>
+<para>Si vous incluez l&#8217;argument optionnel, alors vous devez inclure la date,
+avant le premier espace s&#8217;il y en a, et elle doit avoir le format
+<literal>AAAA/MM/JJ</literal>. Le reste de l&#8217;argument est en format libre,
+toutefois il identifie traditionnellement la classe, et est écrit
+pendant la compilation à l&#8217;écran et dans le journal. Ainsi, si votre
+fichier <filename>notecms.cls</filename> contient la ligne
+<literal>\ProvidesClass{smcmem}[2008/06/01 v1.0 Classe note CMS]</literal> la
+première ligne de votre docment est <literal>\documentclass{notecms}</literal>
+alors vous pourrez voir <literal>Document Class: notecms 2008/06/01 v1.0
+Classe note CMS</literal>.
+</para>
+<para>La date dans l&#8217;argument optionnel permet aux utilisateurs de classe et
+de paquetage de demander à être avertis si la version de la classe ou du
+paquetage installé sur leur système est antérieur à <replaceable>date de
+parution</replaceable>, en utilisant les arguments optionnels comme dans
+<literal>\documentclass{smcmem}[2018/10/12]</literal> ou
+<literal>\usepackage{toto}[[2017/07/07]]</literal>. (Notez que les utilisateurs
+de paquetages incluent seulement rarement une date, et les utilisateurs
+de classe presque jamais).
+</para>
+</listitem></varlistentry><varlistentry><term><literal>\ProvidesFile{<replaceable>nom fichier</replaceable>}[<replaceable>information supplémentaire</replaceable>]</literal>
+</term><listitem><indexterm role="fn"><primary>\ProvidesFile</primary></indexterm>
+<para>Déclare un fihcier autre que les fichiers principaux de classe ou de
+paquetage, tel qu&#8217;un fichier de configuration ou un fichier de
+définition de police. Mettez la commande dans ce fichier et vous
+obtiendrez dans le journal une information du genre de <literal>File:
+essai.config 2017/10/12 fichier de configuration pour essai.cls</literal> lorsque
+<replaceable>nom fichier</replaceable> vaut &#8216;<literal>essai.config</literal>&#8217; et que <replaceable>information
+supplémentaire</replaceable> vaut &#8216;<literal>2017/10/12 fichier de configuration pour
+essai.cls</literal>&#8217;.
+</para>
+</listitem></varlistentry><varlistentry><term><literal>\RequirePackage[<replaceable>liste d'options</replaceable>]{<replaceable>nom du paquetage</replaceable>}[<replaceable>date de parution</replaceable>]</literal>
+</term></varlistentry><varlistentry><term><literal>\RequirePackageWithOptions{<replaceable>nom du paquetage</replaceable>}[<replaceable>date de parution</replaceable>]</literal>
+</term><listitem><indexterm role="fn"><primary>\RequirePackage</primary></indexterm>
+<indexterm role="fn"><primary>\RequirePackageWithOptions</primary></indexterm>
+<para>Charge un paquetage, comme la commande <literal>\usepackage</literal> pour les
+auteurs de documents. Voir <link linkend="Additional-packages">Additional packages</link>. Voici un exemple :
+<literal>\RequirePackage[landscape,margin=1in]{geometry}</literal>. Notez que
+l&#8217;équipe de développement de &latex; recommande fortement l&#8217;utilisation
+de ces commande de préférence à l&#8217;<literal>\input</literal> de Plain&#160;&tex; ;
+voir le « Class Guide ».
+</para>
+<para>La <replaceable>liste d&#8217;options</replaceable>, si présente, est une liste ponctuée de
+virgules. La <replaceable>date de parution</replaceable>, si présente, doit avoir le format
+<replaceable>AAAA/MM/JJ</replaceable>. Si la date de parution du paquetzge tel qu&#8217;il est
+installé sur votre systèlme est antérieur à <replaceable>date de parution</replaceable> alors
+vous obtiendrez un avertissement du genre de <literal>You have requested,
+on input line 9, version `2017/07/03' of package jhtest, but only
+version `2000/01/01' is available</literal>.
+</para>
+<para>La variante <literal>\RequirePackageWithOptions</literal> utilise la liste d&#8217;options
+de la classe courtante. Ceci implique qu&#8217;elle ignore toute option passée
+à la classe via <literal>\PassOptionsToClass</literal>. C&#8217;est une commande de
+commodité pour permettre facilement de construire des classes sur des
+classes existantes sans avoir à gérer les options qui sont passées.
+</para>
+<para>La différence entre <literal>\usepackage</literal> et <literal>\RequirePackage</literal> est
+mince. La commande <literal>\usepackage</literal> est à l&#8217;intention du fichier
+document alors que <literal>\RequirePackage</literal> l&#8217;est à celle des fichiers
+paquetage ou classe. Ansi, utiliser <literal>\usepackage</literal> avant la
+commande <literal>\documentclass</literal> amène &latex; à produire une erreur du
+genre de <literal>\usepackage before \documentclass</literal>, là où vous pouvez
+utiliser <literal>\RequirePackage</literal>.
+</para></listitem></varlistentry></variablelist>
+
+</sect2>
+</sect1>
</chapter>
<chapter label="4" id="Fonts">
<title>Polices de caractères</title>
@@ -1445,7 +2162,7 @@ même que la taille de la police, par exemple, &#8216;<literal>10pt</literal>&#8
</listitem></varlistentry></variablelist>
</sect1>
<sect1 label="5.6" id="Floats">
-<title>Floats</title>
+<title>Flottants</title>
<para>Certains éléments typographiques, tels que les figures et les tableaux,
ne peuvent pas être à cheval sur plusieurs pages. Ils doivent être
@@ -1541,6 +2258,8 @@ paquetage <filename>afterpage</filename> et commettre le code
la page courante et ensuite de faire passer tous les flottants encore
non placés.
</para>
+<indexterm role="fn"><primary>paquetage <literal>flafter</literal></primary></indexterm>
+<indexterm role="fn"><primary><literal>flafter</literal>, paquetage</primary></indexterm>
<para>&latex; peut composer un flottant avant l&#8217;endroit où il apparaît dans
le code source (quoique sur la même page de sortie) s&#8217;il y a un
spécificateur <literal>t</literal> au sein du paramètre <replaceable>placement</replaceable>. Si ceci
@@ -1617,10 +2336,10 @@ texte ; par défaut 3.
<ulink url="http://www.tex.ac.uk/cgi-bin/texfaq2html?label=floats">http://www.tex.ac.uk/cgi-bin/texfaq2html?label=floats</ulink> contient des
suggestions pour relâcher les paramètres par défaut de &latex; de sorte
à réduire les problèmes de flottants rejetés à la fin. Une explication
-complète de l&#8217;algorithme de placement des flootant se trouve dans
+complète de l&#8217;algorithme de placement des flottant se trouve dans
l&#8217;article de Frank Mittelbach « How to
infuence the position of float environments like figure and table in
-&latex;? » <ulink url="http://latex-project.org/papers/tb111mitt-float.pdf">http://latex-project.org/papers/tb111mitt-float.pdf</ulink>.
+&latex;? » (<ulink url="http://latex-project.org/papers/tb111mitt-float.pdf">http://latex-project.org/papers/tb111mitt-float.pdf</ulink>).
</para>
</sect1>
</chapter>
@@ -1679,7 +2398,7 @@ cela :
</screen>
<indexterm role="fn"><primary>secnumdepth counter</primary></indexterm>
<indexterm role="cp"><primary>numéros de rubrique, composition</primary></indexterm>
-<para>Le compteur <literal>secnumdepth</literal> contrôle la composition des numéros de
+<anchor id="Sectioning_002fsecnumdepth"/><para>Le compteur <literal>secnumdepth</literal> contrôle la composition des numéros de
rubrique. le paramètre
</para>
<screen>\setcounter{secnumdepth}{<replaceable>niveau</replaceable>}
@@ -1689,13 +2408,47 @@ rubrique. le paramètre
</para>
</chapter>
<chapter label="7" id="Cross-references">
-<title>des références croisées</title>
+<title>Des références croisées</title>
<indexterm role="cp"><primary>références croisées</primary></indexterm>
<para>Une des raisons pour numéroter des choses telles que les figures ou les
-équations est d&#8217;indiquer au lecteur un référence vers elles, comme dans « Voir la
+équations est d&#8217;indiquer au lecteur une référence vers elles, comme dans « Voir la
figure 3 pour plus de détails. »
</para>
+<indexterm role="cp"><primary>étiquette</primary></indexterm>
+<para>Inclure le numéro de figure dans le code source est une mauvaise
+pratique puisque ce si ce noméro change avec l&#8217;évolution du document,
+alors on doit penser à mettre à jour cet référence manuellement. Au lieu
+de cela, &latex; vous fait écrire une <firstterm>étiquette</firstterm> du genre
+<literal>\label{eq:ThmGreens}</literal> et lui faire référence avec <literal>Voir
+l'équation~\ref{eq:ThmGreens}</literal>.
+</para>
+<para>&latex; écrit l&#8217;information provenant des étiquettes dans un fichier
+avec le même nom que le fichier conteant le <literal>\label{...}</literal> mais
+avec une extension <filename>.aux</filename>. (L&#8217;information a le format
+<literal>\newlabel{<replaceable>étiquette</replaceable>}{{<replaceable>étiquette-courante</replaceable>}{<replaceable>numéro-de-page</replaceable>}}</literal>
+où <replaceable>étiquette-courante</replaceable> est la valeur de la macro
+<literal>\@currentlabel</literal> qui est d&#8217;ordinaire mise à jour à chaque vous que
+that is vous appelez <literal>\refstepcounter{<replaceable>compteur</replaceable>}</literal>.)
+</para>
+<indexterm role="cp"><primary>référence déclarée en aval</primary></indexterm>
+<indexterm role="cp"><primary>aval, référence déclarée en</primary></indexterm>
+<indexterm role="cp"><primary>déclaration en aval de référence</primary></indexterm>
+<para>L&#8217;effet secondaire le plus courant du paragraphe précédent se produit
+lorsque votre document a une <firstterm>référence déclarée en aval</firstterm>, c.-à-d.
+un <literal>\ref{<replaceable>clef</replaceable>}</literal> qui apparaît avant le
+<literal>\label{<replaceable>clef</replaceable>}</literal> associé ; voir l&#8217;exemple dans la description
+de <literal>\pageref{...}</literal>. &latex; obtient les référence à partir du
+fichier <filename>.aux</filename>. Si c&#8217;est la première fois que vous compilez le
+document alors vous obtiendrez un message <literal>LaTeX Warning: Label(s)
+may have changed. Rerun to get cross references right.</literal> et dans la
+sortie la référence apparaîtra comme deux points
+d&#8217;interrogration &#8216;<literal>??</literal>&#8217; en caractères gras. Ou, si vous modifiez le
+document de telle façon que les références changent alors vous
+obtiendrez le même avertissement et la sortie contiendra l&#8217;information
+de référence de la fois précédente. La solution dans les deux cas est
+juste de re-compiler le document encore une fois.
+</para>
<sect1 label="7.1" id="_005clabel">
@@ -1706,14 +2459,17 @@ figure 3 pour plus de détails. »
</para>
<screen>\label{<replaceable>clef</replaceable>}
</screen>
-<para>Une commande <literal>\label</literal> apparaissant dans le texte ordinaire crée une
-étiquette en attribuant à <literal>clef</literal> le numéro de l&#8217;unité sectionnel
-courante ; lorsque <literal>\label</literal> apparaît dans un environnement
-numéroté, elle attribue ce numéro à <literal>clef</literal>.
+<para>Attribut un numéro de référence à <replaceable>clef</replaceable>. Au sein de texte
+ordinaire, <literal>\label{<replaceable>clef</replaceable>}</literal> attribut à <replaceable>clef</replaceable> le numéro
+de la rubrique courante. Au sein d&#8217;un environnement numéroté, tel que
+l&#8217;environnement <literal>table</literal> ou <literal>theorem</literal>,
+<literal>\label{<replaceable>clef</replaceable>}</literal> attribue le numéro de cet environnement à
+<replaceable>clef</replaceable>. On retire le numéro attribué avec la commande
+<literal>\ref{<replaceable>clef</replaceable>}</literal> (voir <link linkend="_005cref">\ref</link>).
</para>
-<para>Le nom <literal>clef</literal> peut se composer de n&#8217;importe quelle séquence de
-lettres, chiffres, ou caractères de ponctuation. Il est sensible à la
-casse &#8212; lettres capitales ou bas-de-casse.
+<para>Le nom <replaceable>clef</replaceable> peut se composer de n&#8217;importe quelle séquence de
+lettres, chiffres, ou caractères de ponctuation ordinaires. Il est
+sensible à la casse &#8212; lettres capitales ou bas-de-casse.
</para>
<para>Pour éviter de créer accidentellement deux étiquettes avec le même nom,
l&#8217;usage est d&#8217;utiliser des étiquettes composées d&#8217;un préfixe et d&#8217;un
@@ -1731,25 +2487,51 @@ classiquement utilisés :
</para></listitem></varlistentry><varlistentry><term><literal>eq</literal>
</term><listitem><para>pour les équations
</para></listitem></varlistentry></variablelist>
-<para>Ansi, une étiquette pour une figure devrait ressembler à <literal>fig:narquois</literal>
-ou à <literal>fig.narquois</literal>.
-</para>
-
+<para>Ansi, <literal>\label{fig:Euler}</literal> est une étiquette pour une figure avec
+un portrait de ce grand homme.
+</para>
+<para>Dans l&#8217;exemple ci-dessous la clef <literal>sec:test</literal> se verra attribué le
+numéro de la section courante et la clef <literal>fig:test</literal> se verra
+attribué le numéro de la figure. Soit dit en passant, mettez les
+étiquettes (<literal>\label</literal>) après les légendes (<literal>\caption</literal>) au sein
+des environnements <literal>figure</literal> ou <literal>table</literal>.
+</para>
+<screen>\section{Titre de la rubrique}
+\label{sec:test}
+Dans cette rubrique~\ref{sec:test}.
+\begin{figure}
+ ...
+ \caption{Texte de la légende}
+ \label{fig:test}
+\end{figure}
+Voir Figure~\ref{fig:test}.
+</screen>
</sect1>
<sect1 label="7.2" id="_005cpageref">
-<title><literal>\pageref{<replaceable>key</replaceable>}</literal></title>
+<title><literal>\pageref{<replaceable>clef</replaceable>}</literal></title>
<indexterm role="fn"><primary>\pageref</primary></indexterm>
<indexterm role="cp"><primary>référence croisée avec numéro de page</primary></indexterm>
<indexterm role="cp"><primary>numéro de page, référence croisée</primary></indexterm>
<para>Synopsis :
</para>
-<screen>\pageref{<replaceable>key</replaceable>}
+<screen>\pageref{<replaceable>clef</replaceable>}
</screen>
-<para>La commande <literal>\pageref</literal>{<replaceable>clef</replaceable>} produit le numéro de page de
-l&#8217;endroit du texte où la commande correspndante
-<literal>\label</literal>{<replaceable>clef</replaceable>} apparaît.
+<para>Produit le numéro de page de l&#8217;endroit du texte où la commande
+correspondante <literal>\label</literal>{<replaceable>clef</replaceable>} apparaît.
+</para>
+<para>Dans cet exemple le <literal>\label{eq:principale}</literal> est utilisé à la fois
+pour le numéro de la formule et pour le numéro de page. (Notez que les
+deux références sont des référénces déclarées en aval, ainsi ce document
+that the a besoin d&#8217;être compilé deux fois pour les résoudre.)
</para>
+<screen>Le résultat principal est la formule~\ref{eq:principale} de la
+page~\pageref{eq:principale}.
+ ...
+\begin{equation} \label{eq:principale}
+ \mathbf{P}=\mathbf{NP}
+\end{equation}
+</screen>
</sect1>
<sect1 label="7.3" id="_005cref">
<title><literal>\ref{<replaceable>clef</replaceable>}</literal></title>
@@ -1764,12 +2546,23 @@ l&#8217;endroit du texte où la commande correspndante
</para>
<screen>\ref{<replaceable>clef</replaceable>}
</screen>
-<para>La commande <literal>\ref</literal> produit le numéro de l&#8217;unité sectionnelle,
-équation, note en bas de page, figure, &#8230;, de la commande
-correspondante <literal>\label</literal> (voir <link linkend="_005clabel">\label</link>). Elle ne produit aucun
-texte, tel que le mot &#8216;<literal>Section</literal>&#8217; ou &#8216;<literal>Figure</literal>&#8217;, juste le numéro
-lui-même sans plus.
+<para>Produit le numéro de la rubrique, équation, note en bas de page, figure,
+&#8230;, de la commande correspondante <literal>\label</literal> (voir <link linkend="_005clabel">\label</link>).
+Elle ne produit aucun texte, tel que le mot &#8216;<literal>Section</literal>&#8217; ou
+&#8216;<literal>Figure</literal>&#8217;, juste le numéro lui-même sans plus.
+</para>
+<para>Dans cet exemple, le <literal>\ref{populaire}</literal> produit &#8216;<literal>2</literal>&#8217;. Notez
+que ceci est une référence déclarée en aval puisque elle est faite avant
+<literal>\label{populaire}</literal>.
</para>
+<screen>Le format utilisé le plus largement est à l'item item numéro~\ref{populaire}.
+\begin{enumerate}
+\item Plain \TeX
+\item \label{populaire} \LaTeX
+\item Con\TeX t
+\end{enumerate}
+</screen>
+
</sect1>
</chapter>
<chapter label="8" id="Environments">
@@ -1801,7 +2594,7 @@ Chaque environnement commence et se termine de la même manière :
\end{abstract}
</screen>
<para>Produit un résumé, potentiellement contenant plusieurs paragraphes. Cet
-environneement n&#8217;est défini que dans les classes de document
+environnement n&#8217;est défini que dans les classes de document
<literal>article</literal> et <literal>report</literal> (voir <link linkend="Document-classes">Document classes</link>).
</para>
<para>Utiliser l&#8217;exemple ci-dessous au sein de la classe <literal>article</literal>
@@ -1831,7 +2624,8 @@ en deux-colonne (pour plus solution plus flexible, utilisez le paquetage
\begin{@twocolumnfalse}
\maketitle
\begin{abstract}
- Ruth n'était pas seulement le Sultan du Swat, il était à lui tout seul l'équipe du swat.
+ Ruth n'était pas seulement le Sultan du Swat, il était à lui tout
+ seul l'équipe du swat.
\end{abstract}
\end{@twocolumnfalse}
]
@@ -1888,6 +2682,8 @@ inter-colonne que &latex; met dans un <literal>array</literal> est contrôlé pa
<literal>\arraycolsep</literal>, qui spécifie la moitié de la largueur entre les
colonnes. La valeur par défaut est &#8216;<literal>5pt</literal>&#8217;.
</para>
+<indexterm role="fn"><primary>paquetage <literal>amsmath</literal></primary></indexterm>
+<indexterm role="fn"><primary><literal>amsmath</literal>, paquetage</primary></indexterm>
<para>Pour otenir des tableaux entre accolades la méthode standarde est
d&#8217;utiliser le paquetage <literal>amsmath</literal>. Il comprend les environnements
<literal>pmatrix</literal> pour un tableau entre parenthèses <literal>(...)</literal>,
@@ -2059,6 +2855,7 @@ tapuscrit de base}]</literal>.
</sect1>
<sect1 label="8.5" id="displaymath">
<title><literal>displaymath</literal></title>
+<!-- http://tex.stackexchange.com/questions/40492/what-are-the-differences-between-align-equation-and-displaymath -->
<indexterm role="fn"><primary>environnement <literal>displaymath</literal></primary></indexterm>
<indexterm role="fn"><primary><literal>displaymath</literal>, environnement</primary></indexterm>
@@ -2066,23 +2863,47 @@ tapuscrit de base}]</literal>.
<para>Synopsis :
</para>
<screen>\begin{displaymath}
-<replaceable>math</replaceable>
+<replaceable>des maths</replaceable>
\end{displaymath}
</screen>
-<para>or
-</para>
-<screen>\[<replaceable>math</replaceable>\]
-</screen>
-<para>L&#8217;environnement <literal>displaymath</literal> (<literal>\[...\]</literal> est un synonyme)
-compose le texte <replaceable>math</replaceable> sur sa propre ligne, centré par défaut.
-L&#8217;option globale <literal>fleqn</literal> justifie les équations à gauche ; voir
-<link linkend="Document-class-options">Document class options</link>.
+
+<para>L&#8217;environnement <literal>displaymath</literal> compose le texte <replaceable>des maths</replaceable> sur
+sa propre ligne, centré par défaut. L&#8217;option globale <literal>fleqn</literal>
+justifie les équations à gauche ; voir <link linkend="Document-class-options">Document class options</link>.
</para>
<para>Aucun numéro d&#8217;équation n&#8217;est ajouté au texte de texte
-<literal>displaymath</literal> ; pour obtenir un numéro d&#8217;équation, utilisez
-l&#8217;environnement <literal>equation</literal> (voir <link linkend="equation">equation</link>).
+<literal>displaymath</literal> ; pour obtenir un numéro d&#8217;équation, vous pouvez
+utiliser l&#8217;environnement <literal>equation</literal> (voir <link linkend="equation">equation</link>).
+</para>
+<para>&latex; ne fait pas de saut de ligne au sein de <replaceable>des maths</replaceable>.
+</para>
+<indexterm role="fn"><primary>paquetage <literal>amsmath</literal></primary></indexterm>
+<indexterm role="fn"><primary><literal>amsmath</literal>, paquetage</primary></indexterm>
+<para>Notez que le paquetage <filename>amsmath</filename> comprend des possibilités beaucoup
+plus vastes en matière d&#8217;affichage d&#8217;équations. Par exemple, il offre
+plusieurs altenatives pour effectuer des sauts de lignes au sein de
+texte en mode mathématique.
+</para>
+<para>La construction <literal>\[<replaceable>des maths</replaceable>\]</literal> est essentiellement un
+synonyme de <literal>\begin{displaymath}<replaceable>des
+maths</replaceable>\end{displaymath}</literal>, mais ce dernier est plus pratique à
+manipuler dans le code source ; par exemple la recherche d&#8217;un caractère
+crochet <literal>]</literal> peut donner des faux positifs, alors qu&#8217;il est plus
+probable que le mot <literal>displaymath</literal> soit unique. (La construction
+<literal>$$<replaceable>des maths</replaceable>$$</literal> tirée du language &tex; de base est souvent
+utilisée à tort comme un synonyme de <literal>displaymath</literal>. Ce n&#8217;en est
+pas un, parce que l&#8217;environnement <literal>displaymath</literal> vérifie qu&#8217;il ne
+commence pas en mode mathérmatique, parce qu&#8217;il gère l&#8217;espacement
+verticial environment différemment, et parce qu&#8217;il honore l&#8217;option
+<literal>fleqn</literal>.)
+</para>
+<para>Le texte composé par cet exemple est centré et seul sur sa ligne.
+</para><screen>\begin{displaymath}
+ \int_1^2 x^2\,dx=7/3
+\end{displaymath}
+</screen><para>De plus, le signe intégrale est plus grand que ce que la version en
+ligne <literal>\( \int_1^2 x^2\,dx=7/3 \)</literal> produit.
</para>
-
</sect1>
<sect1 label="8.6" id="document">
<title><literal>document</literal></title>
@@ -2090,10 +2911,50 @@ l&#8217;environnement <literal>equation</literal> (voir <link linkend="equation"
<indexterm role="fn"><primary>environnement <literal>document</literal></primary></indexterm>
<indexterm role="fn"><primary><literal>document</literal>, environnement</primary></indexterm>
-<para>L&#8217;environnement <literal>document</literal> entoure le corps d&#8217;un document. Il est
-obligatoire dans tout document &latex;. Voir <link linkend="Starting-and-ending">Starting and ending</link>.
+<para>L&#8217;environnement <literal>document</literal> entoure le corps entier d&#8217;un document.
+Il est obligatoire dans tout document &latex;. Voir <link linkend="Starting-and-ending">Starting and
+ending</link>.
</para>
+<anchor id="_005cAtBeginDocument"/>
+
+<indexterm role="fn"><primary>\AtBeginDocument</primary></indexterm>
+<indexterm role="cp"><primary>début de document, crochet</primary></indexterm>
+
+<para>Synopsis :
+</para>
+<screen>\AtBeginDocument{<replaceable>code</replaceable>}
+</screen>
+<para>Sauvegarde <replaceable>code</replaceable> et exécute le quand <literal>\begin{document}</literal> est
+exécuté, à la toute fin du préambule. Le code est exécuté après que les
+tables de sélection de police ont été réglées, ainsi la police normale
+du document est la police courante. Toutefois, le code est exécuté en
+tant que faisant partie du préambule, c&#8217;est pourquoi on ne peut pas
+composer du texte avec.
+</para>
+<para>On peut utiliser cette commande plus d&#8217;une fois ; les lignes de code
+successives sont exécutée dans l&#8217;ordre de passage à la commande.
+</para>
+
+<anchor id="_005cAtEndDocument"/>
+
+<indexterm role="fn"><primary>\AtEndDocument</primary></indexterm>
+<indexterm role="cp"><primary>fin document, crochet</primary></indexterm>
+
+<para>Synopsis :
+</para>
+<screen>\AtEndDocument{<replaceable>code</replaceable>}
+</screen>
+<para>Sauvegarde <replaceable>code</replaceable> et l&#8217;exécute vers la fin du document. Plus
+précisément, il est exécuté lorsque <literal>\end{document}</literal> est exécuté,
+avant que la dernière page ne soit terminée et avant que tous
+environnements flottant restants soient traités. Si on désire d&#8217;une
+partie du code soit exécuté après ces deux traitements, alors il suffit
+d&#8217;inclure un <literal>\clearpage</literal> à l&#8217;endroit approprié du <replaceable>code</replaceable>.
+</para>
+<para>On peut utiliser cette commande plus d&#8217;une fois ; les lignes de code
+successives sont exécutée dans l&#8217;ordre de passage à la commande.
+</para>
</sect1>
<sect1 label="8.7" id="enumerate">
<title><literal>enumerate</literal></title>
@@ -2459,7 +3320,7 @@ environnement tel que as <literal>quote</literal> ou d&#8217;une <literal>parbox
</para>
<para>Contrairement à l&#8217;environnement <literal>flushright</literal>, la commande
<literal>\raggedleft</literal> ne commence pas un nouveau paragraphe ; elle change
-seuleemnt la façon dont &latex; formatte les unités de paragraphe. Pour
+seulement la façon dont &latex; formatte les unités de paragraphe. Pour
affecter le format d&#8217;une une unité de paragraphe, la portée de la
déclaration doit contenir la ligne à blanc ou la commande <literal>\end</literal> qui
termine l&#8217;unité de paragraphe.
@@ -2505,7 +3366,7 @@ sein de l&#8217;environnement.
<para>Si vous utilisez l&#8217;environnement <literal>babel</literal> avec la langue
<literal>french</literal>, alors il y a des tirets pour tous les niveaux comme c&#8217;est
-l&#8217;habitude des français.
+l&#8217;habitude des Français.
</para>
<indexterm role="fn"><primary>\labelitemi</primary></indexterm>
<indexterm role="fn"><primary>\labelitemii</primary></indexterm>
@@ -2656,7 +3517,7 @@ par <literal>\linewidth</literal> (voir <link linkend="Page-layout-parameters">P
<anchor id="_005citem"/>
-<para>Synopsis:
+<para>Synopsis :
</para>
<screen>\item texte de l'article
</screen>
@@ -2835,7 +3696,7 @@ ce qui peut aller dans une <literal>\mbox</literal> (voir <link linkend="_005cm
texte de la commande <literal>\put</literal>. Quand vous faites cela, le point de
référence devient le coin inférieur gauche de la boîte .
</para>
-<para>Les commandes <literal>picture</literal> sont décrites dans les sections suivantes.
+<para>Les commandes <literal>picture</literal> sont décrites dans les rubriques suivantes.
</para>
@@ -2844,7 +3705,8 @@ référence devient le coin inférieur gauche de la boîte .
<indexterm role="fn"><primary>\circle</primary></indexterm>
<para>Synopsis :
-</para><screen>\circle[*]{<replaceable>diamètre</replaceable>}
+</para><screen>\circle{<replaceable>diamètre</replaceable>}
+\circle*{<replaceable>diamètre</replaceable>}
</screen>
<para>La commande <literal>\circle</literal> produit un cercle dont le diamètre est le
plus proche possible de celui spécifié. La forme étoilée (en <literal>*</literal>)
@@ -3032,8 +3894,8 @@ moitié de l&#8217;ovale selon ce qui suit :
<para>Il est également possible de ne produire qu&#8217;un quart de l&#8217;ovale en
réglant <replaceable>portion</replaceable> à <literal>tr</literal>, <literal>br</literal>, <literal>bl</literal>, ou <literal>tl</literal>.
</para>
-<para>Les &#8220;coins&#8221; de l&#8217;ovale sont fabriqués avec des quarts de cercle d&#8217;un
-rayon maximal de 20pt, ainsi les &#8220;ovales&#8221; de grande taille
+<para>Les « coins » de l&#8217;ovale sont fabriqués avec des quarts de cercle d&#8217;un
+rayon maximal de 20pt, ainsi les « ovales » de grande taille
ressembleront plus à des boîtes aux coins arrondis.
</para>
@@ -3190,14 +4052,14 @@ suivante et toutes celles qui suivent.
</term><listitem><para>Déplace la marge de gauche d&#8217;un taquet vers la gauche pour la ligne
suivante et toutes celles qui suivent.
</para>
-</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\&#8217; (tabbing)</primary></indexterm><literal>\' (tabbing)</literal>
+</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\' (tabbing)</primary></indexterm><literal>\' (tabbing)</literal>
</term><listitem><para>Déplace tout ce que vous avez tapé jusqu&#8217;alors dans la colonne courante,
c.-à-d. tout ce qui suit la plus récente commande <literal>\&gt;</literal>,
<literal>\&lt;</literal>, <literal>\'</literal>, <literal>\\</literal>, ou <literal>\kill</literal>, à la droite de la
colonne précédente, aligné à droite sur le taquet de la colonne
courante.
</para>
-</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\&#8216; (tabbing)</primary></indexterm><literal>\` (tabbing)</literal>
+</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\` (tabbing)</primary></indexterm><literal>\` (tabbing)</literal>
</term><listitem><para>Vous perme de placer du texte justifié à droite sur n&#8217;importe quel
taquet, y compris le taquet 0. Toutefois, ne peut pas placer du texte à
la droite de la dernière colonne parce qu&#8217;il n&#8217;y a pas de taquet à cet
@@ -3206,8 +4068,8 @@ jusqu&#8217;à la commande <literal>\\</literal> ou <literal>\end{tabbing}</lite
ligne.
</para>
</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\a (tabbing)</primary></indexterm><literal>\a (tabbing)</literal>
-</term><listitem><indexterm role="fn"><primary>\a&#8217; (acute accent in tabbing)</primary></indexterm>
-<indexterm role="fn"><primary>\a&#8216; (grave accent in tabbing)</primary></indexterm>
+</term><listitem><indexterm role="fn"><primary>\a' (acute accent in tabbing)</primary></indexterm>
+<indexterm role="fn"><primary>\a` (grave accent in tabbing)</primary></indexterm>
<indexterm role="fn"><primary>\a= (macron accent in tabbing)</primary></indexterm>
<para>Dans un environnement <literal>tabbing</literal>, les commandes <literal>\=</literal>, <literal>\'</literal>
et <literal>\`</literal> ne produisent pas d&#8217;accents comme d&#8217;habitude
@@ -3290,8 +4152,8 @@ présent, il est utilisé dans la liste des talbeaux au lieu de <replaceable>tit
Deux &amp;Peut être aussi triste qu'un.
C'est le nombre le plus solitaire après le nombre un.
\end{tabular}
- \label{tab:VertusCardinales}
\caption{Vertus cardinales}
+ \label{tab:VertusCardinales}
\end{table}
</screen>
@@ -3319,7 +4181,7 @@ column 1 entry &amp; column 2 entry ... &amp; column n entry \\
</screen>
<para>Ces environnements produisent une boîte consistant d&#8217;une séquence de
ligne horizontales. Chaque ligne consiste en des articles qui sont
-alignés verticalement au sein de colonne. Ci-après une illustration de
+alignés verticalement au sein de colonnes. Ci-après une illustration de
beaucoup des caractéristiques.
</para>
<screen>\begin{tabular}{l|l}
@@ -3337,7 +4199,7 @@ filet horizontal entre deux ligne avec <literal>\hline</literal>.
<indexterm role="fn"><primary>\\ pour <literal>tabular</literal></primary></indexterm>
La fin de chaque ligne est marquée avec une
double-contr&#8217;oblique <literal>\\</literal>. Cette <literal>\\</literal> est optionnelle après
-la dernière lgine, à moins qu&#8217;une commande <literal>\hline</literal> suive, pour
+la dernière ligne, à moins qu&#8217;une commande <literal>\hline</literal> suive, pour
mettre un filet sous le tableau.
</para>
@@ -3390,11 +4252,11 @@ matériel <replaceable>texte ou espace</replaceable> est composé en mode LR. Ce
fragile (voir <link linkend="_005cprotect">\protect</link>).
</para>
<para>Ce spécificateur est optionnel : à moins que vous mettiez dans votre
-propre @-expression alors les classe <literal>book</literal>, <literal>article</literal> et
-<literal>report</literal> de &latex; mette de chaque côté de chaque colonne un
+propre @-expression alors les classes <literal>book</literal>, <literal>article</literal> et
+<literal>report</literal> de &latex; mettent de chaque côté de chaque colonne un
espace de longueur <literal>\tabcolsep</literal>, qui par défaut vaut
-&#8216;<literal>6pt</literal>&#8217;. C&#8217;est à dire que par défaut des colonnes adjacente sont
-séparée de 12pt (ainsi <literal>\tabcolsep</literal> est un nom trompeur
+&#8216;<literal>6pt</literal>&#8217;. C&#8217;est à dire que par défaut des colonnes adjacentes sont
+séparées de 12pt (ainsi <literal>\tabcolsep</literal> est un nom trompeur
puisque ce n&#8217;est pas la séparation entre des colonnes de
tableau). Aussi, par défaut un espace de 6pt vient après la
première colonne ainsi qu&#8217;après la dernière colonne, à moins que vous
@@ -3402,11 +4264,11 @@ placiez un <literal>@{...}</literal> ou <literal>|</literal> à cet endroit.
</para>
<para>Si vous l&#8217;emportez sur la valeur par défaut et utilisez une expression
en <literal>@{...}</literal> alors vous devez insérer tout espace désiré
-vous-même, commande <literal>@{\hspace{1em}}</literal>.
+vous-même, comme dans <literal>@{\hspace{1em}}</literal>.
</para>
-<para>Une expression vide <literal>@{}</literal> élimine l&#8217;espace, y compris l&#8217;express
-au début ou à la fin, commande dans l&#8217;exemple ci-dessous où on veut que
-les ligne du tableau soient alignée sur la marge de gauche.
+<para>Une expression vide <literal>@{}</literal> élimine l&#8217;espace, y compris l&#8217;espace
+au début ou à la fin, comme dans l&#8217;exemple ci-dessous où on veut que les
+lignes du tableau soient alignées sur la marge de gauche.
</para>
<screen>\begin{flushleft}
\begin{tabular}{@{}l}
@@ -4346,7 +5208,7 @@ elles apparaissent alphabétiquement. Voir <link linkend="minipage">minipage</li
<indexterm role="fn"><primary>\footnotemark</primary></indexterm>
-<para>Synopsis:
+<para>Synopsis :
</para>
<screen>\footnotemark
</screen>
@@ -4495,6 +5357,7 @@ supplémentaire entre les notes. Cela vaut &#8216;<literal>6.65pt</literal>&#821
des genres.
</para>
<!-- xx everything in this chapter needs exemples. -->
+<!-- xx Add DeclareRobustCommand (see clsguide.pdf) -->
<sect1 label="12.1" id="_005cnewcommand-_0026-_005crenewcommand">
@@ -4807,7 +5670,7 @@ pour l&#8217;utiliser dans <replaceable>déffin</replaceable>, dans ce cas dans
<indexterm role="cp"><primary>théorème, environnement simili-</primary></indexterm>
<indexterm role="cp"><primary>environnement simili-théorème</primary></indexterm>
-<para>Définit une nouvel <firstterm>environnement simili-théorème</firstterm>. Synopsis:
+<para>Définit une nouvel <firstterm>environnement simili-théorème</firstterm>. Synopsis :
</para>
<screen>\newtheorem{<replaceable>nom</replaceable>}{<replaceable>titre</replaceable>}[<replaceable>numéroté_au_sein_de</replaceable>]
@@ -4818,7 +5681,7 @@ pour l&#8217;utiliser dans <replaceable>déffin</replaceable>, dans ce cas dans
</para>
<screen>\newtheorem{<replaceable>nom</replaceable>}{<replaceable>titre</replaceable>}[<replaceable>numéroté_au_sein_de</replaceable>]
</screen>
-<para>avec l&#8217;argument optionnnel après le second argument
+<para>avec l&#8217;argument optionnel après le second argument
obligatoire, crée un environnement dont le compteur est subordonné au
compteur déjà existant <replaceable>numéroté_au_sein_de</replaceable>, c.-à-d. qui est
réinitialisé à it will chaque réinitialisation de
@@ -5291,7 +6154,7 @@ comme <literal>\setlength{\itemsep}{1ex plus 0.05ex minus 0.01ex}</literal>
reste raisonnable si la fonte est changée que si elle était exprimée en
points.
</para>
-<indexterm role="cp"><primary>mu, math unit</primary></indexterm>
+<indexterm role="cp"><primary>mu, unité mathématique</primary></indexterm>
<indexterm role="fn"><primary>mu</primary></indexterm>
<para>En mode mathématique, beaucoup de définitions sont exprimées dans
l&#8217;unité mathématique <firstterm>mu</firstterm> donnée par 1em = 18mu, où le
@@ -6744,7 +7607,7 @@ math. Elles diffèrent de celles concernant les accents en texte normal
<indexterm role="cp"><primary>mode mathématique, espacement</primary></indexterm>
<para>Au sein d&#8217;un environnement <literal>math</literal>, &latex; ignore les espaces que
-vous tapez et met à la place l&#8217;espaceement correspondant au règles
+vous tapez et met à la place l&#8217;espacement correspondant aux règles
normales pour les textes mathématiques.
</para>
<para>En mode mathématique, beaucoup de définitions sont exprimées dans
@@ -7154,7 +8017,8 @@ mode texte, mais est le plus souvent utile en mode math (voir <link linkend="Spa
<para>Synopsis :
</para>
-<screen>\hspace[*]{<replaceable>longueur</replaceable>}
+<screen>\hspace{<replaceable>longueur</replaceable>}
+\hspace*{<replaceable>longueur</replaceable>}
</screen>
<para>La commande <literal>\hspace</literal> ajoute de l&#8217;espace horizontal. L&#8217;argument
<replaceable>longueur</replaceable> peut être exprimé en toute unité que &latex; comprend :
@@ -7164,7 +8028,7 @@ commande <literal>\hspace</literal> ; ajouter de l&#8217;espace negatif revient
retourner en arrière.
</para>
<para>&latex; enlève normalement l&#8217;espace horizontal qui vient au début ou à
-la fin d&#8217;une ligne. Pour préserver cet espace, utilisez la forme forme
+la fin d&#8217;une ligne. Pour préserver cet espace, utilisez la forme
étoilée, c.-à-d. avec le suffixe <literal>*</literal> optionnel.
</para>
@@ -7353,21 +8217,21 @@ défaut de 0.33em à 1.00em.
</para>
<para>Ajoute un espace vertical de longeur <replaceable>length</replaceable>, ce qui est une
longueur élatsique (voir <link linkend="Lengths">Lengths</link>). Toutefois, si l&#8217;espace vertical a
-déjà été ajoutée au même point de la sortie par une commande
+déjà été ajouté au même point de la sortie par une commande
<literal>\addvspace</literal> précédente, alors cette commande n&#8217;ajoutera pas plus
d&#8217;espace que nécessaire à fabriquer la longeur naturelle de l&#8217;espace
vertical total égale à <replaceable>length</replaceable>.
</para>
-<para>Utilisez cette commande pour ajuster l&#8217;espace verticale au-dessus ou
+<para>Utilisez cette commande pour ajuster l&#8217;espace vertical au-dessus ou
au-dessous d&#8217;un environnement qui commence un nouveau paragraphe. (Par
exemple, un environnement Theorem est défini pour commencer et finir en
<literal>\addvspace{..}</literal> de sorte que deux Theorem consécutifs sont
-séparés par un espace verticale, et non deux.)
+séparés par un espace vertical, et non deux.)
</para>
<para>Cette commande est fragile (voir <link linkend="_005cprotect">\protect</link>).
</para>
<para>L&#8217;erreur &#8216;<literal>Something's wrong--perhaps a missing \item</literal>&#8217; signifie que
-vous n&#8217;étiez pas en mode verticale quand vous avez invoqué cette
+vous n&#8217;étiez pas en mode vertical quand vous avez invoqué cette
commande ; une façon pour sortir de cela et de faire précéder cette
commande d&#8217;une commande <literal>\par</literal>.
</para>
@@ -7579,13 +8443,15 @@ voir <link linkend="_005cmakebox-_0028picture_0029">\makebox (picture)</link>.
</para>
<screen>\parbox[<replaceable>position</replaceable>][<replaceable>hauteur</replaceable>][<replaceable>pos-interne</replaceable>]{<replaceable>largeur</replaceable>}{<replaceable>texte</replaceable>}
</screen>
+<indexterm role="cp"><primary>mode paragraphe</primary></indexterm>
+<indexterm role="cp"><primary>paragraphe, mode</primary></indexterm>
<para>La commande <literal>\parbox</literal> produit une boîte dont le contenu est créé en
-mode <literal>paragraphe</literal>. On devrait l&#8217;utiliser pour fabriquer une boîte
-à partir de petits moreaux de texte, avec rien de fantaisiste à
+<firstterm>mode paragraphe</firstterm>. On devrait l&#8217;utiliser pour fabriquer une boîte à
+partir de petits moreaux de texte, avec rien de trop élaboré à
l&#8217;intérieur. En particulier, vous ne devriez utiliser aucun
-environnements de fabrication de paragraphe au sein de l&#8217;argument
+environnement de fabrication de paragraphe au sein de l&#8217;argument
<replaceable>texte</replaceable> d&#8217;une <literal>\parbox</literal>. Pour des morceaux de texte de plus
-grande taille , y compris ceux comprenant un environnement de
+grande taille, y compris ceux comprenant un environnement de
fabrication de paragraphe, vous devriez utiliser un environnement
<literal>minipage</literal> (voir <link linkend="minipage">minipage</link>).
</para>
@@ -8098,7 +8964,7 @@ disponible avec l&#8217;OT1.
</para>
</listitem></varlistentry><varlistentry><term><literal>\'</literal>
</term><term><literal>\capitalacute</literal>
-</term><listitem><indexterm role="fn"><primary>\&#8217; (acute accent)</primary></indexterm>
+</term><listitem><indexterm role="fn"><primary>\' (acute accent)</primary></indexterm>
<indexterm role="fn"><primary>\capitalacute</primary></indexterm>
<indexterm role="cp"><primary>accent aigu</primary></indexterm>
<indexterm role="cp"><primary>diacrtique accent aigu</primary></indexterm>
@@ -8140,7 +9006,7 @@ dans &#333;.
</para>
</listitem></varlistentry><varlistentry><term><literal>\`</literal>
</term><term><literal>\capitalgrave</literal>
-</term><listitem><indexterm role="fn"><primary>\&#8216; (accent grave)</primary></indexterm>
+</term><listitem><indexterm role="fn"><primary>\` (accent grave)</primary></indexterm>
<indexterm role="fn"><primary>\capitalgrave</primary></indexterm>
<indexterm role="cp"><primary>grave accent</primary></indexterm>
<para>Produit un accent grave suscrit à la lettre qui suit, comme dans
@@ -8421,8 +9287,8 @@ suivant produit &#8216;<literal>4 juillet 1976</literal>&#8217; :
<indexterm role="fn"><primary>paquetage <literal>datetime</literal></primary></indexterm>
<indexterm role="fn"><primary><literal>datetime</literal>, paquetage</primary></indexterm>
-<para>La paquetage <literal>datetime</literal> package, entre autres, can produce a wide variety
-of other date formats.
+<para>Le paquetage <literal>datetime</literal>, entre autres, produit un large choix
+d&#8217;autres formats de date.
</para>
</sect1>
@@ -8481,7 +9347,7 @@ au sein d&#8217;un fichier lu par une autre commande <literal>\include</literal>
<para>La commande <literal>\includeonly</literal> contrôle quels fichiers sont lisible par
toute commande <literal>\include</literal> venant ensuite. La liste des noms de
fichier est à éléments séparés par des virgules. Chaque élément
-<replaceable>fichier1</replaceable>, <replaceable>fichier2</replaceable>, &#8230; doit exacteemnt correspondre à
+<replaceable>fichier1</replaceable>, <replaceable>fichier2</replaceable>, &#8230; doit exactement correspondre à
un nom de fichier spécifié en argument d&#8217;une commande <literal>\include</literal>
pour que la sélection soit effective.
</para>
@@ -8589,20 +9455,22 @@ suivantes, selon la valeur de l&#8217;argument <replaceable>ext</replaceable> :
</sect2>
<sect2 label="23.1.2" id="_005caddtocontents">
-<title>\addtocontents</title>
+<title><literal>\addtocontents</literal></title>
<indexterm role="fn"><primary>\addtocontents{<replaceable>ext</replaceable>}{<replaceable>texte</replaceable>}</primary></indexterm>
-<para>The <literal>\addtocontents</literal>{<replaceable>ext</replaceable>}{<replaceable>texte</replaceable>} commande adds texte
-(or formatting commandes) directly to the <filename>.<replaceable>ext</replaceable></filename> file that
-generates the table of contents or listes of figures or tables.
+<para>La commande <literal>\addtocontents</literal>{<replaceable>ext</replaceable>}{<replaceable>texte</replaceable>} ajoute du
+texte (ou des commandes de formatage) directement au fichier
+<filename>.<replaceable>ext</replaceable></filename> qui génère la tables des matières, ou la liste des
+figures ou des tableaux. generates the table of contents or listes of
+figures or tables.
</para>
<variablelist><varlistentry><term><replaceable>ext</replaceable>
-</term><listitem><para>The extension of the file on which information is to be written:
-<filename>toc</filename> (table of contents), <filename>lof</filename> (list of figures), or
-<filename>lot</filename> (list of tables).
+</term><listitem><para>L&#8217;extension de nom de fichier du fichier dans lequel l&#8217;information est à
+écrire : <filename>toc</filename> (table des matières), <filename>lof</filename> (liste des
+figures), ou <filename>lot</filename> (liste des tableaux).
</para>
</listitem></varlistentry><varlistentry><term><replaceable>texte</replaceable>
-</term><listitem><para>The texte to be written.
+</term><listitem><para>Le texte à écrire.
</para></listitem></varlistentry></variablelist>
</sect2>
@@ -8622,11 +9490,11 @@ l&#8217;extension <filename>.glo</filename>.
</para>
<indexterm role="fn"><primary>\glossaryentry</primary></indexterm>
<para>Plus précisément, ce qui est écrit est la commande
-<literal>\glossaryentry{<replaceable>texte</replaceable>}{<replaceable>numpage</replaceable>}</literal>, where <replaceable>numpage</replaceable>
+<literal>\glossaryentry{<replaceable>texte</replaceable>}{<replaceable>numpage</replaceable>}</literal>, où <replaceable>numpage</replaceable>
est la valeur courante de <literal>\thepage</literal>.
</para>
<para>Le paquetage <literal>glossary</literal> disponible sur le CTAN fournit une prise en
-charge de glossaires plus glossaries.
+charge de glossaires plus élaborée.
</para>
</sect1>
@@ -8685,8 +9553,8 @@ nouvelle lettre dans l&#8217;index imprimé ; sa valeur par défaut est
</para>
<indexterm role="fn"><primary>paquetage <literal>showidx</literal></primary></indexterm>
<indexterm role="fn"><primary><literal>showidx</literal>, paquetage</primary></indexterm>
-<para>Le paquetage <literal>showidx</literal> a pour effet que chaque articule de l&#8217;index
-est affiché das la marge de la page où l&#8217;article apparaît. Ceci peut
+<para>Le paquetage <literal>showidx</literal> a pour effet que chaque article de l&#8217;index
+est affiché dans la marge de la page où l&#8217;article apparaît. Ceci peut
aider à la préparation de l&#8217;index.
</para>
<indexterm role="fn"><primary>paquetage <literal>multind</literal></primary></indexterm>
@@ -8804,17 +9672,17 @@ I ne suis pas intéressé à faire affaire avec vous.
</screen>
<para>Spécifie l&#8217;adresse de retour telle qu&#8217;elle apparaît sur la lettre et sur
l&#8217;enveloppe. Séparez des lignes multiples au sein de
-<literal>adresse-expéditeurs</literal> avec une double contr&#8217;oblique <literal>\\</literal>.
+<replaceable>adresse-expéditeurs</replaceable> avec une double contr&#8217;oblique <literal>\\</literal>.
</para>
-<para>Parce qu&#8217;elle peut s&#8217;applique à des lettres multipls cette déclaration
+<para>Parce qu&#8217;elle peut s&#8217;appliquer à des lettres multiples cette déclaration
est souvent placée dans le préambule. Toutefois elle peut être faite
-n&#8217;importe où, y compris au sein d&#8217;un environnement <literal>lettre</literal>
+n&#8217;importe où, y compris au sein d&#8217;un environnement <literal>letter</literal>
individuel.
</para>
<para>Cette commande est optionnelle : sans la déclaration <literal>\address</literal> la
lettre est formatée avec un espace à blanc en haut de sorte à pouvoir
être imprimée sur du papier à en-tête pré-imprimé. (Voir <link linkend="Overview">Overview</link>,
-pour les détails concernant votre implémetation locale). Avec la
+pour les détails concernant votre implémentation locale). Avec la
déclaration <literal>\address</literal>, elle est formatée comme une lettre
personnelle.
</para>
@@ -8831,11 +9699,15 @@ personnelle.
</para>
<screen>\cc{<replaceable>premier nom</replaceable>\\...}
</screen>
-<para>Produit une liste de nom de personne mis en copie de la lettre. Cette
+<para>Produit une liste de noms de personnes mis en copie de la lettre. Cette
commande est optionnelle. Si elle est présente, alors elle vient
typiquement après le <literal>\closing</literal>. En cas de ligne multiple, séparez
-les avec une double contr&#8217;oblique <literal>\\</literal>.
+les avec une double contr&#8217;oblique <literal>\\</literal>, comme dans :
</para>
+<screen>\cc{Président \\
+ Vice-président}
+</screen>
+
</sect1>
<sect1 label="24.3" id="_005cclosing">
@@ -8854,7 +9726,7 @@ les avec une double contr&#8217;oblique <literal>\\</literal>.
<para>D&#8217;ordinaire à la fin d&#8217;une lettre, au dessus de la signature manuscrite,
il y a un <literal>\closing</literal> (bien que cette commande soit
-optionnnelle). Par exemple :
+optionnelle). Par exemple :
</para>
<screen>\closing{Je vous prie, Madame, Monsieur, d'agréer l'expression de ma
confiance.}
@@ -8974,7 +9846,7 @@ texte d&#8217;<firstterm>appel</firstterm> de votre lettre. Par exemple :
<indexterm role="fn"><primary>\ps</primary></indexterm>
<indexterm role="cp"><primary>postscriptum, dans une lettre</primary></indexterm>
-<para>Synopsis:
+<para>Synopsis :
</para>
<screen>\ps{<replaceable>texte</replaceable>}
</screen>
@@ -8988,18 +9860,19 @@ texte d&#8217;<firstterm>appel</firstterm> de votre lettre. Par exemple :
<title><literal>\signature{<replaceable>texte</replaceable>}</literal></title>
<indexterm role="fn"><primary>\signature</primary></indexterm>
-<para>Synopsis:
+<para>Synopsis :
</para>
-<screen>\signature{<replaceable>first line</replaceable> \\
+<screen>\signature{<replaceable>première ligne</replaceable> \\
... }
</screen>
<indexterm role="fn"><primary>\signature</primary></indexterm>
-<para>Le nom de l&#8217;expérditeur. Cette commande est optionnelle, quoique sont inclusion est habituelle.
+<para>Le nom de l&#8217;expéditeur. Cette commande est optionnelle, quoique son
+inclusion soit habituelle.
</para>
<para>Le texte de l&#8217;argument apparaît à la fin de la lettre, après la clôture
et après une espace verticale pour la signature manuscrite
-traditionnelle. Séparez des ligne multiple avec une double
+traditionnelle. Séparez des lignes multiples avec une double
contr&#8217;oblique <literal>\\</literal>. Par exemple :
</para>
<screen>\signature{J Fred Muggs \\
@@ -9016,7 +9889,7 @@ avant le <literal>\closing</literal>.
</para>
<para>Vous pouvez inclure un graphique dans la signature, par exemple avec
<literal>\signature{\vspace{-6\medskipamount}\includegraphics{sig.png}\\
-My name}</literal> (ceci nécesste d&#8217;écrire <literal>\usepackage{graphicx}</literal> dans
+My name}</literal> (ceci nécessite d&#8217;écrire <literal>\usepackage{graphicx}</literal> dans
le préambule).
</para>
<!-- Jim a écrit: I think this is not a user-level command; it is used to keep from breaking -->
@@ -9046,7 +9919,7 @@ le préambule).
<title><literal>\telephone</literal></title>
<indexterm role="fn"><primary>\telephone</primary></indexterm>
-<para>Synopsis:
+<para>Synopsis :
</para>
<para><literal>\telephone{<replaceable>numéro</replaceable>}</literal>
</para>
@@ -9114,8 +9987,8 @@ l&#8217;entourent. Un <literal>^^J</literal> dans <literal>msg</literal> tape un
&tex; utilise <filename>.tex</filename> comme extension de fichier par défaut. Si
vous omettez complètment le fichier d&#8217;entrée, &tex; accèpte en entrée
les caractères saisis à partir de la console. Vous spécifiez les
-options de commande en fournissant supplying une chaîne en paramètre de
-la commande ; par ex.
+options de commande en fournissant une chaîne en paramètre de la
+commande ; par ex.
</para>
<screen>latex '\nonstopmode\input foo.tex'
</screen>
@@ -9127,7 +10000,7 @@ la commande ; par ex.
<para>Si &latex; s&#8217;arrête au milieu du document et vous fait une invite en
&#8216;<literal>*</literal>&#8217;, c&#8217;est qu&#8217;il attend que vous saisissiez quelque chose. Vous
pouvez taper <literal>\stop</literal> (et retour-chariot) et il terminera
-prematurément le document.
+prématurément le document.
</para>
<para>Voir <link linkend="TeX-engines">&tex; engines</link>, pour les autres commandes système invoquant &latex;.
</para>
@@ -9223,65 +10096,74 @@ Users Group), <ulink url="http://tug.org/TUGboat">http://tug.org/TUGboat</ulink>
\usepackage{url}
\fi
-\title{exemple \TUB\ article}
+\title{Exemple d'article \TUB}
-% repeat info for each author.
-\author{First Last}
-\address{Street Address \\ Town, Postal \\ Country}
+% 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/}
+ %%% Fin des métadonnées %%%
+
\begin{document}
\maketitle
\begin{abstract}
-This is an exemple article for \TUB{}.
+Ceci est un exemple d'article pour le \TUB{}.
+Prière d'écrire un abrégé.
\end{abstract}
\section{Introduction}
-This is an exemple article for \TUB, from
+Ceci est un exemple d'article pour le \TUB, à partir du lien
\url{http://tug.org/TUGboat/location.html}.
-We recommend the graphicx package for image inclusions, and the
-hyperref package for active url's (in the \acro{PDF} output).
-Nowadays \TUB\ is produced using \acro{PDF} files exclusively.
+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}.
-The \texttt{ltugboat} class provides these abbreviations and many more:
+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
-\Mc \mf \MFB \mtex \PCTeX \pcTeX
-\PiC \PiCTeX \plain \POBox \PS
-\SC \SGML \SliTeX \TANGLE \TB \TP
+\mf \MFB
+\plain \POBox \PS
\TUB \TUG \tug
-\UG \UNIX \VAX \XeT \WEB \WEAVE
+\UNIX \XeT \WEB \WEAVE
-\Dash \dash \vellipsis \bull \cents \Dag
-\careof \thinskip
+\, \bull \Dash \dash \hyph
-\acro{FRED} -&gt; {\small[er] fred} % please use!
+\acro{FRED} -&gt; {\small[er] fred} % prière d'utiliser !
\cs{fred} -&gt; \fred
-\env{fred} -&gt; \begin{fred}
\meta{fred} -&gt; &lt;fred&gt;
\nth{n} -&gt; 1st, 2nd, ...
\sfrac{3/4} -&gt; 3/4
\booktitle{Book of Fred}
\end{verbatim}
-For more information, see the ltubguid document at:
-\url{http://mirror.ctan.org/macros/latex/contrib/tugboat}
-(we recommend using \verb|mirror.ctan.org| for \CTAN\ references).
+Pour faire référence à d'autre numéros du \TUB\, veuillez utiliser le
+format \textsl{volno:issno}, par ex., ``\TUB\ 32:1'' pour notre numéro
+\nth{100}.
+
+Ce fichier n'est qu'un patron. La documentation du style \TUB\ est dans
+le document \texttt{ltubguid} se trouvant à
+\url{http://ctan.org/pkg/tugboat}. (Pour les références au \CTAN\ nous
+recommandons cette forme d'URL utilisant \texttt{/pkg/} quand cela fait
+sens ; ou, si vous avez besoin de faire référence spécifiquement à une
+localisation : \texttt{http://mirror.ctan.org/\textsl{chemin}}.)
-Email \verb|tugboat@tug.org| if problems or questions.
+Écrivez par mél à \verb|tugboat@tug.org| en cas de problèmes ou
+questions.
-\bibliographystyle{plain} % we recommend the plain bibliography style
-\nocite{book-minimal} % just making the bibliography non-empty
-\bibliography{xampl} % xampl.bib comes avec BibTeX
+\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
\makesignature
\end{document}