diff options
Diffstat (limited to 'info/latex2e-help-texinfo-fr/latex2e-fr.texi')
| -rw-r--r-- | info/latex2e-help-texinfo-fr/latex2e-fr.texi | 10995 |
1 files changed, 10995 insertions, 0 deletions
diff --git a/info/latex2e-help-texinfo-fr/latex2e-fr.texi b/info/latex2e-help-texinfo-fr/latex2e-fr.texi new file mode 100644 index 0000000000..db72f4250c --- /dev/null +++ b/info/latex2e-help-texinfo-fr/latex2e-fr.texi @@ -0,0 +1,10995 @@ +\input texinfo +@c $ Id: latex2e.texi 285 20/07/2014 21:40:48 Z vincentb1 $ +@comment % ** début de tête (c'est pour courir Texinfo sur une région.) +@setfilename latex2e-fr.info +@documentlanguage fr +@documentencoding UTF-8 +@set UPDATED Août 2017 +@include common.texi +@settitle manuel de référence officieux de @LaTeX{}2e (@value{UPDATED}) +@comment % ** fin de tête (c'est pour courir Texinfo sur une région.) + +@c latex 2.09 commandes devraient tous être présents maintenant, +@c xx mais LaTeX2e substance est manquant. +@c xx une liste aléatoire de quelques items manquant est à la fin de ce fichier +@c +@c xx misc commands from clsguide.pdf: MakeUpperCase, \ignorespacesafterend, +@c \normalsfcodes +@c xx color (include info from clsguide.pdf) +@c xx ending a run with errors +@c xx ctan, distributions, composant de TeX +@c xx mention \nocorr, \textit et ic +@c xx donner réelle smallskip / etc. par défaut +@c +@c xx fusionner http://ctan.org/pkg/latex-info (paquetage CTAN latex-info) +@c xx fusionner permutée-index +@c xx fusionner latex manuel de la savane +@c xx fusionner style mathématique hors texte +@c xx mode veritical, mode horizontal +@c +@c xx Le source2e typographie a un index avec tous noyau +@c commandes xx, même si certains sont internes et ne devraient pas être inclus. +@c xx classes.dtx et al. définir des commandes supplémentaires. +@c xx Voir aussi http://ctan.org/pkg/macros2e. +@c +@c packages xx - requis, plus, utile; Oberdiek; polices + +@c ressources pour les termes typographiques en français: +@c http://david.carella.free.fr/fr/typographie/glossaire-typographique.html +@c http://www.cavi.univ-paris3.fr/phalese/desslate/index.htm +@c http://cahiers.gutenberg.eu.org/cg-bin/article/CG_2007___49_19_0.pdf +@c Ainsi que http://gdt.oqlf.gouv.qc.ca/ +@c +@c Autres ressources: +@c https://www.latex-project.org/help/books/lc2fr-apb.pdf + +@copying +Ce document est un manuel de référence officieux pour @LaTeX{}, un +système de préparation de documents, version « @value{UPDATED} ». + +Ce manuel a été traduit du fichier @file{LATEX.HLP} v1.0a de la +bibliothèque d'aide VMS. La version pré-traduction a été rédigé par +George D. Greenwade de Sam Houston State University. La version +@LaTeX{} 2.09 a été rédigée par Stephen Gilmore. La version @LaTeX{}2e a +été adapté à partir de cellce-ci par Torsten Martinsen. Karl Berry a +fait d'autres mises à jour et ajouts, et reconnaît avec gratitude avoir +utilisé @cite{Hypertext Help with @LaTeX{}}, de Sheldon Green, et +@cite{@LaTeX{} Command Summary} (pour @LaTeX{}2.09) de L. Botway et +C. Biemesderfer (publié par le @TeX{} Users Group en tant que +@cite{@TeX{}niques} numéro 10), il l'a utilisé en tant que matériel de +référence (aucun texte n'était directement copié). + +Tous droits réservés @copyright{} 2015-2017 Vincent Belaïche --- traduction.@* +Tous droits réservés @copyright{} 2007, 2008, 2009, 2010, 2011, 2012, 2013, +2014, 2015, 2016, 2017 Karl Berry. @* +Tous droits réservés @copyright{} 1988, 1994, 2007 Stephen Gilmore. @* +Tous droits réservés @copyright{} 1994, 1995, 1996 Torsten Martinsen. + +Ci-après se trouve la licence sous laquelle est distribuée ce manuel, +une traduction en est donnée en annexe, voir @ref{License translation}. + +@comment start of License +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. + +@ignore +Permission is granted to process this file through TeX and print the +results, provided the printed document carries copying permission +notice identical to this one except for the removal of this paragraph +(this paragraph not being relevant to the printed manual). +@end ignore + +Permission is granted to copy and distribute modified versions of this +manual under the conditions for verbatim copying, provided that the entire +resulting derived work is distributed under the terms of a permission +notice identical to this one. + +Permission is granted to copy and distribute translations of this manual +into another language, under the above conditions for modified versions. +@comment end of License +@end copying + +@dircategory TeX +@direntry +* LaTeX2e-fr: (latex2e-fr). Manuel de référence officieux de LaTeX. +@end direntry + +@tex +\global\hbadness = 4444% ne te plains pas trop +@end tex + +@titlepage +@title @LaTeX{}2e: Un manuel de référence officieux +@subtitle @value{UPDATED} +@author @url{@value{LTXREFMAN_HOME_PAGE}} +@page +@vskip 0pt plus 1filll +@insertcopying +@end titlepage + +@shortcontents +@contents + +@c Best Effort Symbol +@iftex +@macro BES {utf8,math} +@math{\math\} +@end macro +@macro BESU {utf8,math} +@math{@code{@backslashchar{}\math\}} +@end macro +@macro iftexthenelse {then,else} +\then\@c +@end macro +@end iftex +@ifnottex +@macro BES {utf8,math} +\utf8\ +@end macro +@macro BESU {utf8,math} +\utf8\ +@end macro +@macro iftexthenelse {then,else} +\else\@c +@end macro +@end ifnottex +@macro EnvIndex {env} +@findex @r{environnement} @code{\env\} +@findex @code{\env\}, @r{environnement} +@end macro +@macro PkgIndex {pkg} +@findex @r{paquetage} @code{\pkg\} +@findex @code{\pkg\}, @r{paquetage} +@end macro +@set NotInPlainTeX Ceci n'est pas disponible en @TeX{} de base. +@set NeedsAMSSymb @value{NotInPlainTeX} En @LaTeX{} vous devez charger le paquetage @file{amssymb}. +@set NeedsSTIX @value{NotInPlainTeX} En @LaTeX{} vous devez charger le paquetage @file{stix}. + +@clear HAS-MATH +@iftex +@set HAS-MATH +@end iftex + +@node Top +@top @LaTeX{}2e : un manuel de référence officieux + +Ce document est un manuel de référence officieux pour @LaTeX{}2e, un +système de préparation de document, dans sa version « @value{UPDATED} ». + +@menu +* À propos de ce document: About this document. reporter les bogues, etc. +* Aperçu: Overview. Qu'est-ce que @LaTeX{}?. +* Classe de documents: Document classes. Certaines des différentes classes disponibles. +* Polices: Fonts. italique, gras, machine à écrire, etc +* Mise en page: Layout. Contrôle de la mise en page. +* Rubricage: Sectioning. Comment bien faire des rubriques. +* Les références croisées: Cross references. Référencement automatique. +* Environnements: Environments. tels que @code{enumerate} et @code{itemize}. +* Sauts de ligne: Line breaking. Influencer les sauts de ligne. +* Sauts de page: Page breaking. Influencer les sauts de page. +* Notes en bas de page: Footnotes. Comment produire des notes en bas de page. +* Définitions: Definitions. Définir vos propres commandes, etc +* Compteurs: Counters. Compteurs internes utilisés par @LaTeX{}. +* Longueurs: Lengths. Les commandes pour manipuler des longueurs. +* Faire des paragraphes: Making paragraphs. Commandes pour contrôler les paragraphes. +* Formules de maths: Math formulas. Comment créer des formules mathématiques. +* Modes: Modes. Modes paragraphe, mathématiques ou LR. +* Les styles de page: Page styles. Différents styles de mise en page. +* Les espaces: Spaces. Espace horizontal et vertical. +* Boîtes: Boxes. Faire des boîtes. +* Insertions spéciales: Special insertions. Insertion de caractères réservés et spéciaux. +* Diviser l'entrée: Splitting the input. Traiter de gros fichiers en les partitionnant. +* Prologue et épilogue: Front/back matter. Tables des matières, glossaires, index. +* Lettres: Letters. La classe @code{letter}. +* Entrée / sortie du terminal: Terminal input/output. Interaction avec l'utilisateur. +* La ligne de commande: Command line. Comportement indépendant du système de la ligne de commande. +* Patrons de document: Document templates. Patron pour commencer diverses classes de documents. +* Traduction de la license: License translation. Une traduction à titre informatif de la licence. +* Index des Concepts: Concept Index. Index général. +* Index des commandes: Command Index. Liste alphabétique des commandes @LaTeX{}. +@end menu + + +@node About this document +@chapter À propos de ce document + +@findex @url{@value{LTXREFMAN_HOME_PAGE}} @r{page d'accueil} +Ceci est un manuel de référence officieux pour le système @LaTeX{}2e de +préparation de document, ce système est mis en oeuvre sous forme d'un +paquet de macros pour le programme de composition @TeX{} +(@pxref{Overview}). La page d'accueil de ce document est +@url{@value{LTXREFMAN_HOME_PAGE}}. Cette page contient des liens vers +les produits courants de fabrication du document dans différents +formats, les sources, les listes de diffusion, et d'autres +infrastructures. + +@cindex @LaTeX{} ou @LaTeX{}2e, que choisir ? +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'années. + +@cindex officieuse, nature de ce document +@cindex L'équipe de projet @LaTeX{} +@findex @email{@value{LTXREFMAN_BUGS}} @r{adresse mél.} +@LaTeX{} est désormais maintenu par un groupe de bénévoles +(@url{http://latex-project.org}). La documentation officielle écrite +par le projet @LaTeX{} est disponible à partir de leur site web. +Le présent document est complètement officieux et n'a pas été examiné +par les mainteneurs de @LaTeX{}. +@cindex rapports d'anomalies +@cindex rapports de bogues +@cindex bogues, rapports +@cindex anomalies, rapports +Ne leur envoyez donc pas de rapports d'anomalie ou quoi que ce soit +d'autre. Au lieu de cela, s'il vous plaît envoyez tous commentaires à +@email{@value{LTXREFMAN_BUGS}}. + +Ce document est un manuel de référence. Il y a une vaste gamme d'autres sources d'information sur +@LaTeX{}, de tous niveaux. Voici quelques introductions : + +@c voir http://mirror.ctan.org/help/ctan/CTAN-upload-addendum.html#urls +@table @url +@item http://ctan.org/pkg/latex-doc-ptr +@findex latex-doc-ptr @r{document} +Deux pages de références recommandées à @LaTeX{} documentation. + +@item http://ctan.org/pkg/first-latex-doc +@findex first-latex-doc @r{document} +Rédaction de votre premier document, avec un peu de texte et de mathématiques. + +@item http://ctan.org/pkg/usrguide +@findex usrguide @r{documentation officielle} +Le guide pour les auteurs de documents maintenu par le projet +@LaTeX{}. Bien d'autres guides écrits par bien d'autres gens sont aussi +disponibles, indépendamment du projet @LaTeX{} ; l'article suivant en +est un. + +@item http://ctan.org/pkg/lshort +@findex lshort @r{document} +Une courte (?) indoduction à @LaTeX{}, traduite en de nombreuses langues +(traduction française : @url{http://ctan.org/pkg/lshort-french}). + + +@item http://tug.org/begin.html +Introduction au système @TeX{}, y compris @LaTeX{}, et plus amples références. +@end table + + +@node Overview +@chapter Vue d'ensemble de @LaTeX{} + +Qu'est-ce que @LaTeX{}? + +@cindex aperçu de @LaTeX{} +@cindex bases de @LaTeX{} +@cindex Knuth, Donald E. +@cindex Lamport, Leslie +@cindex @LaTeX{} aperçu +@LaTeX{} est un système de composition de document. Il fut à l'origine +créé par Leslie Lamport et est desormais maintenu par un groupe de +volontaires (@url{http://latex-project.org}). Il est largement utilisé, +en particulier pour les documents complexes et techniques, tels que ceux +impliquant des mathématiques. + +@cindex paquet de macro, @LaTeX{} en tant que +Un utilisateur @LaTeX{} écrit un fichier d'entrée contenant le texte +d'un document avec des commandes qui y sont intercalées pour décrire +comment le texte doit être formaté. @LaTeX{} est mis en œuvre comme un +ensemble de commandes liées s'interfaçant avec le programme de +composition @TeX{} de Donald E. Knuth (le terme technique est que +@LaTeX{} est un @dfn{paquet de macros} pour le moteur @TeX{}). +L'utilisateur produit le document de sortie en donnant ce fichier +d'entrée au moteur @TeX{}. + +@c - Les fichiers @LaTeX{} sont des fichiers texte ordinaires qui +@c - peuvent être écrits avec n'importe quel éditeur de texte aux +@c - performances raisonnables. + +Le terme @LaTeX{} est aussi parfois utilisé pour signifier le langage à +balises dans lequel le code source du document est écrit, c.-à-d.@: pour +signifier l'ensemble des commandes à la disposition d'un utilisateur de +@LaTeX{}. + +@cindex Lamport @TeX{} +@cindex prononciation +Le nom @LaTeX{} est l'abréviation de ``Lamport @TeX{}''. On le prononce +LA-TÈQUE. Au sein du document, on produit le logo avec @code{\LaTeX}. +Là où l'utilisation du logo n'est pas raisonnable, comme dans du texte +brut, écrivez le @samp{LaTeX}. + + +@menu +* Début et fin: Starting and ending. Le début et la fin standards d'un document. +* Fichiers de sortie: Output files. Fichiers produits. +* Moteurs @TeX{}: @TeX{} engines. Programmes qui peuvent compiler du code source @TeX{} et @LaTeX{}. +* Syntaxe des commandes @LaTeX{}: @LaTeX{} command syntax. Syntaxe générale des commandes @LaTeX{}. +@end menu + +@node Starting and ending +@section Début et fin + +@anchor{Starting & ending}@c ancien nom du noeud +@cindex début et fin +@cindex fin et début +@cindex Bonjour le monde + +Les fichiers @LaTeX{} ont une structure globale simple, avec un début et +une fin standards. Voici un exemple « Bonjour le monde » : + +@example +\documentclass@{article@} +\begin@{document@} +Bonjour le monde \LaTeX. +\end@{document@} +@end example + +@cindex classe de document, définition +@noindent +Ici @samp{article} et ce qu'on appelle la @dfn{classe de document}, +implémentée dans une fichier @file{article.cls}. N'importe quelle classe +de document peut être utilisée. Quelques classes de document sont +définies par @LaTeX{} lui-même, et un grand nombre d'autres sont +largement disponibles. @xref{Document classes}. + +@cindex préambule, définition +Vous pouvez inclure d'autres commandes @LaTeX{} entre les commandes +@code{\documentclass} et @code{\begin@{document@}} (cette zone est +appelée le @dfn{préambule}). + +Le code @code{\begin@{document@} ... \end@{document@}} est ce qu'on +@cindex environnement +appelle un @dfn{environnement} ; l'environnement @samp{document} (et +aucun autre) est obligatoire dans tous les documents @LaTeX{} +(@pxref{document}). @LaTeX{} fournit lui-même beaucoup +d'environnements, et bien plus encore sont définis séparément. +@xref{Environments}. + +Les rubriques suivantes discutent de la façon de produire des PDF et +d'autres format de sortie à partir d'un fichier d'entrée @LaTeX{}. + + +@node Output files +@section Fichiers de sortie + +@LaTeX{} produit un fichier de sortie principal et au moins deux +fichiers accessoires. Le nom du fichier de sortie principal se termine +soit en @file{.dvi} soit en @file{.pdf}. + +@table @code +@item .dvi +@findex @r{fichier} .dvi +@findex @r{commande} latex +@findex @r{commande} xdvi +@findex @r{commande} dvips +@findex @r{commande} dvipdfmx +@findex @r{commande} dvitype +Si il est invoqué avec la commande système @command{latex}, alors il +produit un fichier « DeVice Independent@footnote{Indépendant du +périphérique de sortie, ce n'est toutefois pas un format portable de +document} » (@file{.dvi}). Vous pouvez visualiser ce fichier avec une +commande comme @command{xdvi}, ou le convertir en fichier PostScript +@code{.ps} avec @command{dvips} ou en fichier « Portable Document +Format@footnote{Format portable de document} » @code{.pdf} avec +@command{dvipdfmx}. Un grand nombre d'autres progammes utilitaires DVI +sont disponibles (@url{http://mirror.ctan.org/dviware}). + +@item .pdf +@findex .pdf @r{fichier} +@cindex pdf@TeX{} +@findex @r{commande} pdflatex +Si @LaTeX{} est invoqué avec la commande système @command{pdflatex}, +parmi d'autres commandes (@pxref{@TeX{} engines}), alors la sortie +principale est un fichier ``Portable Document Format'' +(@file{.pdf}). Typiquement, il s'agit d'un fichier autonome, avec toutes +les polices et images incorporées. + +@c - Cela peut être très utile, mais cela rend le fichier de sortie beaucoup +@c - plus grand que le fichier @file{.dvi} produit à partir du même document. + +@c - @findex @r{commande} lualatex +@c - @cindex Lua@TeX{} +@c - Si il est invoqué comme @command{lualatex}, un fichier @file{.pdf} est +@c - créé à l'aide du moteur Lua@TeX{} (@url{http://luatex.org}). +@c - +@c - @findex @r{commande} xelatex +@c - @cindex Xe@TeX{} +@c - Si elle est invoquée comme @command{xelatex}, un fichier @file{.pdf} est +@c - créé à l'aide du moteur Xe@TeX{} (@url{http://tug.org/xetex}). +@c - +@end table + +@c - Beaucoup d'autres variantes moins courantes de @LaTeX{} (et @TeX{}) existent, qui +@c - peuvent produire du HTML, XML, et d'autres choses. + +@LaTeX{} produit aussi au moins deux fichier supplémentaires. + +@table @code +@item .log +@cindex fichier de transcription +@cindex fichier journal +@findex @r{fichier} .log +Ce fichier de transcription, ou @dfn{fichier journal}, contient des +informations sommaires telles que la liste des paquetages chargés. Il +contient aussi des messages de diagnostic +@c - pour toutes les erreurs découvertes dans le fichier d'entrée. +et possiblement des informations supplémentaires concernant toutes +erreurs. + +@item .aux +@cindex fichier auxiliaire +@findex .aux @r{fichier} +@cindex double renvoi, résolution +@cindex renvoi en aval, résolution +@cindex renvoi, résolution +De l'information auxiliaire est utilisée par @LaTeX{} pour des choses +telles que les doubles renvois. Par exemple, la première fois que +@LaTeX{} trouve un renvoi en aval --- une double référence à +quelque-chose qui n'est pas encore apparu dans le code source --- il +apparaîtra dans la sortie comme un double point d'interrogation +@code{??}. Quand l'endroit auquel le renvoi fait référence finit par +appraître dans le code source, alors @LaTeX{} écrit son information de +localisation dans ce fichier @code{.aux}. À l'invocation suivante, +@LaTeX{} lit l'inforlation de localisation à partir de ce fichier et +l'utilise pour résoudre le renvoi, en remplaçant le double point +d'interrogation avec la localisation mémorisée. + +@end table + +@c - Une liste ouverte d'autres fichiers peut être créé. Nous n'allons pas essayer de +@c - les énumérer tous. Composants Xxx? + +@findex .lof @r{fichier} +@cindex liste des figures, fichier +@findex .lot @r{fichier} +@cindex liste des tableaux, fichier +@findex .toc @r{fichier} +@cindex table des matières, fichier +@cindex matières, fichier +@LaTeX{} peut produire encore d'autres fichiers, caractérisés par la +terminaison du nom de fichier. Ceux-ci incluent un fichier @code{.lof} +qui est utilisé pour fabriquer la liste des figures, un fichier +@code{.lot} utilisé pour fabriquer une liste des tableaux, et un fichier +@code{.toc} utilisé pour fabriquer une table des matières. Une classe +de document particulière peut en créer d'autres ; cette liste n'a pas de +fin définie. + + +@node @TeX{} engines +@section Les moteurs @TeX{} + +@cindex moteurs, @TeX{} +@cindex implémentations de @TeX{} +@cindex UTF-8 +@cindex entrée Unicode, native +@cindex polices TrueType +@cindex polices OpenType +@LaTeX{} est défini comme un ensemble de commande qui sont exécutées par +une implémentation @TeX{} (@pxref{Overview}). Cette section donne une +vue d'ensemble laconique des principaux programmes. + +@table @code +@item latex +@itemx pdflatex +@cindex pdf@TeX{}, moteur +@cindex moteur pdf@TeX{} +@findex etex, @r{commande} +@cindex e-@TeX{} +Dans @TeX{} Live (@url{http://tug.org/texlive}, si @LaTeX{} est invoqué +avec les commandes système @command{latex} ou @command{pdflatex}, alors +le moteur pdf@TeX{} est exécuté (@url{http://ctan.org/pkg/pdftex}). +Selon qu'on invoque @command{latex} ou @command{pdflatex}, la sortie +principale est respectivement un fichier @file{.dvi} ou un fichier +@file{.pdf}. + +pdf@TeX{} incorpore les extensions qu'e-@TeX{} apporte au programme +original de Knuth (@url{http://ctan.org/pkg/etex}), ce qui inclut des +caractéristiques supplémentaires de programmation et la composition +bi-directionnelle, et a lui-même de nombreuses extentions. e-@TeX{} est +lui-même disponible par la commande système @command{etex}, mais le +langage du fichier d'entrée est du @TeX{} de base (et le fichier produit +est un @file{.dvi}). + +Dans d'autres distributions @TeX{}, @command{latex} peut invoquer +e-@TeX{} plutôt que pdf@TeX{}. Dans tous les cas, on peut faire +l'hyptohèse que les extension e-@TeX{} sont disponibles en @LaTeX{}. + +@item lualatex +@findex lualatex @r{commande} +@cindex Lua@TeX{} +Si @LaTeX{} est invoqué avec la commandes systèmes @command{lualatex}, +alors le moteur Lua@TeX{} est exécuté +(@url{http://ctan.org/pkg/luatex}). Ce programme permet que du code +écrit dans le langage script Lua (@url{http://luatex.org}) intéragisse +avec la compostion faite par @TeX{}. Lua@TeX{} traite nativement +l'entrée en Unicode UTF-8, peut traiter les polices OpenType et +TrueType, et produit un fichier @file{.pdf} par défaut. Il y a aussi +@command{dvilualatex} pour produire un fichier @file{.dvi}, mais cela +est rarement utilisé. + +@item xelatex +@findex xelatex @r{commande} +@cindex Xe@TeX{} +@findex .xdv @r{fichier} +@findex xdvipdfmx +Si @LaTeX{} est invoqué avec la commandes système @command{xelatex}, le +moteur Xe@TeX{} est exécuté (@url{http://tug.org/xetex}). Comme +Lua@TeX{}, Xe@TeX{} prend en charge nativement UTF-8 Unicode et les +polices TrueType et OpenType, bien que l'implementation soit +complètement différente, utilisant principalement des bibliothèque +externe plutôt que du code interne. Xe@TeX{} produit un fichier @file{.pdf} +en sortie ; il ne prend pas en charge la sortie DVI. + +En interne, Xe@TeX{} crée un fichier @code{.xdv} file, une variante de +DVI, et traduit cela en PDF en utilisant le +programme (@code{x})@code{dvipdfmx}, mais ce processus est automatique. +Le fichier @code{.xdv} n'est utile que pour le débogage. + +@end table + +D'autres vairantes de @LaTeX{} et @TeX{} existent, par ex. pour fournir +une prise en charge supplémentaires du japonais des d'autres langages +([u]p@TeX{}, @url{http://ctan.org/pkg/ptex}, +@url{http://ctan.org/pkg/uptex}). + + +@node @LaTeX{} command syntax +@section Syntaxe des commandes @LaTeX{} + +@cindex commandes, syntaxe des +@findex \ @r{caractère de début des commandes} +@findex [...] @r{pour les arguments optionnels} +@findex @{...@} @r{pour les arguments obligatoires} +Dans le fichier d'entrée @LaTeX{}, un nom de commande commence avec une +contr'oblique, @code{\}. Le nom lui-même consiste soit en (a) une +chaîne de lettres ou (b) une unique non-lettre. + +Les noms de commandes @LaTeX{} sont sensibles à la casse de sorte que +@code{\pagebreak} diffère de @code{\Pagebreak} (ce dernier n'est pas une +commande standarde). La plupart des noms de commandes sont en bas de +casse, mais en tout cas vous devez saisir toutes les commandes dans la +même casse où elles sont définies. + +Une commande peut être suivie de zéro, un ou plus d'arguments. Ces +arguments peuvent être soit obligatoires, soit optionnels. Les +arguments obligatoires sont entre accolades, @code{@{...@}}. Les +arguments optionnels sont entre crochets, @code{[...]}. En général, +mais ce n'est pas universel, si la commande prend un argument optionnel, +il vient en premier, avant tout argument obligatoire. + +Au sein d'un argument optionnel, pour utiliser le crochet +fermant (@code{]}) cachez le au sein d'accolades, comme +dans @code{\item[crochet fermant @{]@}]}. De même, si un argument +optionnel vient en dernier, sans argument obligatoire à sa suite, alors +pour qie le premier caractère dans le texte suivant soit un crochet +ouvrant, cachez le entre accolades. + +@LaTeX{} a la convetion que certaines commandes ont une forme en a +@code{*} qui est en relation avec la forme sans le @code{*}, telles que +@code{\chapter} et @code{\chapter*}. La différence exacte de +comportement dépend de la commande. + +Ce manuel décrit toutes les options accepté et les formes en @code{*} +pour les commandes dont il traite (à l'exeption des omissions +involontaires, ou bogues de ce manuel). + +@menu +* Environnement: Environment. Zone du code source avec un comportement distinct. +* Déclaration: Declaration. Changer la valeur ou la signification d'une commande. +* \makeatletter et \makeatother: \makeatletter and \makeatother. Change la catégorie du caractère arobe. +@end menu + + +@node Environment +@subsection Les environnements + +Synopsis : + +@example +\begin@{@var{nom environnement}@} + ... +\end@{@var{nom environnement}@} +@end example + +Une zone du code source @LaTeX{}, au sein de laquelle il y a un +comportement différent. Par exemple, pour la poésie en @LaTeX{} mettez +les lignes entre @code{\begin@{verse@}} et @code{\end@{verse@}}. + +@example +\begin@{verse@} + There once was a man from Nantucket \\ + ... +\end@{verse@} +@end example + +Voir @ref{Environments} pour une liste des environnements. + +Le @var{nom environnement} au début doit s'accorder exactement avec +celui à la fin. Ceci comprend le cas où @var{nom environnement} se +termine par une étoile(@code{*}) ; l'argument à la fois de +@code{\begin} et @code{\end} doit comprendre l'étoile. + +Les environnements peuvent avoir des arguments, y compris des arguments +optionnels. L'exemple ci-dessous produit un tableau. Le premier +argument est optionnel (et implique de la table est alignée +verticalement sur sa première ligne) alors que le second argument et +obligatoire (il spécifie le format des colonnes). + +@example +\begin@{tabular@}[t]@{r|l@} + ... lignes du tableau ... +\end@{tabular@} +@end example + + +@node Declaration +@subsection Les déclarations de commandes + +Une commande qui change la valeur, ou change la signification, d'une +autre commande ou paramètre. Par exemple, la commande @code{\mainmatter} +change le réglage de la numérotation des pages en passant de numéros +romains à des numéros arabes. + +@node \makeatletter and \makeatother +@subsection @code{\makeatletter} et @code{\makeatother} + +Synopsis : + +@example +\makeatletter + ... définition de commande comprenant @@ dans leur nom .. +\makeatother +@end example + +Utilisé pour redéfinir des commandes internes de @LaTeX{}. +@code{\makeatletter} a pour effet que le caractère arobe @code{@@} ait +le code de catégorie des lettres, c.-à-d.@: 11. @code{\makeatother} +règle de code de catégorie de @code{@@} à 12, sa valeur d'origine. + +À mesure que chaque caractère est lu par @TeX{} pour @LaTeX{}, un code +de catégorie lui est assigné. On appelle aussi ce code +@cindex catcode +@cindex code de catégorie de caractère +@cindex catégorie, code de @dots{} de caractère +@dfn{catcode} pour faire court. Par exemple, la contr'oblique @code{\} +reçoit le catcode 0, qui correspond aux catactères qui commencent une +commande. Ces deux commandes altèrent le catcode assigné à @code{@@}. + +Cette altération est nécessaire parce que beaucoup des commandes de +@LaTeX{} utilisent @code{@@} dans leur nom, de sorte à empécher les +utilisateurs de définir accidentellement une commande qui remplacerait +l'une des commandes privées de @LaTeX{}. Les noms de commandes +consistent en un caractère de catégorie 0, d'ordinaire une +contr'oblique, suivi de lettres, c.-à-d.@: des caractères de +catégorie 11 (à ceci près q'un nom de commande peut aussi consister d'un +catactère de catégorie 0 suivi d'un seul symbole non-lettre). Ainsi sous +le régime par défaut de codes de catégorie, les commandes définies par +l'utilisateur ne peuvent pas contenir de @code{@@}. Mais +@code{\makeatletter} et @code{\makeatother} permettent aux utilisateurs +de définir et re-définir des commandes dont le nom comprend un +@code{@@}. + +À utiliser dans un fichier @file{.tex}, dans le préambule. Ne pas +utiliser dans des fichiers @file{.sty} ou @file{.cls} puisque les +commandes @code{\usepackage} et @code{\documentclass} règlent le code de +catégorie de l'arobe à celui d'une lettre. + +@PkgIndex{macros2e} +Pour une liste complète des macros contenant un arobe dans leur nom, +voir le document @url{http://ctan.org/pkg/macros2e}. Ces macros sont +surtout à l'intention des auteurs de classes et de paquetages. + +@c xxxx TODO : ajouter une avertissement sur cet exemple. +L'exemple ci-après est typique. Une commande +@code{\these@@nomuniversite} se trouve dans le fichier de classe de +l'utilisateur. L'utilisateur veut changer sa définition. Pour cela, il +suffit d'insérer les trois lignes suivantes dans le préambule, avant le +@code{\begin@{document@}} : + +@example +\makeatletter +\renewcommand@{\these@@nomuniversite@}@{Université Lyon III Jean Moulin@} +\makeatother +@end example + + +@menu +* \@@startsection:: Redéfinir les commandes de rubricage. +* \@@ifstar:: Définir vos propres commandes étoilées. +@end menu + + +@node \@@startsection +@subsubsection @code{\@@startsection} + +Synopsis : + +@example +\@@startsection@{@var{nom}@}@{@var{niveau}@}@{@var{retrait}@}@{@var{avant}@}@{@var{après}@}@{@var{style}@} +@end example + +Cette commande permet de redéfinir les commandes de rubricage telles que @code{\section} ou @code{\subsection}. + +Notez que le paquetage @file{titlesec} rend la manipulation du rubricage +plus facile. De plus, bien que la plupart des exigences concernant les +commandes de rubricage peuvent être remplies avec +@code{\@@startsection}, ce n'est pas le cas de toutes. Par exemple, +dans les classes @LaTeX{} standardes @code{book} et @code{report} les +commandes @code{\chapter} et @code{\report} ne sont pas construite de +cette manière. Pour fabriquer une telle commande il est possible +d'utiliser la commande @code{\secdef}. +@c xx define, and make a cross reference to, secdef. + +Techniquement, cette commande a la forme : +@example +\@@startsection@{@var{nom}@}@{@var{niveau}@}@{@var{retrait}@}@{@var{avant}@}@{@var{après}@}@{@var{style}@} + *[@var{titretdm}]@{@var{titre}@} +@end example +@noindent de sorte que faire : +@example +\renewcommand@{\section@}@{\@@startsection@{@var{nom}@}@{@var{niveau}@}@{@var{retrait}@}% + @{@var{avant}@}@{@var{après}@}@{@var{style}@}@} +@end example +@noindent redéfinit @code{\section} en gardant sa forme standarde d'appel +@code{\section*[@var{titretdm}]@{@var{titre}@}}. @xref{Sectioning} et +les exemples plus bas. + + +@table @var + +@item nom +@anchor{\@@startsection/name} Nom du compteur (qui doit être défini +séparément) utilisé pour numéroter le titre de rubrique. Ceux le plus +communément utilisés sont @code{section}, @code{subsection}, ou +@code{paragraph}. Bien que dans ces trois cas le nom du compteur soit le +même que celui de la commande elle-même, utiliser le même nom n'est pas +exigé. + +Alors @code{\the}@var{name} affiche le numéro de titre, et +@code{\}@var{name}@code{mark} sert aux en-têtes de page. + +@item niveau +@anchor{\@@startsection/level} Un entier donnant la profondeur de la +commande de rubricage, par ex.@: 0 pour @code{chapter} (ceci ne +s'applique qu'aux classes standardes @code{book} et @code{report}), 1 +pour @code{section}, 2 pour @code{subsection}, 3 pour +@code{subsubsection}, 4 pour @code{paragraph} et 5 pour +@code{subparagraph}. Dans les classes @code{book} et @code{report}, +@code{part} a pour niveau -1, alors que dans la classe @code{article}, +@code{part} a pour niveau 0. + +Si @var{niveau} est inférieur ou égal à la valeur de @code{secnumdepth} +alors les titres pour cette commande de rubricage sont numérotés. Par +ex.@: dans un @code{article}, si @code{secnumdepth} vaut 1 alors une +commande @code{\section@{Introduction@}} produira en sortie quelque +chose du genre de @code{1 Introduction} alors que +@code{\subsection@{Historique@}} produit en sortie quelque chose du +genre de @code{Historique}, sans numéro en +préfixe. @xref{Sectioning/secnumdepth}. + +Si @var{niveau} est inférieur ou égal à la valeur de @code{secnumdepth} +alors la table des matières aura un article pour cette rubrique. Par +exemple, dans un @code{article}, si @code{tocdepth} vaut 1 alors la +table des matières listera les @code{section}s, mais pas les +@code{subsection}s. + + +@item retrait +@anchor{\@@startsection/indent}Une longueur donnant le renfoncement de +toutes les lignes du titre relativement à la marge. Pour un +renfoncement nul, utilisez @code{0pt}. +@c vous pouvez utiliser la macro @code{\z@@} définie à @code{0pt} pour +@c que le code soit plus efficace +Une valeur négative telle que @code{-1em} cause un débord du titre dans +la marge. + +@item avant +@anchor{\@@startsection/beforeskip} Longueur dont la valeur absolue est +la longueur de l'espace vertical à insérer avant le titre de la +rubrique. Cet espacement est ignoré si la rubrique commence au début +d'une page. Si en plus @var{avant} est négatif, alors le premier +paragraphe suivant immédiatement le titre n'est pas renfoncé, s'il est +positif ou nul il l'est. (Notez que l'opposé de @code{1pt plus 2pt +minus 3pt} est @code{-1pt plus -2pt minus -3pt}). + +Par exemple si @var{avant} vaut @code{-3.5ex plus -1ex minus -0.2ex} +alors pour commencer la nouvelle rubrique, @LaTeX{} ajoute environ 3,5 +fois la hauteur d'une lettre x en espace veritical, et le premier +paragraphe de la rubrique n'est pas renfoncé. Utiliser une longueur +élastique, c.-à-d.@: comprenant @code{plus} et @code{minus}, est une +bonne pratique ici car cela donne à @LaTeX{} plus de latitude lors de la +fabrication de la page. + +La quantité totale d'espace vertical entre la ligne de base de la ligne +précédant le titre de cette rubrique est la ligne de base du titre est +la somme du @code{\parskip} dans la police du corps de texte, du +@code{\baselineskip} de la police du titre, et de la valeur absolue de +l'argument @var{avant}. Cet espace est typiquement élastique et peut se +dilater ou se contracter. (Si la rubrique commence en début d'une page +de sorte que cet espace soit ignoré, alors la ligne de base du titre +correspond à la ligne de base qu'aurait la première ligne de texte sur +cette page si celle-ci commençait par du texte). + +@item après +@anchor{\@@startsection/afterskip} Longueur. Lorsque elle est positive +ou nulle, il s'agit de l'espace vertical à insérer après le titre de la +rubrique. Lorsque elle est négative, alors le titre fait corps avec le +paragraphe le suivant immédiatement. Dans ce cas la valeur absolue de +la longueur donne l'espace horizontal entre la fin du titre et le début +du paragraphe suivant. (Notez que l'opposé de @code{1pt plus 2pt minus +3pt} est @code{-1pt plus -2pt minus -3pt}). + +Comme c'est le cas avec @var{avant}, utiliser une longueur élastique +avec des composantes @code{plus} et @code{minus} est une bonne pratique +ici puisque elle donne à @LaTeX{} plus de latitude pour assembler la +page. + +Si @var{après} est positif ou nul alors la quantité totale d'espace +vertical entre la ligne de base du titre de la rubrique et la ligne de +base de la première ligne du paragraphe suivant est la somme du +@code{\parskip} de la police du titre, de @code{\baselineskip} de la +police du corps de texte, et de la valeur de @var{après}. Cet espace est +typiquement élastique de sorte qu'il puisse se dilater ou se +contracter. (Notez que du fait que le signe d'@var{après} contrôle que +le titre soit indépendant du texte le suivant, ou fasse corps avec lui, +vous ne pouvez pas utiliser un @var{après} négatif pour annuler une +partie du @code{\parskip}). + +@item style +@anchor{\@@startsection/style} Contrôle le style du titre, voir les +exemples plus bas. Les commandes typiquement utilisées ici sont +@code{\centering}, @code{\raggedright}, @code{\normalfont}, +@code{\hrule}, ou @code{\newpage}. La dernière commande au sein de +@var{style} peut être une commande prenant un argument, telle que +@code{\MakeUppercase} ou @code{\fbox}. Le titre de la rubrique est passé +en argument à cette commande. Par exemple régler @var{style} à +@code{\bfseries\MakeUppercase} a pour effet de produire des titres gras +et en capitales. +@end table + +Voici des exemples. Pour les utiliser mettez les soit au sein d'un +fichier de paquetage ou de classe, ou placez les dans le préambule d'un +document @LaTeX{} entre des commandes @code{\makeatletter} et +@code{\makeatother}. (Le message d'erreur @code{You can't use +`\spacefactor' in vertical mode.} est le plus probable lorsque on +oublie de faire cela). @xref{\makeatletter and \makeatother}. + +L'exemple suivant redéfinit la commande de rubricage @code{\section} +pour qu'elle centre le titre et le mette en gras : + +@example +\renewcommand\section@{% + \@@startsection@{section@}% @ref{\@@startsection/name,@var{nom},@var{nom}}. + @{1@}% @ref{\@@startsection/level,@var{niveau},@var{niveau}}. + @{0pt@}% @ref{\@@startsection/indent,@var{retrait},@var{retrait}}. + @{-3.5ex plus -1ex minus -.2ex@}% @ref{\@@startsection/beforeskip,@var{avant},@var{avant}}. + @{2.3ex plus.2ex@}% @ref{\@@startsection/afterskip,@var{après},@var{après}}. + @{\centering\normalfont\Large\bfseries@}@}% @ref{\@@startsection/style,@var{style},@var{style}}. +@end example + +Cet exemple met les titres de @code{subsection} en petites capitales, et +leur fait faire corps avec le paragraphe suivant. + +@example +\renewcommand\subsection@{% + \@@startsection@{subsection@}% @ref{\@@startsection/name,@var{nom},@var{nom}}. + @{2@}% @ref{\@@startsection/level,@var{niveau},@var{niveau}}. + @{0em@}% @ref{\@@startsection/indent,@var{retrait},@var{retrait}}. + @{-1ex plus 0.1ex minus -0.05ex@}% @ref{\@@startsection/beforeskip,@var{avant},@var{avant}}. + @{-1em plus 0.2em@}% @ref{\@@startsection/afterskip,@var{après},@var{après}}. + @{\scshape@}% @ref{\@@startsection/style,@var{style},@var{style}}. + @} +@end example + +Les exemples précédents redéfinissait les commandes de titre de +rubriques existantes. celui-ci en définit une nouvelle, illustrant la +nécessité d'un compteur et de macros pour son affichage. + +@c From https://groups.google.com/forum/#!searchin/comp.text.tex/startsection%7Csort:relevance/comp.text.tex/sB-nTS-oL08/ZZeKYdG0llMJ +@example +\setcounter@{secnumdepth@}@{6@}% affiche les compteur justqu'à ce niveau +\newcounter@{subsubparagraph@}[subparagraph]% compteur pour la + % numérotation +\renewcommand@{\thesubsubparagraph@}% + @{\thesubparagraph.\@@arabic\c@@subsubparagraph@}% comment afficher + % la numérotation +\newcommand@{\subsubparagraph@}@{\@@startsection + @{subsubparagraph@}% + @{6@}% + @{0em@}% + @{\baselineskip@}% + @{0.5\baselineskip@}% + @{\normalfont\normalsize@}@} +\newcommand*\l@@subsubparagraph% + @{\@@dottedtocline@{6@}@{10em@}@{5em@}@}% pour la table des matières +\newcommand@{\subsubparagraphmark@}[1]@{@}% pour les en-têtes de page +@end example + + + +@node \@@ifstar +@subsubsection @code{\@@ifstar} + +@findex \@@ifstar +@cindex commandes, variantes étoilées +@cindex étoilées, variantes de commandes + + +@c Inpirée des trucs & astuces de Manuel Pégourié-Gonnard +@c (https://elzevir.fr/imj/latex/tips.html#stared) + +Vous l'avez sans doute remarqué, beaucoup d'environnements ou commandes +standards de @LaTeX{} existent sous une variante étoilée. Vous pouvez avoir +envie de reprendre cette idée quand vous définissez vos commandes et arguments. + +Si vous avez lu @ref{\newenvironment & \renewenvironment}, vous aurez compris +que c'est immédiat pour les environnements car l'étoile est un caractère +autorisé dans les noms d'environnements. Il vous suffit donc de faire +@code{\newenvironment@{@var{monenv}@}} et +@code{\newenvironment@{@var{monenv}*@}} avec les définitions souhaitées. + +Pour les commandes, c'est plus compliqué car l'étoile ne peut pas faire partie +du nom de la commande. Il y aura donc une première commande, qui devra être +capable de regarder si elle est ou non suivie d'une étoile et d'adapter son +comportement en conséquence. Cette première commande ne pourra pas accepter +d'argument, mais pourra faire appel à des commandes qui en acceptent. Par +ailleurs, on utilise la commande @code{\@@ifstar} interne du noyau @LaTeX{} et +vous pouvez vous reportez à « @ref{\makeatletter and \makeatother} » pour +comprendre pourquoi cela implique l'usage d'un bloc +@code{\makeatletter...\makeatother}. + +Dans cet exemple, on définit @code{\ciel} comme une commande avec un +argument obligatoire et admettant une variante étoilée @code{\ciel*} +également avec un argument obligatoire : + +@example +\makeatletter +\newcommand*\ciel@@starred[1]@{ciel #1 étoilé@} +\newcommand*\ciel@@unstarred[1]@{ciel #1 non étoilé@} +\newcommand\ciel@{\@@ifstar@{\ciel@@starred@}@{\ciel@@unstarred@}@} +\makeatother +@end example + +@noindent ainsi, @code{\ciel@{bleu@}} composera « ciel bleu non étoilé » tandis que +@code{\ciel*@{nocturne@}} composera « ciel nocturne étoilé ». + +Notez que les commandes intermédiaires @code{\ciel@@starred} et +@code{\ciel@@unstarred} comportent un @code{@@} dans leur nom ce qui est +possible puisque elles apparaissent au sein d'un bloc +@code{\makeatletter...\makeatother}. Ceci assure qu'elles ne puissent pas être +utilisées directement dans le document. L'utilisation de @@ dans le nom +comporte certes un risque de collision avec une commande interne du noyeau +@LaTeX{}, mais une telle collision est facile à détecter et corriger car +@code{\newcommand*@{\@var{cmd}@}} vérifie que si la commande @code{\@var{cmd}} +n'est pas déjà définie et génère une erreur si c'est le cas. + +Voici un autre exemple où la commande @code{\agentsecret} comporte deux +arguments et sa variante étoilée @code{\agentsecret*} un seul : + +@example +\makeatletter +\newcommand*\agentsecret@@starred[1]@{\textsc@{#1@}@} +\newcommand*\agentsecret@@unstarred[2]@{\textit@{#1@} \textsc@{#2@}@} +\newcommand\agentsecret@{\@@ifstar@{\agentsecret@@starred@}@{\agentsecret@@unstarred@}@} +\makeatother +@end example + +@noindent Avec cette définition la célèbre réplique de l'agent 007 : + +@example +Je m'appelle \agentsecret*@{Bond@}, \agentsecret@{James@}@{Bond@}. +@end example + +@noindent est équivalente à : + +@example +Je m'appelle \textsc@{Bond@}, \textit@{James@} textsc@{Bond@}. +@end example + +Un dernier mot : contrairement aux noms d'environnement où l'étoile fait partie +du nom lui-même, et pourrait donc être à n'importe quelle position, dans le nom +d'une commande l'étoile est comme une sorte d'argument optionnel. D'un point de +vue purement @TeX{}nique il est donc possible de mettre un nombre indéfini +d'espaces entre la commande et l'étoile. Ainsi @code{\agentsecret*@{Bond@}} et +@code{\agentsecret *@{Bond@}} sont équivalents. Toutefois la pratique commune +est de ne jamais insérer de tels espaces. + +@node Document classes +@chapter Classes de documents + +@cindex classes de documents +@findex \documentclass + +La classe d'un document donné est définie avec la commande: + +@example +\documentclass[@var{options}]@{@var{classe}@} +@end example + +@noindent +La commande @code{\documentclass} doit être la première commande dans un +fichier source @LaTeX{}. + +@findex @r{classe} article +@findex @r{classe} report +@findex @r{classe} book +@findex @r{classe} letter +@findex @r{classe} slides +Les noms de @var{classe} @LaTeX{} encastrés sont (beaucoup d'autres +classes de documents sont disponibles en modules ; @pxref{Overview}): + +@example +article report book letter slides +@end example + +@c xx décrire brièvement chacun + +Les @var{options} standardes sont décrites ci-dessous. + +@menu +* Options de classe de document: Document class options. Options globales +* Ajout de paquetage: Additional packages. Ajouter des paquetages. +* Construction d'extension (classe ou paquetage): Class and package construction. Créer des + nouvelles extensions (classe ou paquetage). +@end menu + +@node Document class options +@section Options de classe de document + +@cindex options de classe de document +@cindex options, classe de document +@cindex options de classe +@cindex options globales + +Vous pouvez spécifier ce qu'on appelle des @dfn{d'options globales} ou +des @dfn{des options de classe} en les passant entre crochet à la +commande @code{\documentclass}, comme d'habitude. Pour spécifier plus +d'une @var{option}, séparez les par une virgule : + +@example +\documentclass [@var{option1}, @var{option2}, ...]@{@var{classe}@} +@end example + +Voici la liste des options standardes de classe. + +@findex @r{option} 10pt +@findex @r{option} 11pt +@findex @r{option} 12pt +Toutes les classes standardes, sauf @code{slides} acceptent les options +suivantes pour sélectionner la taille de police de caractères (l'option +par défaut est @code{10pt}): + +@example +12pt 11pt 10pt +@end example + +@findex @r{option} a4paper +@findex @r{option} a5paper +@findex @r{option} b5paper +@findex @r{option} executivepaper +@findex @r{option} legalpaper +@findex @r{option} letterpaper +Toutes les classes standardes acceptent ces options de sélection de la +taille du papier (ci-après hauteur sur largeur) : + +@table @code +@item a4paper +210 sur 297@dmn{mm} (environ 8,25 sur 11,75 pouces) + +@item a5paper +148 sur 210@dmn{mm} (environ 5,8 sur 8,3 pouces) + +@item b5paper +176 sur 250@dmn{mm} (environ 6,9 sur 9,8 pouces) + +@item executivepaper +7,25 sur 10,5 pouces + +@item legalpaper +8,5 sur 14 pouces + +@item letterpaper +8,5 sur 11 pouces (l'option par défaut) +@end table + +@findex \pdfpagewidth +@findex \pdfpageheight +@PkgIndex{geometry} Lorsque on utilise l'un des moteurs pdf@LaTeX{}, +Lua@LaTeX{}, ou Xe@LaTeX{} (@pxref{@TeX{} engines}), les options autres +que @code{letterpaper} règlent la zone d'impression mais vous devez +également régler la taille du papier physique. Un méthode pour faire +cela est de placer @code{\pdfpagewidth=\paperwidth} et +@code{\pdfpageheight=\paperheight} dans le préambule de votre document. +Le paquetage @code{geometry} fournit des méthodes flexibles pour régler +la zone d'impression et la taille du papier physique. + +@findex @r{option} draft +@findex @r{option} final +@findex @r{option} fleqn +@findex @r{option} landscape +@findex @r{option} leqno +@findex @r{option} openbib +@findex @r{option} titlepage +@findex @r{option} notitlepage +Diverses autres options: + +@table @code +@item draft, final +@cindex boîtes noires, en omettant +Pour marquer/ne marquer pas les boîtes trop pleines avec une grande +boîte noire ; l'option par défaut est @code{final}. +@item fleqn +Pour aligner à gauches les formules hors texte ; par défaut elles sont centrées. +@item landscape +Pour sélectionner le format de page à l'italienne ; l'option par défaut +est à la française. +@item leqno +Pour Mettre les numéros d'équation sur le côté gauche des +équations ; par défaut ils sont sur le côté droit. +@item openbib +Pour utiliser le format bibliographie ``openbib''. +@item titlepage, notitlepage +Indique si la page de titre est séparée ; l'option par défaut +dépend de la classe. +@end table + +Ces options ne sont pas disponibles avec la classe @code{slides} : + +@findex @r{option} onecolumn +@findex @r{option} twocolumn +@findex @r{option} oneside +@findex @r{option} twoside +@findex @r{option} openright +@findex @r{option} openany +@table @code +@item onecolumn +@itemx twocolumn +Composer en une ou deux colonnes ; le défaut est @code{onecolumn}. + +@item oneside +@itemx twoside +@findex \evensidemargin +@findex \oddsidemargin +Sélectionne la disposition en recto simple ou recto-verso ; le défaut +est @code{oneside} pour recto, sauf pour la classe @code{book}. + +Le paramètre @code{\evensidemargin} (@code{\oddsidemargin}) détermine la +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-verso sélectionnée. Pour une impression en recto le texte est +centré, pour recto-verso, @code{\oddsidemargin} vaut 40% de la +différence entre @code{\paperWidth} et @code{\textwidth}, +@code{\evensidemargin} valant le reste. + +@item openright +@itemx openany +Détermine si un chapitre doit commencer sur une page de droite ; défaut +est @code{openright} pour la classe @code{book}. +@end table + +La classe @code{slide} offre l'option @code{clock} pour l'impression du +temps au bas de chaque note. + + +@node Additional packages +@section Ajout de paquetages + +@cindex paquetages, le chargement +@cindex chargement des paquetages supplémentaires +@findex \usepackage +Les paquetages ajoutés @var{paquo} sont chargés comme ceci : + +@example +\usepackage[@var{options}]@{@var{paquo}@} +@end example + +Pour spécifier plus d'un paquetage, vous pouvez les séparer par une +virgule comme dans @code{\usepackage@{@var{paquo1},@var{paquo2},...@}}, +ou utiliser plusieurs commandes @code{\usepackage}. + +@cindex options globales +@cindex globales, options +Toutes les options indiquées dans la commande @code{\documentclass} qui +sont inconnues de la classe de document sélectionnée sont transmises aux +paquetages chargés par @code{\usepackage}. + + +@node Class and package construction +@section Construction des extensions (classes et paquetages) + +@cindex commandes des classes de document +@cindex classe de document, commandes +@cindex nouvelles classes, commandes + +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'une en-tête standarde pour chaque page, alors vous +pourriez créer une nouvelle classe @code{cmsnote.cls} et commencer vos +documents par @code{\documentclass@{cmsnote@}}. + +Ce qui distingue un paquetage d'une classe de document c'est que les +commandes d'une paquatage sont utilisables pour différentes classes +alors que celles dans une classes de document sont spécifiques à cette +classes. Ainsi, une commande qui permet de régler les en-têtes de pages +irait dans un paquetage alors qu'une commande intitulant en-têtes de +pages par @code{Note du service de mathématique de la CMS} irait dans +une classe. +@cindex classe et paquetage, différence +@cindex différence entre classe et paquetage + +Au sein d'un fichier classe pour paquetate on peu utiliser l'arobe +@code{@@} comme un caractère dans les noms de commande sans avoir à +entourer le code contenant la commande en question par +@code{\makeatletter} et @code{\makeatother}. @xref{\makeatletter and +\makeatother}. Ceci permet de créer des commandes que les utilisateurs +ne risquent pas de redéfinir accidentellement. Une autre technique est +de préfixer les commandes spécifiques à une classe ou paquetage avec une +chaîne particulière, de sorte à empêcher votre classe ou paquetage +d'interférer avec d'autres. Par exemple, la classe @code{notecms} +pourrait avoir des commandes @code{\cms@@tolist}, @code{\cms@@fromlist}, +etc. + + +@menu +* Structure d'une extension: Class and package structure. Disposition du fichier. +* Commande pour extensions: Class and package commands. Liste des commandes. +@end menu + + +@node Class and package structure +@subsection Structure d'une extension (classe ou paquetage) + +@cindex classe et paquetage, structure +@cindex extension, structure +@cindex classe, disposition du fichier +@cindex paquetage, disposition du fichier +@cindex options pour classe de document +@cindex options pour paquetage +@cindex classe, options +@cindex paquetage, options + +Un fichier de classe pour paquetage comprend typiquement quatre parties. +@enumerate +@item +Dans la @dfn{partie d'identification} le fichier dit s'il s'agit d'un +paquetage ou d'une classe @LaTeX{} et s'auto-décrit, en utilisant les +commandes @code{\NeedsTeXFormat} et @code{\ProvidesClass} ou +@code{\ProvidesPackage}. +@item +La partie des @dfn{déclarations préliminaires} déclare des commandes et +peut aussi charger d'autres fichiers. D'ordinaire ces commandes sont +celles nécessaires au code utilisé dans la partie suivante. Par exemple, +une classe @code{notecms} 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 +@code{\documentclass[destinataires-math]@{notecms@}}, et donc on a +besoin de définir une commande +@code{\newcommand@{\defdestinataires@}[1]@{\def\@@liste@@destinataires@{#1@}@}} +à utiliser dans ce fichier. +@item +Dans la partie de @dfn{gestion des options} la classes ou le +paquetage déclare et traite ses options. Les options de classes +permette à l'utilisateur de commencer leur document comme dans +@code{\documentclass[@var{liste d'options}]@{@var{nom de la classe}@}}, +pour modifier le comportement de la classe. Un exemple est lorsque on +déclare @code{\documentclass[11pt]@{article@}} pour régler la taille par +défaut de la police du document. +@item +Finalement, dans la partie des @dfn{déclarations supplémentaires} la +classe ou le paquetage effectue la plus grosse partie de son travail : +déclarant de nouvelles variables, commandes ou polices, et chargeant +d'autres fichiers. +@end enumerate + +Voici le commencement d'un fichier de classe, ce qui doit être +sauvegardé comme @file{souche.cls} à un emplacement où @LaTeX{} peut le +trouver, par exemple dans le même répertoire que le fichier @file{.tex}. + +@example +\NeedsTeXFormat@{LaTeX2e@} +\ProvidesClass@{souche@}[2017/07/06 souche à partir de laquelle contruire des classes] +\DeclareOption*@{\PassOptionsToClass@{\CurrentOption@}@{article@}@} +\ProcessOptions\relax +\LoadClass@{article@} +@end example +@cindex classe, fichier d'exemple + +Elle s'auto-identifie, traite les options de classe par défaut en les +passant toutes à la classe @code{article}, et puis charge la classe +@code{article} de sorte à fournir la base du code de cette classe. + +Pour plus d'information, voir le guide officiel pour les auteurs de +classes et de paquetage, le « Class Guide », +@url{http://www.latex-project.org/help/documentation/clsguide.pdf} (la +plupart des descriptions faites ici s'inspirent de ce document), ou +l'article suivant @url{https://www.tug.org/TUGboat/tb26-3/tb84heff.pdf} +illutrant la construction d'une nouvelle classe. + +@node Class and package commands +@subsection Commande pour extension (classe ou paquetage) +@cindex classe et paquetage, commandes +@cindex commandes pour classe ou paquetage + +Voici les commandes conçues pour aider les auteurs d'extension (classes +ou paquetages). + +@table @code +@item \AtBeginDvi@{specials@} +@findex \AtBeginDvi +Sauvegarde dans une registre de boîte des choses qui sont à écrire dans +le fichier @file{.dvi} au début de l'achèvement de la première page du + +document. + +@item \AtEndOfClass@{@var{code}@} +@item \AtEndOfPackage@{@var{code}@} +@findex \AtEndOfClass +@findex \AtEndOfPackage +Crochet pour inséer le @var{code} à exécuter lorsque @LaTeX{} termine le +traiement de la classe ou du paquetage courants. On peut utiliser ces +crochet plusieurs fois ; le @code{code} sera exécuté dans l'ordre +d'appel. Voir aussi @ref{\AtBeginDocument}. + +@item \CheckCommand@{@var{cmd}@}[@var{num}][@var{défaut}]@{@var{définition}@} +@item \CheckCommand*@{@var{cmd}@}[@var{num}][@var{défaut}]@{@var{définition}@} +@findex \CheckCommand +@findex \CheckCommand* +@cindex nouvelle commande, vérification +Similaire à @code{\newcommand} (@pxref{\newcommand & \renewcommand}) +mais ne définit pas @var{cmd} ; à la place vérifie que la définition +actuelle de @var{cmd} est exactement celle donnée par @var{définition} +et est ou n'est pas @dfn{longue} selon ce que l'on attend. +@cindex commande longue +Une commande est dite longue lorsque elle accepte @code{\par} au sein +d'un argument. On attend que la commande @var{cmd} soit longue avec la +version non-étoilée de @code{\CheckCommand}. Lève une erreur en cas +d'échec de la vérification. Ceci vous permet de vérifier avant de +redéfinir vous-même @var{cmd} qu'aucun paquetage ne l'a pas déjà fait. + +@item \ClassError@{@var{nom de la classe}@}@{@var{texte de l'erreur}@}@{@var{texte d'aide}@} +@item \PackageError@{@var{nom du paquetage}@}@{@var{texte de l'erreur}@}@{@var{texte d'aide}@} +@item \ClassWarning@{@var{nom de la classe}@}@{@var{warning text}@} +@item \PackageWarning@{@var{nom du paquetage}@}@{@var{warning text}@} +@item \ClassWarningNoLine@{@var{nom de la classe}@}@{@var{warning text}@} +@item \PackageWarningNoLine@{@var{nom du paquetage}@}@{@var{warning text}@} +@item \ClassInfo@{@var{nom de la classe}@}@{@var{info text}@} +@item \PackageInfo@{@var{nom du paquetage}@}@{@var{info text}@} +@item \ClassInfoNoLine@{@var{nom de la classe}@}@{@var{info text}@} +@item \PackageInfoNoLine@{@var{nom du paquetage}@}@{@var{info text}@} +@findex \ClassError +@findex \PackageError +@findex \ClassWarning +@findex \PackageWarning +@findex \ClassWarningNoLine +@findex \PackageWarningNoLine +@findex \ClassInfo +@findex \PackageInfo +@findex \ClassInfoNoLine +@findex \PackageInfoNoLine +Porduit un message d'erreur, ou des messages d'avertissement ou +d'information. + +Pour @code{\ClassError} et @code{\PackageError} le message est +@var{texte de l'erreur}, suivi de l'invite d'erreur @code{?} de +@TeX{}. Si l'utilisateur demande de l'aide en tapant +@code{h}, il voit le @var{texte d'aide}. + +The four warning commands are similar except that they write +@var{warning text} on the screen with no error prompt. The four info +commands write @var{info text} only in the transcript file. The +@code{NoLine} versions do not show the number of the line generating the +message, while the other versions do show that number. + +Pour formatter les messages, y compris le @var{texte d'aide} : utilisez +@code{\protect} pour empêcher une commande de se sévelopper, obtenez un +saut de ligne avec @code{\MessageBreak}, et obtenez une espace avec +@code{\space} lorsque l'utilisation d'un caractère espace ne le permet +pas, comme après une commande. Notez que @LaTeX{} ajoute un point final +à chaque message. + +@item \CurrentOption +@findex \CurrentOption +Se développe au contenu de l'option en cours de traitement. Peut +uniquement être utilisé au sein de l'argument @var{code} soit de +@code{\DeclareOption}, soit de @code{\DeclareOption*}. + +@item \DeclareOption@{@var{option}@}@{@var{code}@} +@item \DeclareOption*@{@var{option}@}@{@var{code}@} +@findex \DeclareOption +@findex \DeclareOption* +@cindex class options +@cindex package options +@cindex options, class +@cindex options, package +Rend un option @var{option} disponible pour l'utilisateur, de sorte à ce +qu'il puisse la passer à leur commande @code{\documentclass}. Par +exemple, la classe @code{notecms} pourrait avoir une option @code{logo} +pour mettre le logo de leur organisation sur la première page avec +@code{\documentclass[logo]@{notcms@}}. Le fichier de classe doit +contenir @code{\DeclareOption@{logo@}@{@var{code}@}} (et plus loin, +@code{\ProcessOptions}). + +Si vous invoquez une option qui n'a pas été déclarée, par défaut cela +produit une avertissement semblable à @code{Unused global option(s): +[badoption].} Vous pouvez changer ce comportement avec la version +étoilée @code{\DeclareOption*@{@var{code}@}}. Par exemple, beaucoup de +classeq étendent une classe existante en utilisant une déclaration du +genre @code{\LoadClass@{article@}}, et pour passer les options +suppémentaires à la classe sous-jascente utilisent un code tel que +celui-ci : + +@example +\DeclareOption*@{% +\PassOptionsToClass@{\CurrentOption@}@{article@}% +@} +@end example + +Un autre exemple est que la classes @code{notecms} permette aux +utilisateur de tenir des listes de destinataire des notes dans des +fichier externes. Par exemple l'utilisateur invoque +@code{\documentclass[math]@{notecms@}} et la classe lit le fichier +@code{math.memo}. Ce code gère le fichier s'il existe et sinon passe +l'option à la classe @code{article}. + +@example +\DeclareOption*@{\InputIfFileExists@{\CurrentOption.memo@}@{@}@{% + \PassOptionsToClass@{\CurrentOption@}@{article@}@}@} +@end example + +@item \DeclareRobustCommand@{@var{cmd}@}[@var{num}][@var{défaut}]@{@var{définition}@} +@item \DeclareRobustCommand*@{@var{cmd}@}[@var{num}][@var{défaut}]@{@var{définition}@} +@findex \DeclareRobustCommand +@findex \DeclareRobustCommand* +@cindex nouvelle commande, définition +Similaire à @code{\newcommand} et @code{\newcommand*} +(@pxref{\newcommand & \renewcommand}) mais déclare une commande robuste, +même si @var{définition} comprend du code fragile. (Pour une discussion +sur les commandes robustes et fragiles @pxref{\protect}). Utilisez ces +commande pour définir de nouvelles commandes robustes, ou redéfinir des +commandes existantes en les rendant robustes. Contrairement à +@code{\newcommand} elle ne produisent pas d'ereru si la macro @var{cmd} +existe déjà ; au lieu de cela un message est écrit dans le fichier +journal pour indiquer la redéfinition de la commande. + +Les commandes définies de cette manière sont légèrement moins efficace +que celle définies avec @code{\newcommand}, c'est pourquoi, à moins que +le contenu de la commande soit fragile et que la commande soit utilisée +au sein d'un argument mouvant, utilisez @code{\newcommand}. + +@PkgIndex{etoolbox} Le paquetage @code{etoolbox} offre les commandes +@code{\newrobustcmd}, @code{\newrobustcmd*}, @code{\renewrobustcmd}, +@code{\renewrobustcmd*}, @code{\providerobustcmd}, et +@code{\providrobustcmd*} qui sont similaire aux commandes standardes +@code{\newcommand}, @code{\newcommand*}, @code{\renewcommand}, +@code{\renewcommand*}, @code{\providecommand}, et +@code{\providcommand*}, mais définissent une commande @var{cmd} robuste +avec deux advanges par rapport à @code{\DeclareRobustCommand} : +@enumerate +@item +Elle utilisent un mécanisme de protection de bas niveau d'e-@TeX{} au +lieu du mécanisme de plus au niveau de @LaTeX{} utilisant +@code{\protect}, ainsi elles ne subissent pas la légère perte de +performance mentionnée plus haut, et +@item +Elles font la même distinction entre @code{\new@dots{}}, +@code{\renew@dots{}}, et @code{\provide@dots{}} que les commandes +standardes, ainsi elle ne font pas qu'envoyer un message dans le journal +lorsque vous redéfinissez @var{cmd} déjà existantes, dans ce cas vous +devez utiliser soit @code{\renew@dots{}} soit @code{\provide@dots{}} ou il +y a une erreur. +@end enumerate + +@item \IfFileExists@{@var{nom fichier}@}@{@var{si vrai}@}@{@var{si faux}@} +@item \InputIfFileExists@{@var{nom fichier}@}@{@var{si vrai}@}@{@var{si faux}@} +@findex \IfFileExists +@findex \InputIfFileExists +Exécute @var{si vrai} sf @LaTeX{} peut trouver le fichier @file{@var{nom +fichier}} et @var{si faux} sinon. Dans le second cas, le fichier est lu +immédiatement aprus exécuter @var{si vrai}. Ainsi +@code{\IfFileExists@{img.pdf@}@{\includegraphics@{img.pdf@}@}@{\typeout@{AVERSTISSEMENT +: img.pdf introuvable@}@}} n'inclut le graphique @file{img.pdf} que s'il +est trouvé, mais autrement produit seulement un avertissement. + +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 @code{\IfFileExists@{./@var{nom fichier}@}@{@var{si +vrai}@}@{@var{si faux}@}}. Si vous demandez un fichier dont le nom n'a +pas d'extension @code{.tex} alors @LaTeX{} commencera par chercher le +fichier en apposant @code{.tex} à son nom ; pour plus ample information +sur la façon dont @LaTeX{} gère les extensions de nom de fichier voir +@ref{\input}. + +@item \LoadClass[@var{liste d'options}]@{@var{nom de la classe}@}[@var{date de parution}] +@item \LoadClassWithOptions@{@var{nom de la classe}@}[@var{date de parution}] +@findex \LoadClass +@findex \LoadClassWithOptions +Charge une classe, comme avec @code{\documentclass[@var{options +list}]@{@var{nom de la classe}@}[@var{release info}]}. Voici un exemple : +@code{\LoadClass[twoside]@{article@}}. + +La @var{liste d'options}, si présente, est une liste ponctuée par des +virgules. La @var{date de parution} est optionnel. Si elle est +présente, elle doit avoir le format @var{AAA/MM/JJ}. Si vous demandez +une @var{date de parution} et que la date du paquetage installée sur +votre sysème est antérieure, alors vous obtiendrez un avertissement à +l'écrant et dans le journal de compilation du genre de @code{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.} + +La variante de la commande @code{\LoadClassWithOptions} utilise la liste +des options de la classe courante. Cela veut dire qu'elle ignore toute +options passée via @code{\PassOptionsToClass}. Ceci est une commande de +commodité qui vous permet de construire une nouvelle classe en +l'héritant d'une classe existante, telle que la classe standarde +@code{article}, sans avoir à gérer les options qui furent passée. + +@item \ExecuteOptions@{@var{liste d'options}@} +@findex \ExecuteOptions +Pour chaque option @var{option} de la @var{liste d'options}, dans +l'ordre d'apparition, cette commande exécute la commande +@code{\ds@@@var{option}}. Si cette commande n'est pas définie, alors +l'option @var{option} est ignorée. + +Ceci peut être utilisé pour fournir d'un liste d'option par défaut avant +le @code{\ProcessOptions}. 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 @code{\ExecuteOptions@{11pt@}\ProcessOptions\relax}. + +@item \NeedsTeXFormat@{@var{format}@}[@var{date du format}] +@findex \NeedsTeXFormat +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 : +@code{\NeedsTeXFormat@{LaTeX2e@}}. Lorsque un document utilisant cette +classe est traité, le nom du format donné ici doit s'accorder avec le +format qui est en cours d'exécution (y compris le fait que la chaîne +@var{format} est sensible à la casse). Si il ne s'y accorde pas alors +l'exécution est interrompue par une erruer du genre de @samp{This file +needs format `LaTeX2e' but this is `xxx'.} + +Pour spécifier une version du format dont vous savez qu'elle prend en +charge certaines fonctions, incluez l'argument optionnel @var{date du +format} correspondant au format où ces fonction furent implémentés. Si +cette argument est présent il doit être de la forme @code{AAAA/MM/JJ}. +Si la version de format installée sur votre système est antérieur à la +@var{date du format} alors vous obtiendrez un avertissement du genre de +@samp{You have requested release `2038/01/20' of LaTeX, but only release +`2016/02/01' is available.} + +@item \OptionNotUsed +@findex \OptionNotUsed +Ajoute l'option courante à la liste des options non utilisées. Ne peut +être utilisé qu'au sein de l'argument @var{code} de +@code{\DeclareOption} ou @code{\DeclareOption*}. + +@c I cannot reproduce this behavior as it is documented in clsguide. +@c In the absence of a @code{\DeclareOption*} declaration, @LaTeX{} issues +@c on the console a warning like @code{LaTeX Warning: Unused global +@c option(s): [unusedoption].} with the list of not-used options when it +@c reaches @code{\begin@{document@}}. + +@item \PassOptionsToClass@{@var{liste d'options}@}@{@var{nom de la classe}@} +@item \PassOptionsToPackage@{@var{liste d'options}@}@{@var{nom du paquetage}@} +@findex \PassOptionsToClass +@findex \PassOptionsToPackage +Ajoute les options de la liste ponctuée par des virgules @var{option +list} aux options utilisée par toute commande ultérieure +@code{\RequirePackage} ou @code{\usepackage} pour le paquetage +@var{nom du paquetage} ou la classe @var{nom de la classe}. + +La raison d'ê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'au premier +chargement. Charger un paquetage avec des options plus d'une fois +produit une erreur du genre de @code{Option clash for package toto.} +(@LaTeX{} lance l'erreur même s'il n'y a pas de conflit entre les +options.) + +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 +@code{\RequirePackage[landscape]@{geometry@}\RequirePackage[margins=1in]@{geometry@}} +par un seul @code{\RequirePackage[landscape,margins=1in]@{geometry@}}. +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 @code{toto} +charge le paquetage @code{geometry}. Au lieu de +@code{\RequirePackage@{toto@}\RequirePackage[draft]@{graphics@}} vous +devez écrire @code{\PassOptionsToPackage@{draft@}@{graphics@} +\RequirePackage@{toto@}}. (Si @code{toto.sty} charge une option en +conflit avec ce que vous désirez alors vous devrez considérer une +modification de son code source.) + +Ces commandes sont également utiles aux utilisateurs de base et pas +seulement aux auteurs de classes et paquetage. Par exemple, supposons +qu'un utilisateur veuille cherge le paquetage @code{graphicx} avec +l'option @code{draft} et veuille également utiliser une classe +@code{toto} qui charge le paquetage @code{graphicx}, mais sans cette +option. L'utilisateur peut commencer son fichier @LaTeX{} avec +@code{\PassOptionsToPackage@{draft@}@{graphicx@}\documentclass@{toto@}}. + +@item \ProcessOptions +@item \ProcessOptions*@var{\@@options} +@findex \ProcessOptions +@findex \ProcessOptions* +Exécute le code associé à chaque option que l'utilisateur a invoquée. À +include dans le fichier classe sous la forme +@code{\ProcessOptions\relax} (à cause de l'existance de la variant +étoilée de la commande). + +Les options tombent dans deux catégories. Les @dfn{options locales} +sont spécifiées pour un paquetage particulier au sein de l'argument +@var{options} dans @code{\PassOptionsToPackage@{@var{options}@}}, +@code{\usepackage[@var{options}]}, ou +@code{\RequirePackage[@var{options}]}. Les @dfn{options globales} sont +celles données par l'utilisateur de la classe dans +@code{\documentclass[@var{options}]}. (Si une option est spécifiée à la +fois localement et globalement, alors elle est locale). + +Lorsque @code{\ProcessOptions} est appelé pour un paquetage +@file{pkg.sty}, il se produit ce qui suit : +@enumerate +@item +Pour chaque option @var{option} déclarée jusqu'à ce point avec +@code{\DeclareOption}, @LaTeX{} examine si cette option est soit globale +soit locale pour @code{pkg}. Si c'est le cas, il exécute le code +déclaré. Ceci est fait dans l'ordre de passage de ces options à +@file{pkg.sty}. +@item +Pour chaque option locale restante, il exécute la commande +@code{\ds@@@var{option}} si elle a été défini quelque-part (autrement +que par un @code{\DeclareOption}) ; sinon, il exécute le code de +traitement par défaut des options donné dans @code{\DeclareOption*}. Si +aucun code de traitement par défaut n'a été déclaré, il produit un +message d'erreur. Ceci est fait dans l'ordre dans lequel ces options ont +été spécifiées. +@end enumerate + +Lorsque @code{\ProcessOptions} 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 @code{\DeclareOption*} et +@code{\OptionNotUsed} plutôt qu'une erreur. + +La version étoilée @code{\ProcessOptions*} exécute le traitement des +options dans l'ordre spécifié par les commandes appelante, plutôt que +dans l'ordre de déclaration de la classe ou du paquetage. Pour un +paquetage, ceci signifie que les options globales sont traitées en +premier. + + +@item \ProvidesClass@{@var{nom de la classe}@}[@var{date de parution} @var{brève information supplémentaire}] +@item \ProvidesClass@{@var{nom de la classe}@}[@var{date de parution}] +@item \ProvidesPackage@{@var{nom du paquetage}@}[@var{date de parution} @var{brève information supplémentaire}] +@item \ProvidesPackage@{@var{nom du paquetage}@}[@var{date de parution}] +@findex \ProvidesClass +@findex \ProvidesPackage +Indentifie la classe ou le paquetage, en tapant un message sur la +console et dans le fichier journal. + +Lorsqu'un utilisateur écrit @code{\documentclass@{notecms@}} alors +@LaTeX{} charge le fichier @file{notecms.cls}. De même, un utilisateur +écrivant @code{\usepackage@{essai@}} invite @LaTeX{} à charger le +fichier @file{essai.sty}. Si le nom du fichier ne s'accorde pas à +l'argument @var{nom de la classe} ou @var{nom du paquetage} alors un +avertissement est produit. Ainsi, si vous invoquez +@code{\documentclass@{notecms@}}, et que le fichier the file +@file{notecms.cls} comprend la déclaration statement +@code{\ProvidesClass@{xxx@}} alors vous obtiendrez un avertissement du +genre de like @code{You have requested document class `notecms', but the +document class provides 'xxx'.} Cet avertissement n'empèche pas +@LaTeX{} de traiter le reste du fichier de la classe normalement. + +Si vous incluez l'argument optionnel, alors vous devez inclure la date, +avant le premier espace s'il y en a, et elle doit avoir le format +@code{AAAA/MM/JJ}. Le reste de l'argument est en format libre, +toutefois il identifie traditionnellement la classe, et est écrit +pendant la compilation à l'écran et dans le journal. Ainsi, si votre +fichier @file{notecms.cls} contient la ligne +@code{\ProvidesClass@{smcmem@}[2008/06/01 v1.0 Classe note CMS]} la +première ligne de votre docment est @code{\documentclass@{notecms@}} +alors vous pourrez voir @code{Document Class: notecms 2008/06/01 v1.0 +Classe note CMS}. + +La date dans l'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 à @var{date de +parution}, en utilisant les arguments optionnels comme dans +@code{\documentclass@{smcmem@}[2018/10/12]} ou +@code{\usepackage@{toto@}[[2017/07/07]]}. (Notez que les utilisateurs +de paquetages incluent seulement rarement une date, et les utilisateurs +de classe presque jamais). + +@item \ProvidesFile@{@var{nom fichier}@}[@var{information supplémentaire}] +@findex \ProvidesFile +Déclare un fihcier autre que les fichiers principaux de classe ou de +paquetage, tel qu'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 @code{File: +essai.config 2017/10/12 fichier de configuration pour essai.cls} lorsque +@var{nom fichier} vaut @samp{essai.config} et que @var{information +supplémentaire} vaut @samp{2017/10/12 fichier de configuration pour +essai.cls}. + +@item \RequirePackage[@var{liste d'options}]@{@var{nom du paquetage}@}[@var{date de parution}] +@item \RequirePackageWithOptions@{@var{nom du paquetage}@}[@var{date de parution}] +@findex \RequirePackage +@findex \RequirePackageWithOptions +Charge un paquetage, comme la commande @code{\usepackage} pour les +auteurs de documents. @xref{Additional packages}. Voici un exemple : +@code{\RequirePackage[landscape,margin=1in]@{geometry@}}. Notez que +l'équipe de développement de @LaTeX{} recommande fortement l'utilisation +de ces commande de préférence à l'@code{\input} de Plain@tie{}@TeX{} ; +voir le « Class Guide ». + +La @var{liste d'options}, si présente, est une liste ponctuée de +virgules. La @var{date de parution}, si présente, doit avoir le format +@var{AAAA/MM/JJ}. Si la date de parution du paquetzge tel qu'il est +installé sur votre systèlme est antérieur à @var{date de parution} alors +vous obtiendrez un avertissement du genre de @code{You have requested, +on input line 9, version `2017/07/03' of package jhtest, but only +version `2000/01/01' is available}. + +La variante @code{\RequirePackageWithOptions} utilise la liste d'options +de la classe courtante. Ceci implique qu'elle ignore toute option passée +à la classe via @code{\PassOptionsToClass}. C'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. + +La différence entre @code{\usepackage} et @code{\RequirePackage} est +mince. La commande @code{\usepackage} est à l'intention du fichier +document alors que @code{\RequirePackage} l'est à celle des fichiers +paquetage ou classe. Ansi, utiliser @code{\usepackage} avant la +commande @code{\documentclass} amène @LaTeX{} à produire une erreur du +genre de @code{\usepackage before \documentclass}, là où vous pouvez +utiliser @code{\RequirePackage}. +@end table + + +@node Fonts +@chapter Polices de caractères + +@cindex polices de caractères + +Deux aspects importants de la sélection d'une @dfn{police} sont la +spécification d'une taille et celle d'un style. Les commandes @LaTeX{} +pour ce faire sont décrites ci-après. + +@menu +* Styles de polices: Font styles. Sélectionnez romain, italique, etc +* Formats de polices: Font sizes. Choisir la taille du point. +* Commandes police de bas niveau: Low-level font commands. Sélectionnez le codage, famille, série, allure. +@end menu + + +@node Font styles +@section styles des polices + +@cindex styles de police +@cindex styles typographiques +@cindex styles de texte + +Les commandes de styles suivantes sont prises en charge par @LaTeX{}. + +Ce premier groupe de commandes est généralement utilisé avec un +argument, comme dans @code{\textit@{texte en italique@}}. Dans le +tableau ci-dessous, la commande correspondante entre parenthèses est la +« forme déclarative », qui ne prend pas arguments. La portée la forme +déclarative s'étend jusqu'à la prochaine commande de type style ou +jusqu'à la fin du groupe actuel. + +Ces commandes, à la fois dans la forme à argument et dans la forme +déclarative, sont cumulatives ; par exemple, vous pouvez dire aussi bien +@code{\sffamily\bfseries} que @code{\bfseries\sffamily} pour obtenir du +gras sans serif. + +Vous pouvez également utiliser une forme de déclaration par +environnement ; par exemple, @code{\begin@{ttfamily@} @dots{} +\end@{ttfamily@}}. + +Ces commandes fournissent automatiquement une correction d'italique si nécessaire. + +@table @code +@item \textrm (\rmfamily) +@findex \textrm +@findex \rmfamily +Romain. + +@item \textit (\itshape) +@findex \textit +@findex \itshape +Italique. + +@item \emph +@findex \emph +@cindex accent +Accent (commute entre @code{\textit} et @code{\textrm} selon le contexte). + +@item \textmd (\mdseries) +@findex \textmd +@findex \mdseries +Poids moyen (par défaut). + +@item \textbf (\bfseries) +@findex \textbf +@findex \bfseries +Gras. + +@item \textup (\upshape) +@findex \textup +@findex \upshape +Droit (par défaut). Le contraire d'incliné. + +@item \textsl (\slshape) +@findex \textsl +@findex \slshape +Inclinée. + +@item \textsf (\sffamily) +@findex \textsf +@findex \sffamily +Sans serif. + +@item \textsc (\scshape) +@findex \textsc +@findex \scshape +Petites capitales. + +@item \texttt (\ttfamily) +@findex \texttt +@findex \ttfamily +Machine à écrire. + +@item \textnormal (\normalfont) +@findex \textnormal +@findex \normalfont +Police principale du document. + +@item \mathrm +@findex \mathrm +Roman, pour une utilisation en mode mathématique. + +@item \mathbf +@findex \mathbf +Gras, pour une utilisation en mode mathématique. + +@item \mathsf +@findex \mathsf +Sans serif, pour une utilisation en mode mathématique. + +@item \mathtt +@findex \mathtt +Machine à écrire, pour une utilisation en mode mathématique. + +@item \mathit +@itemx (\mit) +Italique, pour une utilisation en mode mathématique. + +@item \mathnormal +@findex \mathnormal +Pour une utilisation en mode mathématique, par exemple dans un autre déclaration de type style. + +@item \mathcal +@findex \mathcal +Lettres « calligraphiques », pour une utilisation en mode mathématique. + +@end table + +@findex \mathversion +@cindex mathématiques, gras +@cindex mathématiques gras +En outre, la commande @code{\mathversion@{bold@}} peut être utilisée +pour commuter en caractères gras les lettres et les symboles dans les +formules. @code{\mathversion@{normal@}} restaure la valeur par défaut. + +@findex \oldstylenums +@cindex chiffres de style ancien, +@cindex chiffres de style ancien +@cindex chiffres de revêtement +@PkgIndex{textcomp} +Enfin, la commande @code{\oldstylenums@{@var{chiffres}@}} sert à +composer des chiffres dits de ``à l'ancienne'', qui ont des hauteurs et +profondeur (et parfois largeurs) distincts de l'alignement standard des +chiffres. Les polices @LaTeX{} par défaut prennent en charge cela, et +respecteront @code{\textbf} (mais pas les autres styles, il n'y a pas de +style à l'ancienne italique pour les chiffres en Computer +Modern). Beaucoup d'autres polices ont des chiffre à l'ancienne aussi; +parfois le paquetage @code{textcomp} doit être chargé, et parfois des +options de paquet sont mises à disposition pour en faire le style par +défaut. Entrée de FAQ : +@url{http://www.tex.ac.uk/cgi-bin/texfaq2html?label=osf}. + +@LaTeX{} fournit également les commandes suivantes, qui font passer +inconditionnellement à un style donné, c.-à-d.@: @emph{ne} sont +@emph{pas} cumulatives. De plus, elles sont utilisées différemment des +commandes ci-dessus : @code{@{\@var{cmd} ... @}} au lieu de +@code{\@var{cmd}@{...@}}. Ce sont deux constructions sans relation +l'une avec l'autre. + +@ftable @code +@item \bf +@cindex gras +Passage en @b{gras}. + +@item \cal +@cindex lettres de script pour les mathématiques +@cindex lettres calligraphiques pour les mathématiques +Passage en lettres calligraphiques pour les mathématiques. + +@item \em +@cindex accent +Accent (italique dans romain, romain dans italiques). + +@item \il +@cindex italique +Italique. + +@item \rm +@cindex police romaine +Romain. + +@item \sc +@cindex police petites capitales +Les petites capitales. + +@item \sf +@cindex sans serif +Sans serif. + +@item \sl +@cindex police inclinée +@cindex police oblique +Incliné (oblique). + +@item \tt +@cindex police machine à écrire +@cindex police de largeur fixe +Machine à écrire (largeur fixe). + +@end ftable + +Certaines personnes considèrent que les commandes commutation +inconditionnelles de polices, comme @code{\tt}, sont obsolète et que +@emph{seulement} les commandes cumulatives (@code{\texttt}) doivent être +utilisées. Je (Karl) ne suis pas d'accord. il y a situations tout à fait +raisonnables quand un commutateur de police inconditionnelle est +précisément ce dont vous avez besoin pour obtenir le résultat souhaité ; +pour un exemple, @pxref{description, @code{description}}. Les deux +ensembles de commandes ont leur place. + +@node Font sizes +@section tailles des polices +@cindex tailles de police +@cindex tailles des polices de caractères +@cindex tailles de texte + +Les commandes de type de taille standard suivants sont pris en charge +par @LaTeX{}. Le tableau indique le nom de la commande et taille +utilisée (en points) correspondant réellement pour la police avec les +options @samp{10pt}, @samp{11pt}, et @samp{12pt} de classe de document, +respectivement (@pxref{Document class options}). + +@findex \tiny +@findex \scriptsize +@findex \footnotesize +@findex \small +@findex \normalsize +@findex \large +@findex \Large +@findex \LARGE +@findex \huge +@findex \Huge + + +@multitable{@code{\normalsize} (par défaut)} {24.88} {24.88} {24.88} +@headitem commande @tab @code{10pt} @tab @code{11pt} @tab @code{12pt} +@item @code{\tiny} +@tab 5 @tab 6 @tab 6 +@item @code{\scriptsize} +@tab 7 @tab 8 @tab 8 +@item @code{\footnotesize} +@tab 8 @tab 9 @tab 10 +@item @code{\small} +@tab 9 @tab 10 @tab 10,95 +@item @code{\normalsize} (par défaut) +@tab 10 @tab 10.95 @tab 12 +@item @code{\large} +@tab 12 @tab 12 @tab 14,4 +@item @code{\Large} +@tab 14.4 @tab 14.4 @tab 17,28 +@item @code{\LARGE} +@tab 17.28 @tab 17.28 @tab 20,74 +@item @code{\huge} +@tab 20,74 @tab 20,74 @tab 24,88 +@item @code{\Huge} +@tab 24.88 @tab 24.88 @tab 24.88 +@end multitable + +Les commandes énumérées ici sont des ``forme déclaratives''. La portée +d'une forme déclarative s'étend jusqu'à la prochaine la commande de type +style ou la fin du groupe courant. Vous pouvez également utiliser la +``forme d'environnement'' de ces commandes ; par exemple, +@code{\begin@{tiny@} ... \end@{tiny@}}. + + +@node Low-level font commands +@section commandes de fontes de bas niveau +@cindex commandes de fontes de bas niveau +@cindex commandes de fontes, de bas niveau + +Ces commandes sont principalement destinés aux auteurs de macros et +paquetages. Les commandes indiquées ici sont seulement un sous-ensemble +de celles disponibles. + +@table @code +@item \fontencoding@{codage@} +@findex \fontencoding +Sélectionnez le codage de police. Les codages valides comprennent @code{OT1} et @code{T1}. + +@item \fontfamily@{famille@} +@findex \fontfamily +Sélectionnez la famille de polices. Familles valides sont : + +@itemize @bullet +@item @code{cmr} pour Computer Modern Roman +@item @code{cmss} pour Computer Modern Sans Serif +@item @code{cmtt} pour Computer Modern Typewriter +@end itemize + +et de nombreuses autres. + +@item \fontseries@{série@} +@findex \fontseries +Sélectionnez série de police. Les séries valides sont : + +@itemize @bullet +@item @code{m} Moyen (normal) +@item @code{b} Gras +@item @code{c} condensé +@item @code{bc} condensé Gras +@item @code{bx} Gras étendu +@end itemize + +et diverses autres combinaisons. + +@item \fontshape@{forme@} +@findex \fontshape +Sélectionnez l'allure de police. Les allures valides sont : + +@itemize @bullet +@item @code{n} Droit (normal) +@item @code{it} Italique +@item @code{sl} Incliné (oblique) +@item @code{sc} Petites capitales +@item @code{ui} Italique droit +@item @code{ol} Plan +@end itemize + +Les deux dernières allures ne sont pas disponibles pour la plupart des +familles de polices. + + +@item \fontsize@{taille@}@{interligne@} +@findex \fontsize +@findex \baselineskip +Réglage de la taille de police. Le premier paramètre est la taille de la +police pour basculer et le deuxième est l'espacement d'interligne ; ceci +est stocké dans un paramètre nommé @code{\baselineskip}. L'unité des +deux paramètres est par défaut le @code{pt}. La valeur par défaut de +@code{\baselineskip} pour la police Computer Modern est 1,2 fois le +@code{\fontsize}. + +@findex \baselinestretch +@PkgIndex{setspace} +@cindex interligne double + +L'espacement des lignes est également multiplié par la valeur du +paramètre @code{\baselinestretch} en cas de changement de taille de +type ;@c vincentb1: Je ne comprends pas when the type size changes +la valeur défaut est 1. Cependant, la meilleure façon de mettre +un document en ``espacement double'', si vous avez la malchance d'avoir +à produire une telle chose, est d'utiliser le paquetage +@code{setspace} ; voir +@url{http://www.tex.ac.uk/cgi-bin/texfaq2html?label=linespace}. + +@findex \linespread +@item \linespread@{@var{facteur}@} +Est équivalent à +@code{\renewcommand@{\baselinestretch@}@{@var{facteur}@}}, et doit donc +être suivie par @code{\selectfont} pour avoir un effet. Il vaut mieux +que ce soit dans le préambule, ou utiliser le paquetage @code{setspace}, +comme décrit juste au-dessus. + +@findex \selectfont +Les modifications apportées en appelant les commandes de polices +décrites ci-dessus n'entrent en vigueur qu'après que @code{\selectfont} +est appelé. + +@item \usefont@{codage@}@{famille@}@{série@}@{forme@} +@findex \usefont +Revient à la même chose que d'invoquer @code{\fontencoding}, +@code{\fontfamily}, @code{\fontseries} et @code{\fontshape} avec les +paramètres donnés, suivi par @code{\selectfont}. + +@end table + + +@node Layout +@chapter Mise en page +@cindex commandes de mise en page + +Diverses commandes pour contrôler la disposition générale de la page. + +@menu +* \onecolumn :: Utiliser la disposition à une colonne. +* \twocolumn :: Utiliser la disposition à deux colonnes. +* \flushbottom :: Faire toutes les pages de texte de la même hauteur. +* \raggedbottom :: Autoriser les pages de texte à être de hauteurs différentes. +* Paramètres de mise en page: Page layout parameters. @code{\headheight} @code{\footskip}. +* Flottants: Floats. Figures, tableaux, etc. +@end menu + + +@node \onecolumn +@section @code{\onecolumn} +@findex \onecolumn +@cindex sortie à une colonne + +La déclaration @code{\onecolumn} commence une nouvelle page et produit +une sortie à colonne unique. C'est la valeur par défaut. + +@node \twocolumn +@section @code{\twocolumn} +@findex \twocolumn +@cindex texte sur plusieurs colonnes +@cindex sortie à deux colonnes + +Synopsis : + +@example +\twocolumn [@var{texte1col}] +@end example + +La déclaration @code{\twocolumn} commence une nouvelle page et produit +sortie à deux colonnes. Si l'argument optionnel @var{texte1col} est +présent, il est composée dans le mode à une colonne avant que la +composition à deux colonnes ne commence. + +Les paramètres ci-après contrôlent la composition de la production de deux +colonnes : + +@ftable @code +@item \columnsep +La distance entre les colonnes (35pt par défaut). + +@item \columnseprule +La largeur du filet entre les colonnes ; la valeur par défaut est 0pt, +de sorte qu'il n'y a pas de filet. + +@item \columnwidth +La largeur de la colonne en cours ; il est égal à @code{\textwidth} dans +le cas d'un texte composé en une seule colonne. + +@end ftable + +Les paramètres ci-après contrôlent le comportement des flottants en cas de production +à deux colonnes : + +@ftable @code +@item \dbltopfraction +Fraction maximale au sommet d'une page sur deux colonnes qui peut être +occupée par des flottants. Par défaut vaut @samp{0,7}, peut être +utilement redéfini en (par exemple) @samp{0,9} pour aller moins tôt sur +des pages de flottants. + +@item \dblfloatpagefraction +La fraction minimum d'une page de flottants qui doit être occupée par +des flottants, pour une page à flottant à deux colonnes. Par défaut vaut +@samp{0,5}. + +@item \dblfloatsep +Distance entre les flottants en haut ou en bas d'une page de flottants à +deux colonnes. Par défaut vaut @samp{12pt plus2pt minus2pt} pour des +documents en @samp{10pt} ou @samp{11pt}, et @samp{14pt plus2pt minus4pt} +pour @samp{12pt}. + + +@item \dbltextfloatsep +Distance entre un flottant multi-colonnes en haut ou en bas d'une page +et le texte principal. Par défaut vaut @samp{20pt plus2pt minus4pt} . + +@end ftable + +@node \flushbottom +@section @code{\flushbottom} + +@findex \flushbottom + +La déclaration @code{\flushbottom} rend toutes les pages de texte de la +même hauteur, en ajoutant de k'espace vertical supplémentaire si +nécessaire pour remplir le page. + +C'est la valeur par défaut si le mode @code{twocolumn} est sélectionné +(@pxref{Document class options}). + +@node \raggedbottom +@section @code{\raggedbottom} +@findex \raggedbottom +@cindex étirement, omettre l'étirement vertical + +La déclaration @code{\raggedbottom} rend toutes les pages de la hauteur +naturelle de la matière sur cette page. Aucune des longueurs d'élastique +ne seront étirée. + + +@node Page layout parameters +@section Paramètres de mise en page + +@cindex page, paramètres de mise en page +@cindex paramètres, la mise en page +@cindex mise en page, les paramètres de +@cindex en-tête, des paramètres pour +@cindex bas de page, des paramètres pour +@cindex en-tête et pied de page en cours de traitement + +@ftable @code +@item \headheight +Hauteur de la boîte qui contient la tête en cours de traitement. La +valeur par défaut est @samp{30pt}, sauf dans la classe @code{book}, où +elle varie en fonction de la taille de la police. + +@item \headsep +La distance verticale entre le bas de la ligne d'en-tête et la partie +supérieure du texte principal. La valeur par défaut est @samp{25pt}, +sauf dans la classe @code{book}, où elle varie avec la taille de +la police. + +@item \footskip +Distance de la ligne de base de la dernière ligne de texte à la ligne de +base du bas de page. La valeur par défaut est @samp{30pt}, sauf dans la +classe @code{book} où elle varie avec la taille de la police. + +@item \linewidth +Largeur de la ligne actuelle, diminuée pour chaque @code{list} imbriquée +(@pxref{list}). Plus précisément, elle est inférieure à +@code{\textwidth} par la somme de @code{\leftmargin} et +@code{\rightmargin} (@pxref{itemize}). La valeur par défaut varie en +fonction de la taille de la police, la largeur du papier, le mode à deux +colonnes, etc. Pour un document de classe @code{article} en taille de +police @samp{10pt}, elle vaut @samp{345pt} ; dans le mode à deux +colonnes, elle passe à @samp{229.5pt}. + +@item \textheight +La hauteur verticale normale du corps de la page ; la valeur par défaut +varie en fonction de la taille de la police, de la classe du document, +etc. Pour un document de classe @code{article} ou @code{report} en +taille de police @samp{10pt}, elle vaut @samp{43\baselineskip} ; pour +une classe @code{book}, elle vaut @samp{41\baselineskip}. Pour +@samp{11pt}, c'est @samp{38\baselineskip} et pour @samp{12pt} c'est +@samp{36\baselineskip}. + +@item \paperheight +La hauteur du papier, à ne pas confondre avec la hauteur de la zone +d'impression. Elle est normalement réglée avec une option de classe de +document, comme dans @code{\documentclass[a4paper]@{article@}} +(@pxref{Document class options,Options de classe de document}). + +@item \paperwidth +La largeur du papier, à ne pas confondre avec la largeur de la zone +d'impression. Elle est normalement réglée avec une option de classe de +document, comme dans @code{\documentclass[a4paper]@{article@}} +(@pxref{Document class options,Options de classe de document}). + +@item \textwidth +La largeur horizontale totale de l'ensemble du corps de la page; la +valeur par défaut varie comme d'habitude. Pour un document de classe +@code{article} ou @code{report}, elle vaut @samp{345pt} à @samp{10pt} de +taille de police, @samp{360pt} à @samp{11pt}, et @samp{390pt} à +@samp{12pt}. Pour un document @code{book}, elle veut @samp{4.5in} à +@samp{10pt} et @samp{5in} à @samp{11pt} ou @samp{12pt}. + +En sortie multi-colonne, @code{\textwidth} reste de la largeur de tout +le corps de la page, tandis que @code{\columnwidth} est la largeur d'une +colonne (@pxref{\twocolumn}). + +Dans les listes (@pxref{list}), @code{\textwidth} est le reste la +largeur du corps corps de la page entière (et @code{\columnwidth} est la +largeur d'une colonne entière), alors que @code{\linewidth} peut +diminuer au sein de listes imbriquées. + +À l'intérieur d'une minipage (@pxref{minipage} ) ou @code{\parbox} +(@pxref{\parbox}), tous les paramètres liés à la largeur sont mis à la +largeur spécifiée, et de reviennent à leurs valeurs normales à la fin du +@code{minipage} ou @code{\parbox}. + +@findex \hsize +Par souci d'exhaustivité : @code{\hsize} est le paramètre @TeX{} +primitif utilisé lorsque le texte est divisé en lignes. Il ne devrait +pas être utilisé dans des documents @LaTeX{} en conditions normales. + +@item \topmargin +L'espace entre le haut de la page @TeX{} (un pouce à partir du haut de +la feuille, par défaut) et le sommet de l'en-tête de page. La valeur par +défaut est calculée sur la base de nombreux autres paramètres : +@code{\paperheight @minus{} 2in @minus{} \headheight @minus{} \headsep +@minus{} \textheight @minus{} \footskip}, et ensuite divisé par deux. + +@item \topskip +La distance minimale entre le sommet du corps de la page et la ligne de base de +la première ligne de texte. Pour les classes standard, la valeur par défaut est la +même que la taille de la police, par exemple, @samp{10pt} à @samp{10pt}. + +@end ftable + +@node Floats +@section Flottants + +Certains éléments typographiques, tels que les figures et les tableaux, +ne peuvent pas être à cheval sur plusieurs pages. Ils doivent être +composés en dehors du flux normal du texte, par exemple flottant au +sommet d'une page ultérieure + +@LaTeX{} sait gérer plusieurs classes de matériel flottant. Il y a deux +classes définies par défaut, @code{figure} (@pxref{figure}) et +@code{table} (@pxref{table}), mais vous pouvez créer une nouvelle +classes avec le paquetage @file{float}. + +Au sein d'une même classe flottante @LaTeX{} respecte l'ordre, de sorte +que la première figure dans le code source d'un document est toujours +composée avant la deuxième figure. Cependant, @LaTeX{} peut mélanger +les classes, ainsi il peut se produire qu'alors que le premier tableau +apparaît dans le code source avant la première figure, il apparaîsse +après elle dans le fichier de sortie. + +Le placement des flottant est l'objet de paramètres, donnés ci-dessous, +qui limittent le nombre de flottants pouvant apparaître au sommet d'une +page, et au bas de page, etc. Si à cause d'un nombre trop important de +flottants mis en queue ces limites les empèchent de tenir tous dans une +seule page, alors @LaTeX{} place ce qu'il peut et diffère le reste à la +page suivante. De la sorte, les flottants peuvent être composés loin de +leur place d'origine dans le code source. En particulioer, un flottant +qui prend beaucoup de place peut migrer jusqu'à la fin du document. Mais +alors, parce que tous les flottant dans une classe doivent appraître +dans le même ordre séquentiel, tous les flottants suivant dans cette +classe appraîssent aussi à la fin. + +@cindex placement des flottants +@cindex spécificateur, placement de flottants +En plus de changer les paramètres, pour chaque flottant vous pouvez +peaufiner l'endroit où l'algorithme de placement des flottants essaie de +le placer en utilisant sont argument @var{placement}. Les valeurs +possibles sont une séquence des lettres ci-dessous. La valeur par +défault pour à la fois @code{figure} et @code{table}, dans les deux +classes de document @code{article} et @code{book}, est @code{tbp}. + +@table @code +@item t +(pour Top) --- au sommet d'une page de texte. + +@item b +(pour Bottom) --- au bas d'une page de texte. (Cependant, @code{b} n'est pas +autorisé avec des flottants en pleine-largeur (@code{figure*}) en cas de +sortie à double-colonne. Pour améliorer cela, on peut utiliser les +paquetages @file{stfloats} ou @file{dblfloatfix}, mais voyez la +discussion sur les avertissements dans la FAQ : +@url{http://www.tex.ac.uk/cgi-bin/texfaq2html?label=2colfloat}. + +@item h +(pour « Here », c.-à-d.@:« Ici » en anglais) --- à la position du texte +où l'environnement @code{figure} apparaît. Cependant, @code{h} n'est pas +autorisé en soi-même ; @code{t} est ajouté automatiquement. + +@cindex ici, placer les flottants +@PkgIndex{float} +Pour forcer à tout prix un flottant à apparaître « ici », vous pouvez +charger le paquetage @file{float} et le spécificateur @code{H} qui y est +défini. Pour plus ample discussion, voir l'entrée de FAQ à +@url{http://www.tex.ac.uk/cgi-bin/texfaq2html?label=figurehere}. + +@item p +@cindex page de flottants +(pour Page de flottants) --- sur une @dfn{page de flottants} séparée, qui est une +page ne contenant pas de texte, seulement des flottants. + +@item ! +Utilisé en plus de l'un des spécificateur précédents ; pour ce flottant +seulement, @LaTeX{} ignore les restrictions à la fois sur le nombre de +flottants qui peuvent apparaître et les quantité relatives de texte +flottant et non-flottant sur la page. Le spécificateur @code{!} +@emph{ne} signifie @emph{pas} « mets le flottant ici » ; voir +plus haut. + +@end table + +Note : l'ordre dans lequel les lettres apparaîssent au sein du paramètre +@var{placement} ne change pas l'ordre dans lequel @LaTeX{} essaie de +placer le flottant ; par exemple @code{btp} a le même effet que +@code{tbp}. Tout ce que @var{placement} fait c'est que si une lettre +n'est pas présente alors l'algorithme n'essaie pas cet endroit. Ainsi, +la valeur par défault de @LaTeX{} étant @code{tbp} consiste à essayer +toutes les localisations sauf celle de placer le flottant là où il +apparaît dans le code source. + +Pour empêcher @LaTeX{} de rejeter tous les flottants à la fin du document +ou d'un chapitre, vous pouvez utiliser la commande @code{\clearpage} +pour commencer une nouvelle page et insérer tous les flottants pendants. +Si un saut de page est indésirable alors vous pouvez charger le +paquetage @file{afterpage} et commettre le code +@code{\afterpage@{\clearpage@}}. Ceci aura l'effet d'attendre la fin de +la page courante et ensuite de faire passer tous les flottants encore +non placés. + +@PkgIndex{flafter} +@LaTeX{} peut composer un flottant avant l'endroit où il apparaît dans +le code source (quoique sur la même page de sortie) s'il y a un +spécificateur @code{t} au sein du paramètre @var{placement}. Si ceci +n'est pas désiré, et que supprimer @code{t} n'est acceptable car ce +spécificateur empèche le flottant d'être placé au sommet de la page +suivante, alors vous pouvez empêcher cela soit en utilisant le +paquetage @file{flafter} ou en utilisant ou en utilisant la +commande +@findex \suppressfloats +@code{\suppressfloats[t]}, ce qui entraîne le déplacement vers la page +suivante des flottants qui auraient du être placés au sommet de la page +courante. + + +Voici les paramètre en relation aux fractions de pages occupées par du +texte flottant et non flottant (on peut les changer avec +@code{\renewcommand@{@var{parameter}@}@{@var{decimal between 0 and +1}@}}) : + +@ftable @code +@findex \bottomfraction +La fraction maximal de page autorisée à être occupées par des flottants +au bas de la page ; la valeur par défaut est @samp{.3}. + +@item \floatpagefraction +La fraction minimale d'une page de flottants qui doit être occupée par des +flottants ; la valeur par défaut @samp{.5}. + +@item \textfraction +La fraction minimale d'une page qui doit être du texte ; si des +flottants prennent trop d'espace pour préserver une telle quantité de +texte, alors les flottants sont déplacés vers une autre page. La valeur +par défaut est @samp{.2}. + +@item \topfraction +Fraction maximale au sommet d'une page page que peut être occupée avant +des flottants ; la valeur par défaut est @samp{.7}. + +@end ftable + +Les paramètres en relation à l'espace vertical autour des flottants (on +peut les changer avec @code{\setlength@{@var{parameter}@}@{@var{length +expression}@}}) : + +@ftable @code +@item \floatsep +Espace entre les floattants au sommet ou au bas d'une page ; par défaut vaut +@samp{12pt plus2pt minus2pt}. + +@item \intextsep +Espace au dessus et au dessous d'un flottant situé au milieu du texte +principal ; vaut par défaut @samp{12pt plus2pt minus2pt} pour les styles +à @samp{10pt} et à @samp{11pt}, et @samp{14pt plus4pt minus4pt} pour +@samp{12pt}. + +@item \textfloatsep +Espace entre le dernier (premier) flottant au sommet (bas) d'une page ; +par défaut vaut @samp{20pt plus2pt minus4pt}. +@end ftable + +Paramètres en relation avec le nombre de flottant sur une page (on peut +les changer avec @code{\setcounter@{@var{ctrname}@}@{@var{natural +number}@}}) : + +@ftable @code +@item \bottomnumber +Nombre maximal de flottants pouvant apparaître au bas d'une page de +texte ; par défaut 1. + +@item \topnumber +Nombre maximal de flottants pouvant apparaître au sommet d'une page de +texte ; par défaut 2. + +@item \totalnumber +Nombre maximal de flottants pouvant apparaître sur une page de +texte ; par défaut 3. +@end ftable + +L'article principal de FAQ @TeX{} en rapport avec les flottants +@url{http://www.tex.ac.uk/cgi-bin/texfaq2html?label=floats} 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'algorithme de placement des flottant se trouve dans +l'article de Frank Mittelbach « How to +infuence the position of float environments like figure and table in +@LaTeX{}? » (@url{http://latex-project.org/papers/tb111mitt-float.pdf}). + +@node Sectioning +@chapter Des rubriques + +@cindex rubricage + +Les commandes de rubricage fournissent les moyens de structurer +votre texte en unités sectionnelles, ou rubriques : + +@ftable @code +@item \part +@item \chapter (seulement pour classes @code{report} et @code{book}) +@item \section +@item \paragraph +@item \subsubsection +@item \paragraph +@item \alinea +@end ftable + +Toutes les commandes ont la même forme générale, par exemple, + +@example +\chapter[@var{titretdm}]@{@var{titre}@} +@end example + +En plus de fournir le titre de rubrique @var{titre} dans le texte +principal, le titre peut apparaître dans deux autres endroits : + +@enumerate +@item +La table des matières. +@item +L'en-tête en cours de traitement en haut de la page. +@end enumerate + +Vous ne voudrez peut-être pas le même texte dans ces endroits que dans +le texte principal. Pour gérer cela, les commandes de rubricage ont +un argument optionnel @var{titretdm} qui, lorsqu'il est fourni, précise +le texte de ces autres endroits. + +@cindex forme étoilée de commandes de rubricage +@cindex forme en * de commandes de rubricage +En outre, toutes les commandes de rubricage ont des formes en +@code{*}, aussi appelée étoilée, qui compose @var{titre} comme +d'habitude, mais ne comprennent pas de numéro et ne produisent pas +d'entrée dans la table des matières. Par exemple : + +@example +\section*@{Préambule@} +@end example + +@findex \appendix +@cindex annexe, création +La commande @code{\appendix} modifie la façon dont les unités +sectionnelles suivantes sont numérotées. La commande @code{\appendix} +elle-même ne génère aucun texte et n'affecte pas la numérotation des +parties. L'utilisation normale de cette commande est quelque chose comme +cela : + +@example +\chapter@{Un chapitre@} +@dots{} +\appendix +\chapter@{La première annexe @} +@end example + +@findex secnumdepth @r{counter} +@cindex numéros de rubrique, composition +@anchor{Sectioning/secnumdepth} +Le compteur @code{secnumdepth} contrôle la composition des numéros de +rubrique. le paramètre + +@example +\setcounter@{secnumdepth@}@{@var{niveau}@} +@end example + +@noindent +supprime le numéros de rubrique à n'importe quelle profondeur @math{> @var{niveau}}, où +@code{chapter} est le niveau zéro. (@xref{\setcounter}.) + +@node Cross references +@chapter Des références croisées +@cindex références croisées + +Une des raisons pour numéroter des choses telles que les figures ou les +équations est d'indiquer au lecteur une référence vers elles, comme dans « Voir la +figure 3 pour plus de détails. » + +@cindex étiquette +Inclure le numéro de figure dans le code source est une mauvaise +pratique puisque ce si ce noméro change avec l'évolution du document, +alors on doit penser à mettre à jour cet référence manuellement. Au lieu +de cela, @LaTeX{} vous fait écrire une @dfn{étiquette} du genre +@code{\label@{eq:ThmGreens@}} et lui faire référence avec @code{Voir +l'équation~\ref@{eq:ThmGreens@}}. + +@LaTeX{} écrit l'information provenant des étiquettes dans un fichier +avec le même nom que le fichier conteant le @code{\label@{...@}} mais +avec une extension @file{.aux}. (L'information a le format +@code{\newlabel@{@var{étiquette}@}@{@{@var{étiquette-courante}@}@{@var{numéro-de-page}@}@}} +où @var{étiquette-courante} est la valeur de la macro +@code{\@@currentlabel} qui est d'ordinaire mise à jour à chaque vous que +that is vous appelez @code{\refstepcounter@{@var{compteur}@}}.) + +@cindex référence déclarée en aval +@cindex aval, référence déclarée en +@cindex déclaration en aval de référence +L'effet secondaire le plus courant du paragraphe précédent se produit +lorsque votre document a une @dfn{référence déclarée en aval}, c.-à-d.@: +un @code{\ref@{@var{clef}@}} qui apparaît avant le +@code{\label@{@var{clef}@}} associé ; voir l'exemple dans la description +de @code{\pageref@{...@}}. @LaTeX{} obtient les référence à partir du +fichier @file{.aux}. Si c'est la première fois que vous compilez le +document alors vous obtiendrez un message @code{LaTeX Warning: Label(s) +may have changed. Rerun to get cross references right.} et dans la +sortie la référence apparaîtra comme deux points +d'interrogration @samp{??} en caractères gras. Ou, si vous modifiez le +document de telle façon que les références changent alors vous +obtiendrez le même avertissement et la sortie contiendra l'information +de référence de la fois précédente. La solution dans les deux cas est +juste de re-compiler le document encore une fois. + +@menu +* \label :: Attribuez un nom symbolique à un morceau de texte. +* \pageref:: Faire référence à un numéro de page. +* \ref:: Faire référence à une rubrique, figure ou chose similaire. +@end menu + + +@node \label +@section @code{\label} +@findex \label + +Synopsis : + +@example +\label@{@var{clef}@} +@end example + +Attribut un numéro de référence à @var{clef}. Au sein de texte +ordinaire, @code{\label@{@var{clef}@}} attribut à @var{clef} le numéro +de la rubrique courante. Au sein d'un environnement numéroté, tel que +l'environnement @code{table} ou @code{theorem}, +@code{\label@{@var{clef}@}} attribue le numéro de cet environnement à +@var{clef}. On retire le numéro attribué avec la commande +@code{\ref@{@var{clef}@}} (@pxref{\ref}). + +Le nom @var{clef} peut se composer de n'importe quelle séquence de +lettres, chiffres, ou caractères de ponctuation ordinaires. Il est +sensible à la casse --- lettres capitales ou bas-de-casse. + +Pour éviter de créer accidentellement deux étiquettes avec le même nom, +l'usage est d'utiliser des étiquettes composées d'un préfixe et d'un +suffixe séparés par un caractère @code{:} ou @code{.}. Certains préfixes +classiquement utilisés : + +@table @code +@item ch +pour les chapitres +@item sec +les commandes de rubricage de niveau inférieur +@item fig +pour les figures +@item tab +pour les tables +@item eq +pour les équations +@end table + +Ansi, @code{\label@{fig:Euler@}} est une étiquette pour une figure avec +un portrait de ce grand homme. + +Dans l'exemple ci-dessous la clef @code{sec:test} se verra attribué le +numéro de la section courante et la clef @code{fig:test} se verra +attribué le numéro de la figure. Soit dit en passant, mettez les +étiquettes (@code{\label}) après les légendes (@code{\caption}) au sein +des environnements @code{figure} ou @code{table}. + +@example +\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@}. +@end example + +@node \pageref +@section @code{\pageref@{@var{clef}@}} +@findex \pageref +@cindex référence croisée avec numéro de page +@cindex numéro de page, référence croisée + +Synopsis : + +@example +\pageref@{@var{clef}@} +@end example + +Produit le numéro de page de l'endroit du texte où la commande +correspondante @code{\label}@{@var{clef}@} apparaît. + +Dans cet exemple le @code{\label@{eq:principale@}} 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'être compilé deux fois pour les résoudre.) + +@example +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@} +@end example + +@node \ref +@section @code{\ref@{@var{clef}@}} +@findex \ref +@cindex référence croisée, symbolique +@cindex numéro de rubrique, référence croisée +@cindex numéro d'équation, référence croisée +@cindex numéro de figure, référence croisée +@cindex numéro de note en bas de page, référence croisée + +Synopsis : + +@example +\ref@{@var{clef}@} +@end example + +Produit le numéro de la rubrique, équation, note en bas de page, figure, +@dots{}, de la commande correspondante @code{\label} (@pxref{\label}). +Elle ne produit aucun texte, tel que le mot @samp{Section} ou +@samp{Figure}, juste le numéro lui-même sans plus. + +Dans cet exemple, le @code{\ref@{populaire@}} produit @samp{2}. Notez +que ceci est une référence déclarée en aval puisque elle est faite avant +@code{\label@{populaire@}}. + +@example +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@} +@end example + + +@node Environments +@chapter Environments +@cindex environments + +@findex \begin +@findex \end + +@LaTeX{} fournit beacoup d'environnements pour baliser un certain texte. +Chaque environnement commence et se termine de la même manière : + +@example +\begin@{@var{nomenv}@} +... +\end@{@var{nomenv}@} +@end example + +@menu +* abstract:: Produit un abrégé. +* array:: Tableau pour les mathématiques. +* center:: Lignes centrées. +* description:: Lignes étiquetées. +* displaymath:: Formule qui apparaissent sur leur propre ligne. +* document:: Entoure le document en entier. +* enumerate:: Liste à numéros. +* eqnarray:: Séquences d'équations alignées. +* equation:: Équation en hors texte. +* figure:: Figures flottante. +* filecontents:: Écrire des fichiers multiples à partir du fichier source. +* flushleft:: Lignes jusitifiées à gauche. +* flushright:: Lignes jusitifiées à droite. +* itemize:: Liste à puces. +* letter:: Lettres. +* list:: Environnement pour listes génériques. +* math:: Math en ligne. +* minipage:: Page miniature. +* picture:: Image avec du texte, des flèches, des lignes et des cercles. +* quotation et quote: quotation and quote. Citer du texte. +* tabbing:: Aligner du texte arbitrairement. +* table:: Tables flottante. +* tabular:: Aligner du texte dans les colonnes. +* thebibliography:: Bibliographie ou liste de référence. +* theorem:: Théorèmes, lemmes, etc. +* titlepage:: Pour des pages de titre sur mesure. +* verbatim:: Simuler un entrée tapuscrite. +* verse:: Pour la poésie et d'autres choses. +@end menu + + +@node abstract +@section @code{abstract} + +@EnvIndex{abstract} +@cindex résumé + +Synopsis : +@example +\begin@{abstract@} +... +\end@{abstract@} +@end example + +Produit un résumé, potentiellement contenant plusieurs paragraphes. Cet +environnement n'est défini que dans les classes de document +@code{article} et @code{report} (@pxref{Document classes}). + +Utiliser l'exemple ci-dessous au sein de la classe @code{article} +produit un paragraphe détaché. L'option @code{titlepage} de la classe de +document a pour effet que le résumé soit sur une page séparée +(@pxref{Document class options}) ; ceci est le comportement par défaut +selement dans la classe @code{report}. + +@example +\begin@{abstract@} + Nous comparons tous les récits de la proposition faits par Porter + Alexander à Robert E Lee en lieu de l'Appomattox Court House que + l'armée continue à combattre dans une guerre de guerilla, ce que Lee + refusa. +\end@{abstract@} +@end example + +L'exemple suivant produit un résumé en une-colonne au sein d'un document +en deux-colonne (pour plus solution plus flexible, utilisez le paquetage +@file{abstract}). + +@c Adopted from http://www.tex.ac.uk/FAQ-onecolabs.html +@example +\documentclass[twocolumn]@{article@} + ... +\begin@{document@} +\title@{Babe Ruth comme ancêtre culturel : une approche atavique@} +\author@{Smith \\ Jones \\ Robinson\thanks@{Bourse des chemins de fer.@}@} +\twocolumn[ + \begin@{@@twocolumnfalse@} + \maketitle + \begin@{abstract@} + Ruth n'était pas seulement le Sultan du Swat, il était à lui tout + seul l'équipe du swat. + \end@{abstract@} + \end@{@@twocolumnfalse@} + ] +@{ % by-hand insert a footnote at page bottom + \renewcommand@{\thefootnote@}@{\fnsymbol@{footnote@}@} + \footnotetext[1]@{Merci pour tout le poisson.@} +@} +@end example + + + +@node array +@section @code{array} +@EnvIndex{array} +@cindex tableaux mathématiques + +Synopsis : + +@example +\begin@{array@}@{@var{patron}@} +@var{entrée-col-1}&@var{entrée-col-2} ... &@var{entrée-col-n}@}\\ +... +\end@{array@} +@end example + +ou + +@example +\begin@{array@}[@var{pos}]@{@var{patron}@} +@var{entrée-col-1}&@var{entrée-col-2} ... &@var{entrée-col-n}@}\\ +... +\end@{array@} +@end example + +Les tableaux mathématiques sont produits avec l'environnement +@code{array}, normalement au sein d'un environnement @code{equation} +(@pxref{equation}). Les entrées dans chaque colonne sont séparées avec +une esperluette (@code{&}). Les lignes sont terminées par une double +contr'oblique (@pxref{\\}). + +L'argument obligatoire @var{patron} décrit le nombre de colonnes, +l'alignement en leur sein, et le formatage des régions +inter-colonne. Voir @ref{tabular} pour une description complete de +@var{patron}, et des autres caractéristiques communes aux deux +environnement, y compris l'argument optionnel @code{pos}. + +L'environnement @code{array} diverge de @code{tabular} par deux +aspect. Le premier est que les entrée de @code{array} sont composées en +mode mathématique, +@c xxx en texte = in textstyle +dans le texte@c +(sauf si le @var{patron} spécifie la colonne avec @code{@@p@{...@}}, ce +qui a pour effet que l'entrée est composée en mode texte). Le second est +que au lieu du paramètre @code{\tablcolsep} de @code{tabular}, l'espace +inter-colonne que @LaTeX{} met dans un @code{array} est contrôlé par +@findex \arraycolsep +@code{\arraycolsep}, qui spécifie la moitié de la largueur entre les +colonnes. La valeur par défaut est @samp{5pt}. + +@PkgIndex{amsmath} +Pour otenir des tableaux entre accolades la méthode standarde est +d'utiliser le paquetage @code{amsmath}. Il comprend les environnements +@code{pmatrix} pour un tableau entre parenthèses @code{(...)}, +@code{bmatrix} pour un tableau entre crochets @code{[...]}, +@code{Bmatrix} pour un tableau entre accolades @code{@{...@}}, +@code{vmatrix} pour un tableau entre barres verticales @code{|...|}, et +@code{Vmatrix} pour un tableau entre doubles barres +verticales @code{||...||}, ainsi que diverses autres contructions de +tableaux. + +Voici un exemple d'un tableau : + +@example +\begin@{equation@} + \begin@{array@}@{cr@} + \sqrt@{y@} &12.3 \\ + x^2 &3.4 + \end@{array@} +\end@{equation@} +@end example + +L'exemple suivante nécessite @code{\usepackage@{amsmath@}} dans le +preambule : + +@example +\begin@{equation@} + \begin@{vmatrix@}@{cc@} + a &b \\ + c &d + \end@{vmatrix@}=ad-bc +\end@{equation@} +@end example + + +@c @table @code +@c @item c +@c centrée +@c @item l +@c justifiée à gauche +@c @item r +@c justifiée à droite +@c @end table +@c +@c @findex \\ (pour @code{array}) +@c Les articles au sein des colonnes sont séparés par @code{&}. Les +@c articles peuvent comprendre d'autres commandes @LaTeX{}. Chaque ligne +@c du tableau se termine par un @code{\\}. +@c +@c @findex @@@{...@} +@c Dans le patron, la construction @code{@@@{@var{texte}@}} place sur +@c chaque ligne @var{texte} entre les colonnes correspondant aux +@c spécificateurs adjacents. +@c +@c Voici un exemple : +@c +@c @example +@c \begin@{equation@} +@c \begin@{array@}@{lrc@} +@c gauche1 & droite1 & centrée1 \\ +@c gauche2 & droite2 & centrée2 \\ +@c \end@{array@} +@c \end@{equation@} +@c @end example +@c +@c @findex \arraycolsep +@c Le paramètre @code{\arraycolsep} définit la motié de la largeur de +@c l'espace séparant les colonnes ; la valeur par defaut est @samp{5pt}. +@c @xref{tabular}, pour les autres paramètres affectant le formattage dans +@c les environnements @code{array}, nommément @code{\arrayrulewidth} et +@c @code{\arraystretch}. +@c +@c L'environnement @code{array} peut être utilisé uniquement en mode mathématique. + + +@node center +@section @code{center} + +@EnvIndex{center} +@cindex centrer du texte, environnement pour + +Synopsis : + +@example +\begin@{center@} +@var{line1} \\ +@var{line2} \\ +\end@{center@} +@end example + +@findex \\ (pour @code{center}) +L'environnement @code{center} vous permet de créer un paragraphe +consistant de lignes qui sont centrée entre les marges de gauche et de +droite de la page courante. Chaque ligne est terminée avec la chaîne +@code{\\}. + +@menu +* \centering:: Forme déclarative de l'environnement @code{center}. +@end menu + + +@node \centering +@subsection @code{\centering} + +@findex \centering +@cindex centrer du texte, déclaration pour + +La déclaration @code{\centering} correspond à l'environnement +@code{center}. Cette déclaration peut être utilisée à l'intérieur d'un +environnement tel que @code{quote} ou d'une @code{parbox}. Ainsi, le +texte d'une figure ou d'une table peut être centré sur la page en +mettant une commande @code{\centering} au début de l'environnement de la +figure ou table. + +Contrairement à l'environnement @code{center}, la commande +@code{\centering} ne commence pas un nouveau paragraphe ; elle change +simplement la façon dont @LaTeX{} formate les unités paragraphe. Pour +affecter le format d'une unité paragraphe, la porté de la déclaration +doit contenir une ligne à blanc ou la commande @code{\end} (d'un +environnement tel que quote) qui finit l'unité de paragraphe. + +Voici un exemple : + +@example +\begin@{quote@} +\centering +first line \\ +second line \\ +\end@{quote@} +@end example + + +@node description +@section @code{description} + +@EnvIndex{description} +@cindex lists étiquetée, créer +@cindex listes de description, créer + +Synopsis : + +@example +\begin@{description@} +\item [@var{étiquette1}] @var{article1} +\item [@var{étiquette2}] @var{article2} +... +\end@{description@} +@end example + +@findex \item +L'environnement @code{description} est utilisé pour fabriquer des listes +d'articles étiquetés. Chaque @var{étiquette} d'article est composée en +gras, alignée à gauche. Bien que les étiquettes sur les articles sont +optionnelles il n'y a pas de valeur par défaut sensée, c'est pourquoi +tous les articles devraient avoir une étiquette. + +@findex \item +La liste consiste en au moins un article ; voir @ref{\item} (l'absence +d'article cause l'erreur @LaTeX{} @samp{Something's wrong--perhaps a +missing \item}). Chaque article est produit avec une commande +@code{\item}. + +@c où ça va ?=> Le texte @var{article} peut contenir plusieurs paragraphes. + +@cindex gras tapuscrit, éviter +@cindex étiquette tapuscrite dans les listes +Une autre variation : puisque le style gras est appliqué aux étiquettes, +si vous composez une étiquette en style tapuscrit avec @code{\texttt}, +vous obtiendrez du gras tapuscrit : @code{\item[\texttt@{gras et +tapuscrit@}]}. C'est peut-être trop gras, entre autres problèmes. Pour +obtenir juste le style tapuscrit, utilisez @code{\tt}, ce qui +reinitialise toutes les autres variations de style : @code{\item[@{\tt +tapuscrit de base@}]}. + +Pour les détails concernant l'espacement des listes, voir @ref{itemize}. + + +@node displaymath +@section @code{displaymath} +@c http://tex.stackexchange.com/questions/40492/what-are-the-differences-between-align-equation-and-displaymath + +@EnvIndex{displaymath} + +Synopsis : + +@example +\begin@{displaymath@} +@var{des maths} +\end@{displaymath@} +@end example + + +L'environnement @code{displaymath} compose le texte @var{des maths} sur +sa propre ligne, centré par défaut. L'option globale @code{fleqn} +justifie les équations à gauche ; voir @ref{Document class options}. + +Aucun numéro d'équation n'est ajouté au texte de texte +@code{displaymath} ; pour obtenir un numéro d'équation, vous pouvez +utiliser l'environnement @code{equation} (@pxref{equation}). + +@LaTeX{} ne fait pas de saut de ligne au sein de @var{des maths}. + +@PkgIndex{amsmath} +Notez que le paquetage @file{amsmath} comprend des possibilités beaucoup +plus vastes en matière d'affichage d'équations. Par exemple, il offre +plusieurs altenatives pour effectuer des sauts de lignes au sein de +texte en mode mathématique. + +La construction @code{\[@var{des maths}\]} est essentiellement un +synonyme de @code{\begin@{displaymath@}@var{des +maths}\end@{displaymath@}}, mais ce dernier est plus pratique à +manipuler dans le code source ; par exemple la recherche d'un caractère +crochet @code{]} peut donner des faux positifs, alors qu'il est plus +probable que le mot @code{displaymath} soit unique. (La construction +@code{$$@var{des maths}$$} tirée du language @TeX{} de base est souvent +utilisée à tort comme un synonyme de @code{displaymath}. Ce n'en est +pas un, parce que l'environnement @code{displaymath} vérifie qu'il ne +commence pas en mode mathérmatique, parce qu'il gère l'espacement +verticial environment différemment, et parce qu'il honore l'option +@code{fleqn}.) + +Le texte composé par cet exemple est centré et seul sur sa ligne. +@example +\begin@{displaymath@} + \int_1^2 x^2\,dx=7/3 +\end@{displaymath@} +@end example +De plus, le signe intégrale est plus grand que ce que la version en +ligne @code{\( \int_1^2 x^2\,dx=7/3 \)} produit. + +@node document +@section @code{document} + +@EnvIndex{document} + +L'environnement @code{document} entoure le corps entier d'un document. +Il est obligatoire dans tout document @LaTeX{}. @xref{Starting and +ending}. +@menu +* \AtBeginDocument:: Crochet pour commandes à exécuter au début du document. +* \AtEndDocument:: Crochet pour commandes à exécuter à la fin du document. +@end menu + + +@node \AtBeginDocument + +@findex \AtBeginDocument +@cindex début de document, crochet + +Synopsis : + +@example +\AtBeginDocument@{@var{code}@} +@end example + +Sauvegarde @var{code} et exécute le quand @code{\begin@{document@}} 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'est pourquoi on ne peut pas +composer du texte avec. + +On peut utiliser cette commande plus d'une fois ; les lignes de code +successives sont exécutée dans l'ordre de passage à la commande. + + +@node \AtEndDocument + +@findex \AtEndDocument +@cindex fin document, crochet + +Synopsis : + +@example +\AtEndDocument@{@var{code}@} +@end example + +Sauvegarde @var{code} et l'exécute vers la fin du document. Plus +précisément, il est exécuté lorsque @code{\end@{document@}} 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'une +partie du code soit exécuté après ces deux traitements, alors il suffit +d'inclure un @code{\clearpage} à l'endroit approprié du @var{code}. + +On peut utiliser cette commande plus d'une fois ; les lignes de code +successives sont exécutée dans l'ordre de passage à la commande. + +@node enumerate +@section @code{enumerate} + +@EnvIndex{enumerate} +@cindex lists of items, numbered + +Synopsis : + +@example +\begin@{enumerate@} +\item @var{article1} +\item @var{article2} +... +\end@{enumerate@} +@end example + +L'environnement @code{enumerate} produit une liste numérotée d'articles. +Le format du numéro en étiquette dépend de si cet environnement est +imbriqué dans un autre ; voir plus bas. + +@findex \item +La liste consiste en au moins un article. L'absence d'article cause +l'erreur @LaTeX{} @samp{Something's wrong--perhaps a missing \item}. +Chaque article est produit avec la commande @code{\item}. + +Cet exemple fait la liste des deux premiers courreurs à l'arrivée du +marathon olympique de 1908 : + +@example +\begin@{enumerate@} + \item Johnny Hayes (USA) + \item Charles Hefferon (RSA) +\end@{enumerate@} +@end example + +Les énumerations peuvent être imbriquées les unes dans les autres, +jusqu'à une profondeur de quatre niveaux. Elles peuvent aussi être +imbriquées au sein d'autres environnements fabriquant des paragraphes, +tels que @code{itemize} (@pxref{itemize}) et @code{description} +(@pxref{description}). +Le format de l'étiquette produite dépend du niveau d'imbrication de la +liste. Voici les valeurs par défaut de @LaTeX{} pour le format à chaque +niveau d'imbrication (où 1 est le niveau le plus externe) : + +@enumerate +@item numéro arabe suivi d'un point : @samp{1.}, @samp{2.}, @dots{} +@item lettre en bas de casse et entre parenthèse : @samp{(a)}, @samp{(b)} @dots{} +@item numéro romain en bas de casse suivi d'un point : @samp{i.}, @samp{ii.}, @dots{} +@item lettre capitale suivie d'un point : @samp{A.}, @samp{B.}, @dots{} +@end enumerate + + +@findex \enumi +@findex \enumii +@findex \enumiii +@findex \enumiv +L'environnement @code{enumerate} utilise les compteurs @code{\enumi}, +@dots{}, @code{\enumiv} (@pxref{Counters}). Si vous utilisez l'argument +optionnel d'@code{\item} alors le compteur n'est pas incrementé pour cet +article (@pxref{\item}). + +@findex \labelenumi +@findex \labelenumii +@findex \labelenumiii +@findex \labelenumiv +L'environnement @code{enumerate} utilise les commandes de +@code{\labelenumi} jusqu'à @code{\labelenumiv} pour produire l'étiquette +par défaut. Ainsi, vous pouvez utiliser @code{\renewcommand} pour +chancher le format des étiquettes (@pxref{\newcommand & +\renewcommand}). Par exemple, cette liste de premier niveau va être +étiquettée avec des lettres capitales, en gras, non suivies point : + +@findex \Alph @r{example} +@example +\renewcommand@{\labelenumi@}@{\textbf@{\Alph@{enumi@}@}@} +\begin@{enumerate@} + \item eI + \item bi: + \item si: +\end@{enumerate@} +@end example + + +Pour une liste des commandes comme @code{\Alph} utilisables pour +formatter le compteur d'étiquette voir @ref{\alph \Alph \arabic \roman +\Roman \fnsymbol}. + +Pour plus ample information sur la personalisation de la forme +@c layout -> forme ? +voir @ref{list}. De même, le paquetage @file{enumitem} est utile pour +cela. + +@node eqnarray +@section @code{eqnarray} + +@EnvIndex{eqnarray} +@cindex équations, aligner +@cindex aligner des équations + +@cindex align @r{environnement, d'@code{amsmath}} +@cindex amsmath @r{paquetage, remplaçant @code{eqnarray}} +@cindex Madsen, Lars +Tout d'abord une mise en garde : l'environnement @code{eqnarray} a +quelques maladresse que l'on ne peut pas surmonter ; l'artice « Évitez +eqnarray ! »@: de Lars Madsen les décrit en détail +(@url{http://tug.org/TUGboat/tb33-1/tb103madsen.pdf}). Ce qu'il faut +retenir c'est qu'il vaut mieux utiliser l'environnement @code{align} (et +d'autres) du paquetage @code{amsmath}. + +Néanmoins, voici une description d'@code{eqnarray} : + +@example +\begin@{eqnarray@} @r{(ou @code{eqnarray*})} +@var{formula1} \\ +@var{formula2} \\ +... +\end@{eqnarray@} +@end example + +@findex \\ (for @code{eqnarray}) +L'environnement @code{eqnarray} est utilisé pour afficher une séquence +d'équations ou d'inégalités. Il est similaire à un environnement +@code{array} à trois colonnes, avec des lignes consecutives séparées par +@code{\\} et des articles consécutifs au sein d'une ligne séparé par une +esperluète @code{&}. + +@findex \\* (pour @code{eqnarray}) +@code{\\*} peut aussi être utilisé pour séparer les équations, avec sa +signification normale de ne pas autoriser un saut de page à cette ligne. + +@findex \nonumber +@cindex numéro d'équation, omettre +Un numéro d'équation est placé sur chaque ligne à moins que cette ligne +ait une commande @code{\nonumber}. Alternativement, la forme étoilé (en +@code{*}) de l'environnement (@code{\begin@{eqnarray*@} +... \end@{eqnarray*@}}) omet la numérotation des équations entièrement, +tout en faisant par ailleurs la même chose qu'@code{eqnarray}. + +@findex \lefteqn +La commande @code{\lefteqn} est utilisée pour couper les longues +formules sur plusieurs lignes. Elle compose son argument en hors texte +et le justifie à gauche dans une boîte de largeur nulle. + +@node equation +@section @code{equation} + +@EnvIndex{equation} +@cindex équations, environnement pour +@cindex formules, environnement pour + +Synopsis : + +@example +\begin@{equation@} +@var{math} +\end@{equation@} +@end example + +L'environnement @code{equation} commence un environnement en +@code{displaymath} (@pxref{displaymath}), par ex.@: en centrant le texte +@var{math} sur la page, et aussi en plaçant un numéro d'équation dans la +marge de droite. + + +@node figure +@section @code{figure} +@EnvIndex{figure} +@cindex inserer des figures +@cindex figures, insertion + +Synopsis : + +@example +\begin@{figure@}[@var{placement}] + @var{corpsfigure} +\caption[@var{titreldf}]@{@var{texte}@} +\label@{@var{étiquette@}} +\end@{figure@} +@end example + +ou + +@example +\begin@{figure*@}[@var{placement}] +@var{corpsfigure} +\caption[@var{titreldf}]@{@var{texte}@} +\label@{@var{étiquette@}} +\end@{figure@} +@end example + +Une classe de flottant (@pxref{Floats}). Parce qu'elles ne peuvent pas +être coupées à cheval sur plusieurs pages, elles ne sont pas composées +en séquence avec le texte normal, mais au contraire sont ``flottées'' +vers un endroit convenable, tel que le sommet d'une page suivante. + +Pour les valeurs possibles de @var{placement} et leur effet sur +l'algorithme de placement des flottants, voir @ref{Floats}. + +La version étoilée @code{figure*} est utilisée quand un document est en +mode double-colonne (@pxref{\twocolumn}). elle produit une figure qui +s'étend sur les deux colonnes, au sommet de la page. Pour ajouter la +possibiltié de la placer à un bas de page voir la discussion de +@var{placement} @code{b} dans @ref{Floats}. + +Le corps de la figure est composé dans une @code{parbox} de largueur +@code{\textwidth} and ainsi il peut contenir du texte, des commandes, +etc. + +L'étiquette est optionnelle ; elle est utilisée pour les double renvois +(@pxref{Cross references}). +@findex \caption +La commande @code{\caption} spécifie la légende @var{texte} pour la +figure. La légende est numérotée par défaut. Si @var{titreldf} est +présent, il est utilisé dans la liste des figures au lieu de @var{texte} +(@pxref{Tables of contents}). + +Cet exemple fabrique une figure à partir d'un graphique. Il nécessite +l'un des paquetage @file{graphics} ou @file{graphicx}. Le graphique, +avec sa légende, est palcé au sommet d'une page ou, s'il est rejet à la +fin du document, sur une page de flottants. + +@example +\begin@{figure@}[t] + \centering + \includegraphics[width=0.5\textwidth]@{CTANlion.png@} + \caption@{The CTAN lion, by Duane Bibby@} +\end@{figure@} +@end example + + +@node filecontents +@section @code{filecontents}: Écrire un fichier externe +@EnvIndex{filecontents} +@EnvIndex{filecontents*} +@cindex fichier externe, écrire +@cindex écrire un fichier externe + +Synopsis : + +@example +\begin@{filecontents@}@{@var{nomfichier}@} +@var{texte} +\end@{filecontents@} +@end example + +ou + +@example +\begin@{filecontents*@}@{@var{nomfichier}@} +@var{texte} +\end@{filecontents*@} +@end example + +Crée un fichier nommé @var{nomfichier} et le remplit de @var{texte}. La +version non étoilée de l'environnement @code{filecontent} préfixe le +contenu du ficher crée d'une en-tête ; voir l'exemple ci-dessous. La +version étoilée @code{filecontent*} n'inclut par l'en-tête. + +Cet environnement peut être utilisé n'importe-où dans le préambule, bien +qu'elle apparaisse en général avant la commande +@code{\documentclass}. Elle est typiquement utilisée quand une fichier +source a besoin d'un fichier non standard de style ou de +classe. L'environnement permet d'écrire ce fichier dans le répertoire +contenant ce fichier et ainsi de rendre le code source autonome. Une +autre utilisation est d'inclure des référence au format @code{bib} dans +le fichier source, de même pour le rendre autonome. + +L'environnement vérifie si un fichier de même nom existe déjà, et si +oui, ne fait rien. Il y a un paquetage @file{filecontents} qui redéfinit +l'environnement @code{filecontents} de sorte qu'au lieu de ne rien faire +dans ce cas, il écrase le fichier existant. + +Par exemple, ce document : + +@example +\documentclass@{article@} +\begin@{filecontents@}@{JH.sty@} +\newcommand@{\monnom@}@{Jim Hef@{@}feron@} +\end@{filecontents@} +\usepackage@{JH@} +\begin@{document@} +Un article de \monnom. +\end@{document@} +@end example + +produit ce fichier @file{JH.sty}. + +@example +%% LaTeX2e file `JH.sty' +%% generated by the `filecontents' environment +%% from source `test' on 2015/10/12. +%% +\newcommand@{\monnom@}@{Jim Hef@{@}feron@} +@end example + + +@node flushleft +@section @code{flushleft} +@EnvIndex{flushleft} +@cindex jsutifier à gauche du texte, environnement pour +@cindex texte fer à gauche, environnement pour +@cindex texte ferré à gauche, environnement pour +@cindex texte drapeau droit, environnement pour + +@example +\begin@{flushleft@} +@var{ligne1} \\ +@var{ligne2} \\ +... +\end@{flushleft@} +@end example + +@findex \\ @r{for @code{flushleft}} +L'environnement @code{flushleft} vous permet de créer un paragraphe +ferré à gauche, c'est à dire consistant en lignes qui sont alignées sur +la marge de gauche et en dentelures à droite comme un drapeau dont la +hampe (fer du composteur) serait à gauche et les franges à +droite. Chaque ligne doit être terminée par la séquence de contrôle +@code{\\}. + +@menu +* \raggedright:: Forme déclarative de l'environnement @code{flushleft}. +@end menu + + +@node \raggedright +@subsection @code{\raggedright} +@findex \raggedright +@cindex texte drapeau droit +@cindex texte ferré à gauche +@cindex texte fer à gauche +@cindex justifié à gauche du texte +@cindex justification, drapeau droit + +La déclaration @code{\raggedright} correspond à l'environnement +@code{flushleft}. Cette déclaration peut être utilisée au sein d'un +environnement tel que @code{quote} ou d'une @code{parbox}. + +Contrairement à l'environnement @code{flushleft}, la commande +@code{\raggedright} ne démarre pas un nouveau paragraphe ; elle change +seulement la façon dont @LaTeX{} formatte les unités de paragraphe. Pour +affecter le format d'une unité de paragraphe, la porté de la déclaration +doit contenir la ligne à blanc où la commande @code{\end} qui termine +l'unité de paragraphe. + + +@node flushright +@section @code{flushright} +@EnvIndex{flushright} +@cindex texte drapeau gauche, environnement pour +@cindex justifier à droite, environnement pour + +@example +\begin@{flushright@} +@var{ligne1} \\ +@var{ligne2} \\ +... +\end@{flushright@} +@end example + +@findex \\ (pour @code{flushright}) +L'environnement @code{flushright} vous permet de créer un paragraphe +ferré à droite et drapeau gauche, c.-à-d.@: consistant de lignes qui sont +alignées sur la marge de droite (fer à droite) et en dentelures +(drapeau) sur la marge de gauche. Chaque ligne doit être temrinée par la +séquence de contrôle @code{\\}. + +@menu +* \raggedleft:: Forme déclarative de l'environnement @code{flushright}. +@end menu + + +@node \raggedleft +@subsection @code{\raggedleft} +@findex \raggedleft +@cindex texte drapeau gauche +@cindex justification, drapeau gauche +@cindex justifier le texte à droite + +La déclaration @code{\raggedleft} correspond à l'environnement +@code{flushright}. Cette déclaration peut être utilisée au sein d'un +environnement tel que as @code{quote} ou d'une @code{parbox}. + +Contrairement à l'environnement @code{flushright}, la commande +@code{\raggedleft} ne commence pas un nouveau paragraphe ; elle change +seulement la façon dont @LaTeX{} formatte les unités de paragraphe. Pour +affecter le format d'une une unité de paragraphe, la portée de la +déclaration doit contenir la ligne à blanc ou la commande @code{\end} qui +termine l'unité de paragraphe. + + +@node itemize +@section @code{itemize} +@EnvIndex{itemize} +@findex \item +@cindex listes d'articles +@cindex listes non ordonnées +@cindex listes à puces + +Synopsis : + +@example +\begin@{itemize@} +\item @var{item1} +\item @var{item2} +... +\end@{itemize@} +@end example + +L'environnement @code{itemize} produit une liste « non ordonnée », « à +puces ». Les environnement @code{itemize} peuvent être imbriqués l'un +dans l'autre, jusqu'à quatre niveaux de profondeur. Ils peuvent aussi +être imbriqués avec d'autre environnements fabriquant des paragraphes, +comme @code{enumerate} (@pxref{enumerate}). + +Chaque article d'une liste @code{itemize} commence avec une commande +@code{\item}. Il doit y avoir au moins une commande @code{\item} au +sein de l'environnement. + +Par défaut, les marques de chaque niveau ressemblent à cela : + +@enumerate +@item @bullet{} (puce) +@item @b{-@w{-}} (tiret demi-cadratin gras) +@item * (asterisque) +@iftex +@item @math{\cdot} (point centré verticalement) +@end iftex +@ifnottex +@item . (point centré verticalement, rendu ici comme un point final) +@end ifnottex +@end enumerate + +@c vincentb1 cette information n'est pas dans l'original, vérifiez avec Karl : + +Si vous utilisez l'environnement @code{babel} avec la langue +@code{french}, alors il y a des tirets pour tous les niveaux comme c'est +l'habitude des Français. + +@findex \labelitemi +@findex \labelitemii +@findex \labelitemiii +@findex \labelitemiv +L'environnement @code{itemize} utilise les commandes de +@code{\labelitemi} jusqu'à @code{\labelitemiv} pour produire les +étiquettes par défaut. Ainsi, vous pouvez utiliser @code{\renewcommand} +pour changer les étiquettes. Par exemple, pour que le premier niveau +utilise des losanges : + +@example +\renewcommand@{\labelitemi@}@{$\diamond$@} +@end example + +@findex \leftmargin +@findex \leftmargini +@findex \leftmarginii +@findex \leftmarginiii +@findex \leftmarginiv +@findex \leftmarginv +@findex \leftmarginvi + +Les paramètres de @code{\leftmargini} jusqu'à @code{\leftmarginvi} +définissent la distance entre la marge de gauche de l'environnement +surjacent et la marge de gauche de la liste. Par convention, +@code{\leftmargin} est réglée à la @code{\leftmargin@var{N}} appropriée +quand on entre dans un nouveau niveau d'imbrication. + +Les valeurs par défaut varient de @samp{.5em} (pour les niveaux +d'imbrication les plus élevés) jusqu'à @samp{2.5em} (premier niveau), et +sont légèrement réduits en mode deux-colonnes. Cet exemple réduit +grandement l'espace de marge pour la liste la plus extérieure : + +@example +\setlength@{\leftmargini@}@{1.25em@} % par défaut 2.5em +@end example + +@c xx should be in its own generic section +Quelques paramètres qui affectent le formatage des listes : + +@ftable @code +@item \itemindent +Renfoncement supplementaire avant chaque articles dans une liste ; la +valeur par défaut est zéro. + +@item \labelsep +Espace entre l'étiquette et le texte d'un article ; la valeur par défaut +est @samp{.5em}. + +@item \labelwidth +Largeur de l'étiquette ; la valeur par défaut est @samp{2em}, ou +@samp{1.5em} en mode deux-colonnes. + +@item \listparindent +Renfoncement supplémentaire ajoutée aux paragraphes suivants à commencer +par le second au sein d'un article de liste ; la valeur par défaut est +@samp{0pt}. + +@item \rightmargin +Distance horizontale entre la marge de droite de la liste et +l'environnement surjacent ; la valeur par défaut est @samp{0pt}, sauf à +l'intérieur des environnement @code{quote}, @code{quotation}, et +@code{verse}, où elle est réglée pour être égale à @code{\leftmargin}. + +@end ftable + +Paramètres affectant l'espacement vertical entre les articles de liste +(plutôt relâché, par défaut). + +@ftable @code +@item \itemsep +Espace vertical entre les articles. La valeur par défaut est @code{2pt +plus1pt minus1pt} pour les documents en @code{10pt}, @code{3pt plus2pt +minus1pt} pour ceux en @code{11pt}, et @code{4.5pt plus2pt minus1pt} +pour ceux en @code{12pt}. + +@item \parsep +Espace vertical supplémentaire entre les paragraphes au sein d'un +article de liste. Par défaut vaut la même chose que @code{\itemsep}. + +@item \topsep +Espace vertical entre le premier article et le paragraphe précédent. +Pour les listes au niveau le plus haut, la valeur par défaut est +@code{8pt plus2pt minus4pt} pour les documents en @code{10pt}, @code{9pt +plus3pt minus5pt} pour ceux en @code{11pt}, et @code{10pt plus4pt +minus6pt} pour ceux en @code{12pt}. Ces valeurs sont réduites pour les +listes avec au moins un niveau d'imbrication. + +@item \partopsep +Espace supplémentaire ajouté à @code{\topsep} quand l'environnement de +liste démarre un paragraphe. La valeur par défaut est @code{2pt plus1pt +minus1pt} pour les documents en @code{10pt}, @code{3pt plus1pt minus1pt} +pour ceux en @code{11pt}, et @code{3pt plus2pt minus2pt} pour ceux en +@code{12pt}. + +@end ftable + +@findex \parskip @r{exemple} +En particulier pour les listes avec des articles courts, il peut être +désirable d'élider l'espace entre les articles. Voici un exemple +définissant un environnement @code{itemize*} sans espacement +supplémentaire entre les articles, ni entre les paragraphes au sein d'un +seul article (@code{\parskip} n'est pas spécifique aux listes, +@pxref{\parskip}): + +@example +\newenvironment@{itemize*@}% + @{\begin@{itemize@}% + \setlength@{\itemsep@}@{0pt@}% + \setlength@{\parsep@}@{0pt@}@}% + \setlength@{\parskip@}@{0pt@}@}% + @{\end@{itemize@}@} +@end example + + +@node letter +@section environnement @code{letter}: écrire des lettres postales +@EnvIndex{letter} + +Cet environnement est utilisé pour créer des lettres. @xref{Letters}. + + +@node list +@section @code{list} +@EnvIndex{list} +@cindex listes d'articles, générique + +L'environnement @code{list} est un environnement générique qui est +utilisé pour définir beaucoup des environnements plus spécifiques. Il +est rarement utilisé dans des documents, mais souvant dans des macros. + +@example +\begin@{list@}@{@var{étiquettage}@}@{@var{espacement}@} +\item @var{item1} +\item @var{item2} +... +\end@{list@} +@end example + +L'argument obligatoire @var{étiquettage} spécifie comment les articles +doivent être étiquetés (à moins que son argument optionnel soit fourni à +@code{\item}). Cet argument est un morceau de texte qui est inséré dans +une boîte pour former l'étiquette. Il peut contenir, et d'habitude c'est +le cas, d'autres commandes @LaTeX{}. + +L'argument obligatoire @var{espacement} contient des commandes pour +changer les paramètres d'espacement pour la liste. Cet argument est le +plus souvent vide, c.-à-d.@: @code{@{@}}, ce qui laisse l'espacement +par défaut. + +L'argument utilisé pour composer les articles de la liste est spécifiée +par @code{\linewidth} (@pxref{Page layout parameters}). + +@menu +* \item:: Une entrée dans une liste. +@end menu + + +@node \item + +Synopsis : + +@example +\item texte de l'article +@end example + +ou +@example +\item[@var{étiquette optionnelle}] texte de l'article +@end example + +Un entrée dans une liste. Les entrées sont préfixées par une étiquette, +dont la valeur par défaut dépend du type de liste. + +Parce que l'argument optionnel @var{étiquette optionnelle} est entouré +de crochets (@code{[} et @code{]}), pour utiliser des crochets au +sein de l'argument optionnel vous devez les cacher entre accolades, comme +dans @code{\item[Crochet fermant, @{]@}]}. De même, pour utiliser un +crochet ouvrant comme premier caractère du texte d'un article, cachez le +aussi au sein d'accolade. @xref{@LaTeX{} command syntax}. + +Dans cet exemple la liste @code{enumerate} a deux articles qui utilise +l'étiquette par défaut et une qui utilise l'étiquette optionnelle. + +@example +\begin@{enumerate@} + \item Moe + \item[sometimes] Shemp + \item Larry +\end@{enumerate@} +@end example + +Le premier article est étiquetté @samp{1.}, le deuxième article est +étiquetté @samp{sometimes}, et le troisième article est étiquetté +@samp{2.} (notez que, à cause de l'étiquette optionnelle dans le second +article, le troisième article ne reçoit pas l'étiquette @samp{3.}). + +@node math +@section @code{math} +@EnvIndex{math} +@cindex formules en ligne + +Synopsis : + +@example +\begin@{math@} +@var{maths} +\end@{math@} +@end example + +L'environnement @code{math} insert les @var{maths} donnés au sein du +texte en cours. @code{\(...\))} et @code{$...$} sont des synonymes. +@xref{Math formulas}. + +@node minipage +@section @code{minipage} +@EnvIndex{minipage} +@cindex minipage, créer une + +@example +\begin@{minipage@}[@var{position}][@var{hauteur}][@var{pos-interne}]@{@var{largeur}@} +@var{texte} +\end@{minipage@} +@end example + +L'environnement @code{minipage} compose son corps @var{texte} dans un +bloc qui ne peut pas être coupé sur plusieurs pages. C'est similaire à +la commande @code{\parbox} (@pxref{\parbox}), mais contrairement à +@code{\parbox}, d'autres environnements de production de paragraphe +peuvent être utilisés au sein d'une minipage. + +@c (xxref positions) +Les arguments sont les mêmes que pour @code{\parbox} (@pxref{\parbox}). + +@cindex Renfoncement des paragraphes, au sein d'une minipage +@findex \parindent +Par défaut, les paragraphes ne sont pas renfoncés au sein d'un +environnement @code{minipage}. Vous pouvez restaurer le renfoncement avec +une commande telle que @code{\setlength@{\parindent@}@{1pc@}}. + +@cindex notes en bas de page au sein des figures +@cindex figures, notes en bas de page au sein des +Les notes en bas de page au sein d'un environnement @code{minipage} sont +gérées d'une façon qui est particulièrement utiles pour mettre des notes +en bas de page dans des figures ou des tableaux. Une commande +@code{\footnote} @code{\footnotetext} met la note en bas de page au bas +de la minipage au lieu de la mettre au bas de la page, et elle utilise +le compteur @code{\mpfootnote} au lieu du compteur ordinaire +@code{footnote} (@pxref{Counters}). + +Cependant, ne mettez pas une minipage à l'intérieur d'une autre si vous +utilisez les note en bas de page ; elles pourraient terminer en bas de +la mauvaise minipage. + +@node picture +@section @code{picture} +@EnvIndex{picture} +@cindex créer des images +@cindex images, créer + +@example +\begin@{picture@}(@var{largeur},@var{hauteur})(@var{décalagex},@var{décalagey}) +@dots{} @var{commandes picture} @dots{} +\end@{picture@} +@end example + + +@findex \unitlength +L'environnement @code{picture} vous permet de créer toute sorte de +dessin dans lequel vous voulez du texte, des lignes, des flèches et des +cercles. Vous dîtes à @LaTeX{} où mettre les chose dans le dessin en +spécifiant leur coordonnées. Une coordonnée est un nombre qui peut avoir +une séparateur décimal (point et non virgule) et un signe moins --- un +nombre comme @code{5}, @code{0.3} ou @code{-3.1416}. Une coordonnées +spécifie une longueur en multiples de l'unité de longueur +@code{\unitlength}, ainsi si @code{\unitlength} a été réglée à +@code{1cm}, alors la coordonnée 2.54 spécifie une longueur de 2,54 +centimètres. + +Vous devriez changer la valeur de @code{\unitlength}, en utilisant la +commande @code{\setlength}, en dehors d'un environnement +@code{picture}. La valeur par défaut est @code{1pt}. + +@PkgIndex{picture} +Le paquetage @code{picture} redéfinit l'environnement @code{picture} de +sorte qu'où que soit utilisé un nombre au sein de @var{commandes picture} +pour spécifier une coordonnée, on puisse alternativement utiliser une +longueur. Notez bien cependant que ceci empèche de dilater/contracter +ces longueurs en changeant @code{\unitlength}. + +@cindex position, dans un dessin @code{picture} +Une @dfn{position} est une paire de coordonnées, telle que +@code{(2.4,-5)}, ce qui spécifie un point d'abscisse @code{2.4} et +d'ordonnée @code{-5}. Les coordonnées sont spécifiées de la manière +habituelle relativement à une origine, qui est normalement dans le coin +inférieur gauche du dessin. Notez que lorsque une position apparaît en +argument, elle n'est pas entourée d'accolades ; on délimite l'argument +avec des parenthèses. + +L'environnement @code{picture} a un argument obligatoire qui est une +position (@var{largeur},@var{hauteur}) qui spécifie la taille du dessin. +L'environnement produit une boîte rectangulaire dont les dimensions sont +cette @var{largeur} et cette @var{hauteur}. + +L'environnement @code{picture} a aussi un argument optionnel de position +(@var{décalagex},@var{décalagey}), qui suit l'argument de taille, et qui +peut changer l'origine. (Contrairement aux arguments optionnels +ordinaire, cet argument n'est pas contenu entre crochets.) L'argument +optionnel donne les coordonnées du point dans le coin inférieur gauche +du dessin (par là même déterminant l'origine). Par exemple, si +@code{\unitlength} a été réglée à @code{1mm}, la commande + +@example +\begin@{picture@}(100,200)(10,20) +@end example + +@noindent produit un dessin de largeur 100 millimetres et hauteur 200 +millimetres, done le coin inférieur gauche est le (10,20) et dont le +coin supérieur doint est donc le point (110,220). Lorsque vous dessin +la première fois un dessin, typiquement vous omettez l'argument +optionnel, laissant l'origine au coin inférieur gauche. Si ensuite vous +voulez modifier le dessin en translatant tout, vous pouvez juste ajouter +l'argument optionnel approprié. + +L'argument obligatoire de l'environnement détermine la taille nominale +du dessin. Il n'est pas nécessaire que cela soit en relation à la taille +réèlle du dessin ; @LaTeX{} vous laissera sans broncher mettre des chose +en dehors de la boîte définie par la taille du dessin, et même en dehors +de la page. La taille nominale du dessin est utilisée par @LaTeX{} pour +la détermination de la quantité de place à prévoir pour lui. + +Tout ce qui apparaît dans un dessin @code{picture} est dessiné par la +commande @code{\put}. La commande + +@example +\put (11.3,-.3)@{...@} +@end example + +@noindent met l'objet spécifié par @code{...} dans le dessin @code{picture}, avec sont +point de référence aux coordonnées @math{(11.3,-.3)}. Les points de +référence des divers objets sont décrits plus bas. + +@findex lR box +La commande @code{\put} crée une @dfn{LR box}. Vous pouvez mettre tout +ce qui peut aller dans une @code{\mbox} (@pxref{\mbox}) dans l'argument +texte de la commande @code{\put}. Quand vous faites cela, le point de +référence devient le coin inférieur gauche de la boîte . + +Les commandes @code{picture} sont décrites dans les rubriques suivantes. + +@menu +* \circle:: Dessine un cercle. +* \makebox (picture):: Dessine une boîte de la taille spécifiée. +* \framebox (picture):: Dessine une boîte avec un cadre autour. +* \dashbox:: Dessine une boîte en tireté. +* \frame:: Dessine un cadre autour d'un objet. +* \line:: Dessine une ligne droite. +* \linethickness:: Règle l'épaisseur de ligne. +* \thicklines:: Une plus grosse épaisseur de ligne. +* \thinlines:: L'épaisseur de ligne par défaut. +* \multiput:: Dessine plusieurs instances d'un objet. +* \oval:: Dessine une ellipse. +* \put:: Place un objet à un endroit spécifié. +* \shortstack:: Empile plusieurs objets. +* \vector:: Dessine une ligne flèchée. +@end menu + + +@node \circle +@subsection @code{\circle} +@findex \circle + +Synopsis : +@example +\circle@{@var{diamètre}@} +\circle*@{@var{diamètre}@} +@end example + +La commande @code{\circle} produit un cercle dont le diamètre est le +plus proche possible de celui spécifié. La forme étoilée (en @code{*}) +de la commande dessine un disque, c.-à-d.@: un cercle plein. + +Des cercles jusqu'à 40@dmn{pt} peuvent être dessinés. + + +@node \makebox (picture) +@subsection @code{\makebox} +@findex \makebox (@code{picture}) + +Synopsis : +@example +\makebox(@var{largeur},@var{hauteur})[@var{position}]@{@var{texte}@} +@end example + +La commande @code{\makebox} pour l'environnement @code{picture} est +similaire à la commande normale @code{\makebox} à ceci près que vous +devez spécifier une @var{largeur} et une @var{hauteur} implicitement +multipliés par @code{\unitlength}. + +L'argument optionnel, @code{[@var{position}]}, spécifie le quadrant dans +lequel votre @var{texte} apparaît. Vous pouvez sélectionner jusqu'à deux +spécificateurs parmi les suivants : + +@table @code +@item t +Place l'article au sommet du rectangle. + +@item b +Place l'article en bas du rectangle. + +@item l +Place l'article sur la gauche. + +@item r +Place l'article sur la droite. + +@end table + +@xref{\makebox}. + + +@node \framebox (picture) +@subsection @code{\framebox} +@findex \framebox + +Synopsis : + +@example +\framebox(@var{largeur},@var{hauteur})[@var{pos}]@{...@} +@end example + +La commande @code{\framebox} est similaire à @code{\makebox} (voir +section précédent), à ceci près qu'elle met un cadre autour de +l'extérieur du contenu de la boîte qu'elle créée. + +@findex \fboxrule +@findex \fboxsep +La commande @code{\framebox} produit un filet d'épaisseur +@code{\fboxrule}, et laisse un espace @code{\fboxsep} entre le filet et +le contenu de la boîte. + + +@node \dashbox +@subsection @code{\dashbox} + +@findex \dashbox + +Dessine une boîte avec une ligne en tireté. Synopsis : + +@example +\dashbox@{@var{tlong}@}(@var{rlargeur},@var{rhauteur})[@var{pos}]@{@var{texte}@} +@end example + +@code{\dashbox} crée un rectangle en tireté autour de @var{texte} au +sein d'un environnement @code{picture}. Les tirets sont long de +@var{tlong} unités, et le rectangle a pour largeur totale @var{rlargeur} +et hauteur totale @var{rhauteur}. Le @var{texte} est positionné par l'argument +optionnel @var{pos}. @c xxref positions. + +Une boîte en tireté a meilleure allure quand les paramètres +@var{rlargeur} et @var{rhauteur} sont des multiple de @var{tlong}. + + +@node \frame +@subsection @code{\frame} +@findex \frame + +Synopsis : + +@example +\frame@{@var{texte}@} +@end example + +La commande @code{\frame} met un cadre rectangulaire autour de +@var{texte}. Le point de référence est le coin en bas à gauche du +cadre. Aucun espace supplémentaire n'est mis entre le cadre et l'objet +@var{texte}. + + +@node \line +@subsection @code{\line} +@findex \line + +Synopsis : + +@example +\line(@var{xpente},@var{ypente})@{@var{longueur}@} +@end example + +La commande @code{\line} dessine un ligne avec la @var{longueur} donnée +et la pente @var{xpente}/@var{ypente}. + +De base @LaTeX{} peut seulement dessiner des ligne dont la +@math{@var{pente} = x/y}, où @math{x} et @math{y} prennent des valeurs +entières de @minus{}6 jusqu'à 6. Pour des ligne de pente +quelconque, sans parler d'autres formes, voir le paquetage +@code{curve2e} et bien d'autres sur le CTAN. + + +@node \linethickness +@subsection @code{\linethickness} +@findex \linethickness + +La commande @code{\linethickness@{@var{dim}@}} déclare que l'épaisseur des +lignes horizontales et verticales dans un environnement @code{picture} +environnement vaut @var{dim}, qui doit être une longueur positive. + +@code{\linethickness} n'affecte pas l'épaisseur des lignes obliques, +cercles, ou quarts de cercles dessinés par @code{\oval}. + + +@node \thicklines +@subsection @code{\thicklines} +@findex \thicklines + +La commande @code{\thicklines} est une épaisseur de trait alternative +pour les lignes verticales et horizontales dans un environnement +picture ; cf. @ref{\linethickness} et @ref{\thinlines}. + + +@node \thinlines +@subsection @code{\thinlines} +@findex \thinlines + +La commande @code{\thinlines} est l'épaisseur de trait par défaut pour +les lignes horizontales et verticales dans un environnement picture ; +cf. @ref{\linethickness} et @ref{\thicklines}. + + +@node \multiput +@subsection @code{\multiput} +@findex \multiput + +Synopsis : +@example +\multiput(@var{x},@var{y})(@var{delta_x},@var{delta_y})@{@var{n}@}@{@var{obj}@} +@end example + +La commande @code{\multiput} copie l'objet @var{obj} en un motif +régulier à travers la figure. @var{obj} est placé en premier à la +position @math{(x,y)}, puis à la position @math{(x+\delta x,y+\delta +y)}, et ainsi de suite, @var{n} fois. + + +@node \oval +@subsection @code{\oval} +@findex \oval + +Synopsis : + +@example +\oval(@var{largeur},@var{hauteur})[@var{portion}] +@end example + +La commande @code{\oval} produit un rectangle aux coins arrondis. +L'argument optionnel @var{portion} vous permet de ne produire qu'une +moitié de l'ovale selon ce qui suit : + +@table @code +@item t +selectionne la moitié supérieure ; +@item b +selectionne la moitié inférieure ; +@item r +selectionne la moitié de droite ; +@item l +selectionne la moitié de gauche. +@end table + +Il est également possible de ne produire qu'un quart de l'ovale en +réglant @var{portion} à @code{tr}, @code{br}, @code{bl}, ou @code{tl}. + +Les « coins » de l'ovale sont fabriqués avec des quarts de cercle d'un +rayon maximal de 20@dmn{pt}, ainsi les « ovales » de grande taille +ressembleront plus à des boîtes aux coins arrondis. + + +@node \put +@subsection @code{\put} +@findex \put + +@code{\put(@var{xcoord},@var{ycoord})@{ ... @}} + +La commande @code{\put} place l'article spécifié par l'argument +obligatoire aux coordonnées @var{xcoord} et @var{ycoord} fournies. + +@node \shortstack +@subsection @code{\shortstack} +@findex \shortstack + +Synopsis : + +@example +\shortstack[@var{position}]@{...\\...\\...@} +@end example + +La commande @code{\shortstack} produit une pile d'objets. Les positions valides +sont : + +@table @code +@item r +Déplace les objets à la droite de la pile. +@item l +Déplace les objets à la gauche de la pile +@item c +Déplace les objets au centre de la pile (position par défaut) +@end table + +@findex \\ @r{(pour les objets @code{\shortstack})} +Les objets sont séparés avec @code{\\}. + + +@node \vector +@subsection @code{\vector} +@findex \vector + +Synopsis : + +@example +\vector(@var{xpente},@var{ypente})@{@var{longueur}@} +@end example + +La commande @code{\vector} dessine une ligne fléchée de la +@var{longueur} et direction @math{(@var{xpente},@var{ypente})} +spécifiées. Les valeurs de @math{@var{xpente}} et @math{@var{ypente}} +doivent être comprises entre @minus{}4 and +4 y compris. + + +@node quotation and quote +@section @code{quotation} et @code{quote} +@EnvIndex{quotation} +@cindex citation +@cindex texte cité avec renfoncement des paragraphes, affichage +@cindex afficher du texte cité avec renfoncement de paragraphe +@cindex renfoncement des paragraphes dans du texte cité +@EnvIndex{quote} +@cindex texte cité sans renfoncement des paragraphes, affichage +@cindex afficher un texte cité sans renfoncement de paragraphe +@cindex renfoncement des paragraphes dans un texte cité, omettre + +Synopsis : + +@example +\begin@{quotation@} +@var{texte} +\end@{quotation@} +@end example + +ou + +@example +\begin@{quote@} +@var{texte} +\end@{quote@} +@end example + +Cite du texte. + +Dans les deux environnement, les marges sont renfoncées à la fois sur la +gauche et la droite. Le texte est justifié des deux côtés sur la marge. +De même que dans le texte principal, laisser une ligne à blanc au sein +du texte produit un nouveau paragraphe. + +Pour comparer les deux : dans l'environnement @code{quotation}, les +paragraphes sont renfoncés de 1,5@dmn{em} et l'espace entre les +paragraphe est petit, @code{0pt plus 1pt}. Dans l'environnement +@code{quote}, les paragraphes ne sont pas renfoncés et il y a une espace +verticale entre les paragraphes (c'est la longueur elastique +@code{\parsep}). Ainsi, l'environnement @code{quotation} convient mieux +environm aux documents où les nouveaux paragraphes sont marqués par un +renfoncement plutôt que par une séparation verticale. De plus, +@code{quote} convient meieux pour des citations courtes ou une suite de +citations courtes. + +@example +\begin@{quotation@} +\it Il y a quatre-vingt sept ans + ... ne disparaîtra jamais de la surface de la terre. +\hspace@{1em plus 1fill@}---Abraham Lincoln +\end@{quotation@} +@end example + +@node tabbing +@section @code{tabbing} + +@EnvIndex{tabbing} +@cindex taquets des tabulation, utiliser +@cindex aligner du texte en utilisant des taquets de tabulation +@cindex alignement au moyen de tabbing + +Synopsis : + +@example +\begin@{tabbing@} +@var{row1col1} \= @var{row1col2} \= @var{row1col3} \= @var{row1col4} \\ +@var{row2col1} \> \> @var{row2col3} \\ +... +\end@{tabbing@} +@end example + + + +L'environnement @code{tabbing} fournit une technique pour aligner du +texte en colonnes. Il fonctionne en réglant des taquet et en tabulant +jusqu'à eux bien comme on le ferait sur une machine à écrire. Il +convient le mieux pour les cas où la largeur de chaque colonnne est +constante et connue d'avance. + +Cet environnement peut être rompu entre plusieurs pages, contrairement à +l'environnement @code{tabular}. + +Les commandes suivante peuvent être utilisée au sein d'un environnement @code{tabbing} : + +@ftable @code +@item \\ @r{(tabbing)} +Finit une ligne. + +@item \= @r{(tabbing)} +Règle un taquet à la position courante. + +@item \> @r{(tabbing)} +@findex \> +Avance au taquet suivant. + +@item \< +Place le texte qui suit à la gauche de la marge locale (sans changer +cette marge). Ne peut être utilisé qu'au début d'une ligne. + +@item \+ +Déplace la marge de gauche d'un taquet vers la droite pour la ligne +suivante et toutes celles qui suivent. + +@item \- +Déplace la marge de gauche d'un taquet vers la gauche pour la ligne +suivante et toutes celles qui suivent. + +@item \' @r{(tabbing)} +Déplace tout ce que vous avez tapé jusqu'alors dans la colonne courante, +c.-à-d.@: tout ce qui suit la plus récente commande @code{\>}, +@code{\<}, @code{\'}, @code{\\}, ou @code{\kill}, à la droite de la +colonne précédente, aligné à droite sur le taquet de la colonne +courante. + +@item \` @r{(tabbing)} +Vous perme de placer du texte justifié à droite sur n'importe quel +taquet, y compris le taquet 0. Toutefois, ne peut pas placer du texte à +la droite de la dernière colonne parce qu'il n'y a pas de taquet à cet +endroit. La commande @code{\`} déplace tout le texte qui la suit, +jusqu'à la commande @code{\\} ou @code{\end@{tabbing@}} qui termine la +ligne. + +@item \a @r{(tabbing)} +@findex \a' @r{(acute accent in tabbing)} +@findex \a` @r{(grave accent in tabbing)} +@findex \a= @r{(macron accent in tabbing)} +Dans un environnement @code{tabbing}, les commandes @code{\=}, @code{\'} +et @code{\`} ne produisent pas d'accents comme d'habitude +(@pxref{Accents}). À leur place, on utilise les commandes @code{\a=}, +@code{\a'} et @code{\a`}. + +@item \kill +Règles les taquets sans produire de texte. Fonctionne tout comme +@code{\\} à ceci près que la ligne courante est jetée au lieu de +produire une sortie. L'effet de toute commande @code{\=}, @code{\+} ou +@code{\-} dans cette ligne demeure en vigueur. + +@item \poptabs +@findex \poptabs +Restaure les positions de taquets sauvegardés par le dernier +@code{\pushtabs}. + +@item \pushtabs +Sauvegarde positions courantes de tous les taquets. C'est utile pour +changer temporairement les positions de taquets au milieu d'un +environnement @code{tabbing}. + +@item \tabbingsep +Distance à la gauche d'un taquet déplacé par @code{\'}. + +@end ftable + +Cet exemple compose un fonction en Pascal function dans un format +traditionnel : + +@example +\begin@{tabbing@} +function \= fact(n : integer) : integer;\\ + \> begin \= \+ \\ + \> if \= n $>$ 1 then \+ \\ + fact := n * fact(n-1) \- \\ + else \+ \\ + fact := 1; \-\- \\ + end;\\ +\end@{tabbing@} +@end example + + +@node table +@section @code{table} +@EnvIndex{table} +@cindex tableaux, créer +@cindex créer des tableaux + +Synopsis : + +@example + \begin@{table@}[@var{placement}] + @var{corps-du-talbeau} + \caption[@var{titreldt}]@{@var{titre}@} + \end@{table@} +@end example + +Une classe de flottants (@pxref{Floats}). Parce qu'ils ne peuvent pas +être coupés à cheval sur plusieurs pages, il ne sont pas composés en +séquence avec le texte normale, mais à la place sont « flottés » vers un +endroit convenable, tel que le sommet d'une page suivante. + +Pour les valeurs possibles de @var{placement} et leur effet sur +l'algorithme de placement des flottants, voir @ref{Floats}. + +Le corps du tableau est composé dans une @code{parbox} de largueur +@code{\textwidth} and ainsi il peut contenir du texte, des commandes, +etc. + +L'étiquette est optionnelle ; elle est utilisée pour les double renvois +(@pxref{Cross references}). +@findex \caption +La commande @code{\caption} spécifie la légende @var{texte} pour la +figure. La légende est numérotée par défaut. Si @var{titreldt} est +présent, il est utilisé dans la liste des talbeaux au lieu de @var{titre} +(@pxref{Tables of contents}). + +@example +\begin@{table@}[b] + \centering + \begin@{tabular@}@{r|p@{2in@}@} \hline + Un &Le plus solitaire des nombres \\ + Deux &Peut être aussi triste qu'un. + C'est le nombre le plus solitaire après le nombre un. + \end@{tabular@} + \caption@{Vertus cardinales@} + \label@{tab:VertusCardinales@} +\end@{table@} +@end example + + +@node tabular +@section @code{tabular} +@EnvIndex{tabular} +@cindex lignes dans des tableaux +@cindex aligner du texte dans des tableaux + +Synopsis : + +@example +\begin@{tabular@}[@var{pos}]@{@var{cols}@} +column 1 entry & column 2 entry ... & column n entry \\ +... +\end@{tabular@} +@end example + +@noindent +ou + +@example +\begin@{tabular*@}@{@var{largeur}@}[@var{pos}]@{@var{cols}@} +column 1 entry & column 2 entry ... & column n entry \\ +... +\end@{tabular*@} +@end example + +Ces environnements produisent une boîte consistant d'une séquence de +ligne horizontales. Chaque ligne consiste en des articles qui sont +alignés verticalement au sein de colonnes. Ci-après une illustration de +beaucoup des caractéristiques. + +@example +\begin@{tabular@}@{l|l@} + \textit@{Nom du joueur@} &\textit@{Coups de circuit de toute sa carrière@} \\ + \hline + Hank Aaron &755 \\ + Babe Ruth &714 +\end@{tabular@} +@end example + +Le format vertical de deux colonnes alignées à gauche, avec une barre +verticales entre elles, est spécifié par l'argument @code{@{l|l@}} de @code{tabular}. +@findex & +Les colonnes sont séparées avec une esperluette @code{&}. On crée un +filet horizontal entre deux ligne avec @code{\hline}. +@findex \\ @r{pour @code{tabular}} +La fin de chaque ligne est marquée avec une +double-contr'oblique @code{\\}. Cette @code{\\} est optionnelle après +la dernière ligne, à moins qu'une commande @code{\hline} suive, pour +mettre un filet sous le tableau. + + +Les arguments obligatoires et optionnels de @code{tabular} consistent +en : + +@table @code +@item largeur +Obligatoire pour @code{tabular*}, non autorisé pour +@code{tabular}. Spécifie la largeur de l' environnement +@code{tabular*}. Il doit y avoir de l'espace élastique entre les +colonnes, comme avec with @code{@@@{\extracolsep@{\fill@}@}}, de sorte à +permettre au tableau de se dilater ou contracter pour faire la largeur +spécifiée, sans quoi vous aurez probablement l'avertissement +@code{Underfull \hbox (badness 10000) in alignment ..}. + +@item pos +Optionnel. Spécifie la position verticale du tableau. La valeur par +défaut est d'aligner le tableau de sorte à ce que son centre vertical +s'accorder à la ligne de base du texte autour. Il y a deux autres +alignements possible : @code{t} aligne le tableau de sorte que la +première ligne s'accorde à la ligne de base du texte autour, et +@code{b} fait la même chose pour la dernière ligne du tableau. + + +Ceci n'a un effet que si il y a du texte autour de la table. Dans le cas +usuel d'un @code{tabular} seul au sein d'un environnement @code{center} +cette option ne fait aucune différence. + +@item cols +Obligatoire. Spécifie le formatage des colonnes. Il consiste en une +séquence des spécificateurs suivants, correspondant à la séquence des +colonnes et du matériel intercolonne. + +@table @code +@item l +Une colonne d'articles alignés à gauche. + +@item r +Une colonne d'article alignés à droite. + +@item c +Une colonne d'article centrés. + +@item | +Une ligne verticale s'étendant complètement sur la hauteur et profondeur +de l'environnement. + +@item @@@{@var{texte ou espace}@} +Ceci insère @var{texte ou espace} à cette position dans chaque ligne. Le +matériel @var{texte ou espace} est composé en mode LR. Ce texte est +fragile (@pxref{\protect}). + +Ce spécificateur est optionnel : à moins que vous mettiez dans votre +propre @@-expression alors les classes @code{book}, @code{article} et +@code{report} de @LaTeX{} mettent de chaque côté de chaque colonne un +espace de longueur @code{\tabcolsep}, qui par défaut vaut +@samp{6pt}. C'est à dire que par défaut des colonnes adjacentes sont +séparées de 12@dmn{pt} (ainsi @code{\tabcolsep} est un nom trompeur +puisque ce n'est pas la séparation entre des colonnes de +tableau). Aussi, par défaut un espace de 6@dmn{pt} vient après la +première colonne ainsi qu'après la dernière colonne, à moins que vous +placiez un @code{@@@{...@}} ou @code{|} à cet endroit. + +Si vous l'emportez sur la valeur par défaut et utilisez une expression +en @code{@@@{...@}} alors vous devez insérer tout espace désiré +vous-même, comme dans @code{@@@{\hspace@{1em@}@}}. + +Une expression vide @code{@@@{@}} élimine l'espace, y compris l'espace +au début ou à la fin, comme dans l'exemple ci-dessous où on veut que les +lignes du tableau soient alignées sur la marge de gauche. + +@example +\begin@{flushleft@} + \begin@{tabular@}@{@@@{@}l@} + .. + \end@{tabular@} +\end@{flushleft@} +@end example + +Cet exemple montre du texte, une virgule de séparation décimale, entre +les colonnes, arangé de sorte que les nombres dans la table sont alignés +sur cette virgule. + +@example +\begin@{tabular@}@{r@@@{$,$@}l@} + $3$ &$14$ \\ + $9$ &$80665$ +\end@{tabular@} +@end example + + +@findex \extracolsep +Une commande @code{\extracolsep@{@var{lrg}@}} au sein d'une expression +en @samp{@@@{@dots{}@}} a pour effet qu'une espace supplémentaire de +largeur @var{lrg} apparaît sur la gauche de toutes les colonnes +suivantes, jusqu'à contre-ordre d'une autre commande +@code{\extracolsep}. Contrairement aux à espace inter-colonnes +ordinaires, cette espace supplémentaire n'est pas supprimé par une +expression en @samp{@@@{@dots{}@}}. Une commande @code{\extracolsep} +peut uniquement être utilisée au sein d'une expression en +@samp{@@@{@dots{}@}} elle-même au sein de l'argument @code{cols}. + +@example +\begin@{center@} + \begin@{tabular*@}@{10cm@}@{l@@@{\ \ldots\extracolsep@{\fill@}@}l@} + Tomber sept fois, se relever huit + &c'est comme ça la vie ! + \end@{tabular*@} +\end@{center@} +@end example + +Pour insérer des commandes qui sont automatiquement exécutées avant une +colonne donnée, charger le paquetage @code{array} et utilisez le +spécificateur @code{>@{...@}}. +@c xx should fully explain array, tabularx, and all other base packages... + + +@item p@{@var{lrg}@} +Chaque cellule de la colonne est composée au sein d'une parbox de +largeur @var{lrg}. + +Note que les sauts de ligne de type double-contr'oblique @code{\\} ne +sont pas permis au sein d'une telle cellule, sauf à l'intérieur d'un +environnement comme @code{minipage}, @code{array}, ou @code{tabular}, +ou à l'intérieur d'une @code{\parbox} explicite, ou dans la portée d'une +déclaration @code{\centering}, @code{\raggedright}, ou +@code{\raggedleft} (quand elles sont utilisée au sein d'une cellule de +colonne en @code{p} ces déclaration doivent apparaître entre accolade, +comme dans @code{@{\centering .. \\ ..@}}. Sans quoi @LaTeX{} prendra la +double contr'oblique comme une fin de ligne. + +@item *@{@var{num}@}@{@var{cols}@} +Équivalent à @var{num} copies de @var{cols}, où @var{num} est un entier +positif et @var{cols} est toute liste de spécificateurs. Ainsi +@code{\begin@{tabular@}@{|*@{3@}@{l|r@}|@}} équivaut à +@code{\begin@{tabular@}@{|l|rl|rl|r|@}}. Notez que @var{cols} peut +contenir une autre expression en @code{*@{@dots{}@}@{@dots{}@}}. + +@end table +@end table + +Paramètres qui contrôlent le formatage : +@c xx defaults, own node (xref from array)? + +@ftable @code +@item \arrayrulewidth +Une longueur qui est l'épaisseur du filet créé par @code{|}, +@code{\hline}, et @code{\vline} au sein des environnements +@code{tabular} et @code{array}. La valeur par défaut est @samp{.4pt}. On +peut la changer comme dans +@code{\setlength@{\arrayrulewidth@}@{0.8pt@}}. + +@item \arraystretch +Un facteur par lequel l'espacement entre les lignes au sein des +environnement @code{tabular} et @code{array} est multiplié. La valeur +par défaut est @samp{1} pour aucune dilatation/contraction. On peut la +changer comme dans @code{\renewcommand@{\arraystretch@}@{1.2@}}. + +@item \doublerulesep +Une longueur qui est la distance ente les filets verticaux produit par +le spécificateur @code{||}. +@c - vincentb1 pourquoi supprimer le texte: au sein des environnements +@c - @code{tabular} et @code{array} +La valeur par défaut est @samp{2pt}. + +@item \tabcolsep +Une longueur qui est la moitié de l'espace entre les colonnes. La valeur +par défaut est @samp{6pt}. On peut la changer avec @code{\setlength} + +@end ftable + +Les commandes suivantes peuvent être utilisées à l'intérieur du corps d'un +environnement @code{tabular} : + +@menu +* \multicolumn:: Faire qu'un article s'étende sur plusieurs colonnes. +* \cline:: Dessiner une ligne horizontale s'étendant sur quelques colonnes. +* \hline:: Dessiner une ligne horizontale s'étendant sur toutes les colonnes. +* \vline:: Dessiner une ligne verticale. +@c - vincentb1 ce n'est pas le bon menu où mettre ça: * tabularx:: Un +@c environnement qui étend les types de colonne de @code{tabular*}. +@end menu + + +@node \multicolumn +@subsection @code{\multicolumn} +@findex \multicolumn + +Synopsis : +@example +\multicolumn@{@var{nbrecols}@}@{@var{patron}@}@{@var{texte}@} +@end example + +Fabrique une entrée de @code{array} ou @code{tabular} fusionnée sur +plusieurs colonnes. Le premier argument, @var{nbrecols} spécifie le +nombre de colonnes sur lesquelles s'étend la fusion. Le second argument, +@var{patron}, est obligatoire et spécifie le format de l'entrée ; +notamment @code{c} pour centré, @code{l} pour aligné à gauche, @code{r} +pour aligné à droite. Le troisième argument, @var{texte} spécifie le +texte à mettre dans l'entrée. + +Dans l'exemple suivant les trois première colonnes sont fusionnées en le +titre unique @samp{Nom}. + +@example +\begin@{tabular@}@{lccl@} + \textit@{ID@} &\multicolumn@{2@}@{c@}@{\textit@{Nom@}@} &\textit@{Âge@}\\ \hline % ligne 1 + 978-0-393-03701-2 &O'Brian &Patrick &55 \\ % ligne two + ... +\end@{tabular@} +@end example + +On compte comme colonne chaque partie du patron @var{patron} de +l'environnement @code{array} ou @code{tabular} qui, à l'exception de la +première, commence par @code{l}, @code{c}, @code{r}, ou @code{p}. Ainsi +à partir de @code{\begin@{tabular@}@{|r|ccp@{4cm@}|@}} les partie sont +@code{|r|}, @code{c}, @code{c}, et @code{p@{1.5in@}|}. + +L'argument @var{patron} l'emporte sur la spécification par défaut de +zone inter-colonne de l'environnement @code{array} ou @code{tabular} +contigüe à cette entrée multi-colonne. Pour affecter cette zone, cet +argument peut contenir des barre verticale @code{|} indiquant le +placement de filets verticaux, et d'expression @code{@@@{...@}}. Ainsi +si @var{patron} est @samp{|c|} alors l'entrée multi-colonne est centrée +et un filet vertical la précède et la suit dans les espaces intercolonne +de part et d'autre. Ce tableau nous permet de décrire en détail le +comportement exact. + +@example +\begin@{tabular@}@{|cc|c|c|@} + \multicolumn@{1@}@{r@}@{w@} % entrée un + &\multicolumn@{1@}@{|r|@}@{x@} % entrée deux + &\multicolumn@{1@}@{|r@}@{y@} % entrée trois + &z % entrée quatre +\end@{tabular@} +@end example + +Avant la première entrée il n'y a pas de filet verticale en sortie parce +que le @code{\multicolumn} a le spécificateur @samp{r} dans @var{patron} +sans barre verticales initiale. Entre les entrée un et deux il y a un +filet vertical ; en effet bien que le premier @var{patron} ne se termine +pas par une barre verticale, le second @var{patron} en a une à son +commencement. Entre la deuxième et la troisième entré il y a un seul +filet vertical ; bien que le @var{patron} dans les deux +@code{multicolumn} correspondant demandent un filet vertical, vous n'en +obtenez qu'un seul. Entre les entrée trois et quatre il n'y a aucun +filet vertical ; la spécification par défaut en demande un mais le +@var{patron} dans le @code{\multicolumn} de la troisième entrée n'en +demande pas, et cela l'emporte. Finalement, à la suite de la quatrième +entrée il y a un filet vertical à cause de la spécification par défaut. + +Le nombre de colonnes fusionnées @var{nbrecols} peut être 1. En plus de +donner la possibilité de changer l'alignement horizontal, ceci est aussi +utile pour l'emporter pour l'une des ligne sur la définition +@code{tabular} par défaut de la zone inter-colonne, y compris concernant le +placement des filets verticaux. + +Dans l'exemple ci-dessous, dans la définition @code{tabular} de la +première colonne on spécifie par défaut de justfier, mais au sein de la +première ligne l'entrée est centrée avec +@code{\multicolumn@{1@}@{c@}@{\textsc@{Période@}@}}. De même au sein de +la première ligne, les deuxième et troisième colonnes sont fusionnées +entre elle avec @code{\multicolumn@{2@}@{c@}@{\textsc@{Intervalle@}@}}, +l'emportant sur la spécification pour centrer ces deux colonnes sur le +trait d'union au sein de la plage de dates. + +@example +\begin@{tabular@}@{l|r@@@{-@}l@} + \multicolumn@{1@}@{c@}@{\textsc@{Période@}@} + &multicolumn@{2@}@{c@}@{\textsc@{Dates@}@} \\ \hline + Baroque &1600 &1760 \\ + Classique &1730 &1820 \\ + Romantique &1780 &1910 \\ + Impressioniste &1875 &1925 +\end@{tabular@} +@end example + +Noter ue bien que la spécification @code{tabular} par défaut place un +filet vertical etre la première et la deuxième colonne, du fait qu'il +n'y pas pas de barre verticale dans aucun des patrons @var{patron} des +commandes @code{\multicolumn} des deux premières colonne, alors aucun +filet n'apparaît sur la première ligne. + + +@node \cline +@subsection @code{\cline} +@findex \cline + +Synopsis : + +@example +\cline@{@var{i}-@var{j}@} +@end example + +La commande @code{\cline} dessine des lignes horizontales à travers les +colonnes spécifiées en arguments obligatoires, en commençant dans la +@var{i} et finissant dans la colonne @var{j}. + +@node \hline +@subsection @code{\hline} +@findex \hline + +La commande @code{\hline} dessine une ligne horizontale de la largeur de +l'environnement @code{tabular} ou @code{array} surjacent. Elle est la +plupart du temps utilisé pour dessiner une ligne au sommet, bas, et +entre les lignes d'un tableau. + + +@node \vline +@subsection @code{\vline} +@findex \vline + +La commande @code{\vline} dessine une ligne verticale s'étendant sur la +totalité de la hauteur et de la profondeur de sa ligne. Une commande +@code{\hfill} peut être utilisée pour déplacer cette ligne verticale +vers le bord de la colonne. La commande @code{\vline} peut aussi être +utilisée dans une expression @code{@@@{@dots{}@}}. + +@c @node tabularx +@c @comment node-name, next, previous, up +@c @subsection @code{tabularx} + + +@node thebibliography +@section @code{thebibliography} + +@EnvIndex{thebibliography} +@cindex bibliography, creating (manually) + +Synopsis : + +@example +\begin@{thebibliography@}@{@var{étiquette-la-plus-large}@} +\bibitem[@var{étiquette}]@{@var{clef_de_cite}@} +... +\end@{thebibliography@} +@end example + +L'environnement @code{thebibliography} produit une bibliographie ou une +liste de références. + +Dans la classe @code{article}, cette liste de références est intitulée +« Réferences » ; dans la classe @code{report}, elle est intitulée +« Bibliographie ». Vous pouvez changer le titre (dans les classes standardes) +en redéfinissant la commande @code{\refname}. Par exemple, cela +l'élimine complètement : + +@example +\renewcommand@{\refname@}@{@} +@end example + +L'argument obligatoire @var{étiquette-la-plus-large} est un texte qui, +lorsqu'il est composé, est aussi large que la plus large des étiquettes +d'article produit pas les commandes @code{\bibitem}. C'est typiquement +donné comme @code{9} pour des bibliographies de moins de 10 références, +@code{99} pour celles qui en on moins de 100, etc. + +@menu +* \bibitem:: Spécifier un article de bibliographie. +* \cite:: Faire référence à un article de bibliographie. +* \nocite:: Inclure un article dans la bibliographie. +* Utilisation de BibTex: Using BibTeX. Génération automatique de bibliographies. +@end menu + + +@node \bibitem +@subsection @code{\bibitem} + +@findex \bibitem + +Synopsis : +@example +\bibitem[@var{étiquette}]@{@var{clef_de_cite}@} +@end example + +La commande @code{\bibitem} génère une entrée étiquetée par +@var{étiquette}. Si l'argument @var{étiquette} est omis, un numéro est +automatiquement généré en utilisant le compteur @code{enumi}. L'argument +@var{clef_de_cite} est une +@cindex clef de référence bibiliographique +@cindex référence bibiliographique, clef +@dfn{clef de référence bibiliographique} consistant +en une séquence quelconque de lettres, chiffres, et signes de +ponctuation ne contenant aucune virgule. + +Cette commande écrit une entrée dans le fichier @file{.aux}, et cette +entrée contient les @var{étiquette} et @var{clef_de_cite} de l'article +considéré. Lorsque le fichier @file{.aux} est lu par la commande +@code{\begin@{document@}}, l'@var{étiquette} de l'article est associée à +sa @var{clef_de_cite}, ce qui a pour effet que toute référence à +@var{clef_de_cite} avec une commande @code{\cite} (@pxref{\cite}) +produit l'@var{étiquette} associée. + + +@node \cite +@subsection @code{\cite} + +@findex \cite + +Synopsis : + +@example +\cite[@var{subcite}]@{@var{clefs}@} +@end example + +L'argument @var{clefs} est une liste d'une ou plus de clefs de +références bibliographiques (@pxref{\bibitem}), séparées par des +virgules. Cette commande génère une référence bibliographique au sein du +textes contenant les étiquettes associées aux clefs contenues dans +@var{clefs} par les entrées respectives au sein du fichier @file{.aux}. + +Le texte de l'argument optionnel @var{subcite} apparaît après +l'étiquette de référence. Par exemple, @code{\cite[p.~314]@{knuth@}} +pourrait produire @samp{[Knuth, p. 314]}. + + +@node \nocite +@subsection @code{\nocite} +@findex \nocite + +Synopsis : + +@example +@code{\nocite@{@var{clefs}@}} +@end example + +La commande @code{\nocite} ne produit aucun texte, mais écrit +@var{clefs}, ce qui est une liste d'une ou plusieurs clefs de référence +bibliograhique dans le fichier @file{.aux}. + + +@node Using BibTeX +@subsection Utilisation de Bib@TeX{} + +@cindex utilisation de Bib@TeX{} +@cindex bib@TeX{}, utilisation +@cindex bibliographie, créer (automatiquement) +@findex \bibliographystyle +@findex \bibliography + +Si vous utilisez le programme Bib@TeX{} d'Oren Patashnik (ce qui est +fortement recommandé si vous avez besoin d'une bibliographie de plus +d'un ou deux titre) pour mainteninr votre bibliographie, vous n'utilisez +pas l'environnement @code{thebibliography} +(@pxref{thebibliography}). Au lieu de cela, vous incluez les lignes : + +@example +\bibliographystyle@{@var{stylebib}@} +\bibliography@{@var{ficbib1},@var{ficbib2}@} +@end example + +La commande @code{\bibliographystyle} ne produit aucune sortie en +elle-même. En revanche, elle définit le style dans lequel la +bibliographie est à produite : @var{stylebib} fait référence à un +fichier @var{stylebib}@file{.bst} définissant l'aspect que doivent avoir +vos référence bibliographique. Les nom @var{stylebib} standards +distribués avec Bib@TeX{} sont : + +@table @code +@item alpha +Classé alphabetiquement. Les étiquettes sont formées à partir du nom de +l'auteur et de l'année de publication. +@item plain +Classé alphabetiquement. Les étiquettes sont des numéros. +@item unsrt +Comme @code{plain}, mais les entrées sont dans l'ordre où les références +y sont faites dans le texte. +@item abbrv +Comme @code{plain}, mais les étiquettes sont plus compactes. +@end table + +De plus, de nombreux autres styles Bib@TeX{} existent faits sur mesure pour +satisfaire les exigences de diverses publications. Voir +@url{http://mirror.ctan.org/biblio/bibtex/contrib}. + +La commande @code{\bibliography} est ce qui produit pour de bon la +bibliographie. L'argument de @code{\bibliography} fait référence aux +fichiers nommés @file{@var{ficbib1}.bib}, @file{@var{ficbib2}.bib}, +@dots{}, qui sont censés contenir votre base de donnée au format +Bib@TeX{}. Seules les entrées désignées par les commandes @code{\cite} +ou @code{\nocite} sont listées dans la bibliographie. + + +@node theorem +@section @code{theorem} + +@EnvIndex{theorem} +@cindex théorèmes, composition des + +Synopsis : + +@example +\begin@{theorem@} +@var{texte-théorème} +\end@{theorem@} +@end example + +L'environnement @code{theorem} produit « Théorème @var{n} » en gras +suivi de @var{texte-théorème}, où les possibilité de numérotation pour +@var{n} sont décrites par @code{\newtheorem} (@pxref{\newtheorem}). + + +@node titlepage +@section @code{titlepage} + +@EnvIndex{titlepage} +@cindex fabriquer une page de titre +@cindex pages de titre, création + +Synopsis : + +@example +\begin@{titlepage@} +@var{texte} +\end@{titlepage@} +@end example + +L'environnement @code{titlepage} crée une page de titre, c'est à dire +une page sur laquelle ne sont inscrit aucun numéro de page ou libellé de +rubrique. Il entraîne aussi que la page suivante a le numéro un. Le +formatage de la page de titre vous est laissé. La commande @code{\today} +peut être utile sur les pages de titre (@pxref{\today}). + +Vous pouvez utiliser la commande @code{\maketitle} (@pxref{\maketitle}) +pour produire une page de titre standarde sans utiliser l'environnement +@code{titlepage}. + + +@node verbatim +@section @code{verbatim} + +@EnvIndex{verbatim} +@cindex texte verbatim +@cindex simuler du texte tapuscrit +@cindex texte tapuscrit, simulation de +@cindex code source, composer du +@cindex source logiciel, composer du + +Synopsis : + +@example +\begin@{verbatim@} +@var{literal-texte} +\end@{verbatim@} +@end example + +L'environnement @code{verbatim} est un environnement qui fabrique des +paragraphes dans lequel @LaTeX{} produit exactement ce qui vous y taez ; +par exemple le caractère @code{\} produit @samp{\} à l'impression . Il, +fait de @LaTeX{} une machine à écrire, c.-à-d.@: que le retour chariot +et les blancs y ont un tel effet. + +L'environnement @code{verbatim} utilise une police de type machine à +écrire à chasse fixe (@code{\tt}). + +@menu +* \verb:: La forme macro de l'environnement @code{verbatim}. +@end menu + +@node \verb +@subsection @code{\verb} + +@findex \verb +@cindex texte verbatim, en-ligne + +Synopsis : + +@example +\verb@var{car}@var{texte-littéral}@var{car} +\verb*@var{car}@var{texte-littéral}@var{car} +@end example + +La commande @code{\verb} compose @var{texte-littéral} comme il est +entré, en incluant les caractères spéciaux et les espaces, en utilisant +la police tapuscrit (@code{\tt}). Aucun espaces n'est autorisé entre +@code{\verb} ou @code{\verb*} et le délimiteur @var{car} qui marque le +début et la fin du texte verbatim. Le délimiteur ne doit pas aparaître +dans le @var{texte-littéral}. + +@cindex espace visible +La forme étoilée (en @code{*}) diffère seulement en ce que les espaces +sont tapés avec un caractère « espace visible ». +@tex +(Nommément, {\tt\char`\ }). +@end tex + + +@node verse +@section @code{verse} +@EnvIndex{verse} +@cindex poésie, un environnement pour la + +Synopsis : + +@example +\begin@{verse@} +@var{line1} \\ +@var{line2} \\ +... +\end@{verse@} +@end example + +L'environnement @code{verse} est conçu pour la poésie, bien que vous +pouvez lui trouver d'autres usages. + +@findex \\ @r{pour @code{verse}} +Les marges sont renfoncées sur la gauche et la droite, les paragraphes ne +le sont pas, et le texte n'est pas justifié. Séparez le ligne de chaque +strophe avec @code{\\}, et utilisez une ou plusieurs lignes vides pour +séparer les strophes. + + +@node Line breaking +@chapter Saut à la ligne +@cindex saut à la ligne +@cindex sauter à la ligne + +La première chose que @LaTeX{} fait lorsqu'il traite du texte ordinaire +est de traduire votre fichier d'entrée en une séquence de glyphes et +d'espaces. Pour produire un document imprimé, cette séquence doit être +rompue en lignes (et ces lignes doivent être rompues en pages). + +D'ordinaire @LaTeX{} effectue la rupture de ligne (et de page) pour +vous, mais dans certains environnements, vous faites la rupture +vous-même avec la commande @code{\\}, et vous pouvez toujours forcer +manuellement les ruptures. + +@menu +* \\:: Commencer une nouvelle ligne. +* \obeycr & \restorecr:: Faire que chaque ligne d'entrée commence une nouvelle ligne de sortie. +* \newline:: Sauter à la ligne +* \- (césure): \- (hyphenation). Insérer une césure explicite. +* \discretionary:: Insérer une crésure explicite en contrôlant le caractère d'union. +* \fussy:: Être pointilleux sur le passage à la ligne. +* \sloppy:: Être tolérant sur le passage à la ligne. +* \hyphenation:: Dire à @LaTeX{} comment gérer la césure d'un mot. +* \linebreak & \nolinebreak:: Forcer & éviter les saut à la ligne. +@end menu + + +@node \\ +@section @code{\\} + +@findex \\ @r{force un saut de ligne} +@cindex nouvelle ligne, commencer une +@cindex saut de ligne, forcer + +Synopsis : + +@example +\\[@var{espaceenplus}] +@end example + +ou + +@example +\\*[@var{espaceenplus}] +@end example + +Commencer une nouvelle ligne. L'argument optionnel @var{espaceenplus} +spécifie l'espace supplémentaire vertical à insérer avant la ligne +suivante. Ceci peut être une longueur négative. Le texte avant le saut +est composé à sa longueur normale, c.-à-d.@: qu'il n'est pas dilaté pour +remplir la largeur de la ligne. + +Les sauts de ligne explicites au sein du corps de texte sont inhabituels +en @LaTeX{}. en particulier, pour commencer un nouveau paragraphe +laissez plutôt une ligne à blanc. Cette commande est utilisée +principalement en dehors du flux principal de texte comme dans un +environnement @code{tabular} ou @code{array}. + +Dans des circonstances ordinaires (par ex.@: en dehors d'une colonne +spécifiée par @code{p@{...@}} dans un environnement @code{tabular}) la +commande @code{\newline} est un synonyme de @code{\\} +(@pxref{\newline}). + +En plus de commencer une nouvelle ligne, la forme étoilée @code{\\*} dit +à @LaTeX{} de ne pas commencer une nouvelle page entre les deux lignes, +en émettant un @code{\nobreak}. + +@example +\title@{Mon histoire~: \\[7mm] + un conte pathétique@} +@end example + + +@node \obeycr & \restorecr +@section @code{\obeycr} & @code{\restorecr} +@findex \obeycr +@findex \restorecr +@cindex saut de ligne, sortie semblable à l'entrée pour le + +La commande @code{\obeycr} a pour effet qu'un retour chariot dans le +fichier d'entrée (@samp{^^M}, internement) soit traité de la même façon +que @code{\\} (suivi d'un @code{\relax}). Ainsi chaque passage à la +ligne dans l'entrée est aussi un passage à la ligne dans la sortie. + +@code{\restorecr} restaure le comportement normal vis à vis des saut de +ligne. + + +@node \newline +@section @code{\newline} + +@findex \newline +@cindex nouvelle ligne, commencer une (mode paragraphe) +@cindex saut de ligne + +Dans du texte ordinaire ceci est équivalent à une double-contr'oblique +(@pxref{\\}) ; cela rompt la ligne, sans dilatation du texte le +précéndent. + +Au sein d'un environnement @code{tabular} ou @code{array}, dans une +colonne avec un specificateur produisant une boîte paragraphe, comme +typiquement @code{p@{..@}}, @code{\newline} insère un saut de ligne au +sein de la colonne, c.-à-d.@: insère un saut de ligne à l'intérieur de +la colonne, c.-à-d.@: qu'il ne rompt pas la ligne entière. Pour rompre +la ligne entière utilisez @code{\\} ou son équivalent +@code{\tabularnewline}. + +L'exemple suivant écrit @samp{Nom~:} et @samp{Adresse~:} comme deux +ligne ain sein d'une seule cellule du tableau. + +@example +\begin@{tabular@}@{p@{2.5cm@}@{\hspace@{5cm@}@}p@{2.5cm@}@} + Nom~: \newline Adresse~: &Date~: \\ \hline +\end@{tabular@} +@end example + +La @samp{Date~:} sera alignée sur la ligne de base de @samp{Nom~:}. + +@node \- (hyphenation) +@section @code{\-} (césure à gré) +@findex \- @r{(césure)} +@cindex césure, forcer + +La commande @code{\-} commande dit à @LaTeX{} qu'il peut faire une +césure du mode à cet endroit. @LaTeX{} est très bon en ce qui concerne +les césures, et il trouve la plupart des points corrects de césure, tout +en n'en utilisant presque jamais un incorrect. La commande @code{\-} est +commande est utilisée pour les cas exceptionnels. + +Quand vous insérez des commandes @code{\-} dans un mot, le mot ne pourra +avoir de césure qu'à ces endroit et non dans aucun des points de césure +que @LaTeX{} aurait pu choisir sinon. + +@node \discretionary +@section @code{\discretionary} (point de césure généralisé) +@cindex crésure, discrétionnaire +@cindex discrétionnaire, césure + +Synopsis : + +@example +\discretionary@{@var{avant-saut}@}@{@var{après-saut}@}@{@var{sans-saut}@} +@end example + +La commande @code{\discretionary} permet de contrôler finement la césure +dans les cas où ne suffisent ni le contrôle standard de la césure fait +l'algorithme de césure de @TeX{} et les règles de césures données par les +paquetages de gestion linguistiques, ni les moyens de contrôle +explicites offerts par les commandes @code{\hyphenation} +(@pxref{\hyphenation}) et @code{\-} (@pxref{\- (hyphenation),\- (césure +à gré)}). + +@code{\discretionary} indique qu'un saut de ligne est possible à cet +endroit. Dans le cas d'un saut de ligne, le texte @var{avant-saut} est +placé immédiatement avant le saut, et le texte @var{après-saut} +immédiatement après. Dans le cas sans saut de ligne le texte +@var{sans-saut} est imprimé. + +Les arguments de @code{\discretionary} ne peuvent contrenir que des +caractères, des boîtes ou des crénages. + +L'usage typique de @code{\discretionary} est par exemple de contrôler la +césure au sein d'une formule mathématique en mode ligne (voir aussi +@ref{Math miscellany,Miscellanées mathématique (entrée \*)}). Ci-dessous +un exemple de contrôle de la césure au sein d'une adresse réticulaire, +où l'on autorise la césure sur les obliques mais en utilisant une +contr'oblique violette en lieu de trait d'union : + +@example +\documentclass@{article@} +\usepackage[T1]@{fontenc@} +\usepackage[utf8]@{inputenc@} +\usepackage@{xcolor@} +\usepackage@{hyperref@} +\usepackage@{french@} +\newcommand*\DiscrSlash@{\discretionary@{\mbox@{\textcolor + @{purple@}@{\textbackslash@}@}@}@{/@}@{/@}@} +\begin@{document@} +Allez donc à \href@{http://une/tr\%c3\%A8s/tr\%c3\%A8s/longue% + /mais/vraiment/tr\%c3\%A8s/longue/adresse/r\%C3\%A9ticulaire% + /index.html@}@{http://une\DiscrSlash très\DiscrSlash très\DiscrSlash + longue\DiscrSlash mais\DiscrSlash vraiment\DiscrSlash + très\DiscrSlash longue\DiscrSlash adresse\DiscrSlash + réticulaire\DiscrSlash index.html@} +\end@{document@} +@end example + + + + +@node \fussy +@section @code{\fussy} +@findex \fussy + +La déclaration @code{\fussy} (ce qui est le réglage par défaut) a pour +effet que @TeX{} fait le difficile à propos des saut de ligne. Ceci +évite d'ordinaire trop d'espace entre les mots, au prix +d'occasionnellement une boîte trop pleine (@samp{overfull \hbox}). + +Cette commande annule l'effet d'une commande @code{\sloppy} précédente +(@pxref{\sloppy}). + + +@node \sloppy +@section @code{\sloppy} + +La déclaration @code{\sloppy} a pour effet que @TeX{} fasse moins le +difficile à propos des sauts de ligne. Ceci evite les boîtes trop pleines, +au prix d'un espacement lâche entre les mots. + +L'effet dure jusqu'à la prochaine commande @code{\fussy} (@pxref{\fussy}). + + +@node \hyphenation +@section @code{\hyphenation} +@findex \hyphenation +@cindex césure, définir + +Synopsis : + +@example +\hyphenation@{@var{mot-un} @var{mot-deux}@} +@end example + +La commande @code{\hyphenation} déclare les points de césure autorisé +avec un caratère @code{-} au sein des mots donnés. Les mots sont séparés +par des espaces. @TeX{} ne fera de césure que si le mot correspond +exactement, aucune désinence n'est essayée. Des commandes +@code{\hyphenation} mutliple s'accumulent. Voici quelques exemples en +anglais (les motifs de césure par défaut de @TeX{} manquent les césures +de ces mots) : + +@example +\hyphenation@{ap-pen-dix col-umns data-base data-bases@} +@end example + + +@node \linebreak & \nolinebreak +@section @code{\linebreak} & @code{\nolinebreak} +@findex \linebreak +@findex \nolinebreak +@cindex sauts de ligne, forcer +@cindex sauts de ligne, empêcher + +Synopsis : + +@example +\linebreak[@var{priorité}] +\nolinebreak[@var{priorité}] +@end example + +Par défaut, la commande @code{\linebreak} (@code{\nolinebreak}) force +(empêche) un saut de ligne à la position courante. Pour +@code{\linebreak}, les espaces de la ligne sont dilatés jusqu'à ce +qu'elle s'étende jusqu'à la marge de droite, comme d'habitude. + +Avec l'argument optionnel @var{priorité}, vous pouvez convertir la +commande d'une simple demande à une requête. La @var{priorité} doit être +un nombre compris entre 0 et 4. Plus ce nombre est grand, et plus la +requête est insistante. + + +@node Page breaking +@chapter Saut de page +@cindex saut de page +@cindex pages, saut + +@LaTeX{} commence de nouvelles pages de façon asynchrone, lorsque +suffisamment de matériel a été accumulé pour remplir une +page. D'ordinaire ceci se produit automatiquement, mais parfois on peut +désirer influencer les sauts. + +@menu +* \cleardoublepage:: Commence une nouvelle page de droite. +* \clearpage:: Commence une nouvelle page. +* \newpage:: Commence une nouvelle page. +* \enlargethispage:: Agrandit d'un peu la page courante. +* \pagebreak & \nopagebreak:: Forcer & éviter les sauts de page. +@end menu + + +@node \cleardoublepage +@section @code{\cleardoublepage} + +@findex \cleardoublepage +@cindex commencer une page de droite + +La commande @code{\cleardoublepage} finit la page courante et fait que +@LaTeX{} imprime tous les flottants, tableaux et figures, qui sont +apparus en entrée jusqu'à ce point et sont en attente. Dans le cas d'une +impression en style @code{twoside}, elle fait aussi que la nouvelle page +et une page de droite (numérotée impaire), en produisant si nécessaire +une page à blanc. + + +@node \clearpage +@section @code{\clearpage} +@findex \clearpage +@cindex débourrer les flottant et commencer une page +@cindex commencer une nouvelles page et débourrer les flottant + +La commande @code{\clearpage} finit la page actuelle et fait que +@LaTeX{} imprime tous les flottants, tableaux et figures, qui sont +apparus en entrée jusqu'à ce point et sont en attente. + + +@node \newpage +@section @code{\newpage} +@findex \newpage +@cindex nouvelle page, commencer +@cindex commencer une nouvelle page + +La commande @code{\newpage} finit la page courante, mais ne débourre pas +tous les flottants (@pxref{\clearpage}). + + +@node \enlargethispage +@section @code{\enlargethispage} +@findex \enlargethispage +@cindex agrandir la page courante + +@code{\enlargethispage@{size@}} + +@code{\enlargethispage*@{size@}} + +Agrandit la @code{\textheight} de la page courante de la quantité +spécifiée ; par exemple @code{\enlargethispage@{\baselineskip@}} permet +d'avoir une ligne de plus. + +La forme étoilée essaie de comprimer le matériel sur la page autant que +possible. Ceci est normalement utilisé en même temps qu'un +@code{\pagebreak} explicite. + + +@node \pagebreak & \nopagebreak +@section @code{\pagebreak} & @code{\nopagebreak} +@findex \pagebreak +@findex \nopagebreak +@cindex saut de page, forcer +@cindex saut de page, empécher + +Synopsis : + +@example +\pagebreak[@var{priorité}] +\nopagebreak[@var{priorité}] +@end example + +Par défaut, la commande @code{\pagebreak} (@code{\nopagebreak}) force +(empèche) un saut de page à la position courante. Avec +@code{\pagebreak}, l'espace verticale sur la page est dilatée où c'est +possible de sorte à s'étendre jusqu'à la marge inférieure normale. + +Avec l'argument optionnel @var{priorité}, vous pouvez convertique la +commande @code{\pagebreak} d'une demande à une exigence. Le nombre doit +être compris entre 0 et 4. Plus grand est le nombre, et plus insistant +est l'exigence. + + +@node Footnotes +@chapter Note en bas de page +@cindex note en bas de page, créer +@cindex bas de page, créer des notes + +Mettez une note en bas de la page courante avec la commande +@code{\footnote} comme ci-dessous. + +@example +Noël Coward a dit plaisamment que lire une note en bas de page, c'est +comme devoir descendre répondre à la porte d'entrée alors qu'on est en +train de faire l'amour\footnote@{Je ne peux pas le savoir ; je ne lis +jamais les notes en bas de page@} +@end example + +Vous pouvez placer beaucoup de notes en bas de page dans une page. Si le +texte devient trop long alors il est continué sur la page suivante. + +Vous pouvez aussi produire des notes en bas de page en combinant les +commandes @code{\footnotemark} et @code{\footnotetext}, ce qui est +utiles dans des circonstances speciales. + +@menu +* \footnote:: Insérer une note en bas de page. +* \footnotemark:: Insérer la marque seulement d'une note en bas de page. +* \footnotetext:: Insérer le texte seulement d'une note en bas de page. +* Notes dans un tableau: Footnotes in a table. Notes de tableau. +* Notes en bas de page dans les titres de rubriques: Footnotes in section headings. Titre de chapitre ou de rubrique. +* Paramètres des notes en bas de page: Footnote parameters. Les paramètre pour formatter les notes en bas de page. +@end menu + + +@node \footnote +@section @code{\footnote} + +@findex \footnote + +Synopsis : + +@example +\footnote[@var{numéro}]@{@var{texte}@} +@end example + +Place en bas de la page courante une note @var{texte} numérotée. + +@example +Il y a plus d'un milier de notes en bas de page dans \textit@{Histoire +Du Déclin Et De La Chute De L'empire Romain@}\footnote@{Après la lecture +d'une version préléminaire, David Hume s'est plaint, « On souffre d'un +fléau avec ces notes, selon la méthode acutelle d'imprimer le livre » et +il suggera qu'elles « ne soient seulement imprimée dans la marge ou en +bas de page »@} d'Édouard Gibbon. +@end example + +L'argument optionnel @var{numéro} vous perme de spécifier le numéro de +la note. Le compteur @code{footnote} donnant le numéro de la note n'est +pas incrémenté si vous utilisez cette option, mais l'est dans le cas +contraire. + +@cindex note en bas de page, symboles au lieu de numéros +@findex \fnsymbol@r{, et note en bas de page} +@findex \@@fnsymbol +Changez l'aspect que @LaTeX{} donne au compteur de note en bas de page +avec quelque chose du genre de +@code{\renewcommand@{\thefootnote@}@{\fnsymbol@{footnote@}@}}, ce qui +utilise une séquence de symboles (@pxref{\alph \Alph \arabic \roman +\Roman \fnsymbol}). Pour rendre ce changement global mettez cela dans +le préambule. Si vous faite ce changement local alors vous désirerez +sans doute réinitialiser le compte avec +@code{\setcounter@{footnote@}@{0@}}. Par défaut @LaTeX{} utilise des +nombres arabes. + + +@c - @node Symbolic footnotes +@c - @section Note en bas de page symboliques +@c - +@c - @cindex notes en bas de page, symboliques au lieu de numérotées +@c - Si vous voulez utiliser des symboles pour les notes en bas de page, +@c - plutôt que des numéros croissants, redéfinissez @code{\thefootnote} +@c - comme ceci : +@c - +@c - @example +@c - \renewcommand@{\thefootnote@}@{\fnsymbol@{footnote@}@} +@c - @end example +@c - +@c - @findex \fnsymbol@r{, et les notes en bas de page} +@c - @findex \@@fnsymbol +@c - La commande @code{\fnsymbol} produit une série prédéfinie de symboles +@c - (@pxref{\alph \Alph \arabic \roman \Roman \fnsymbol}). Si vous voulez +@c - utiliser un symbol différent comme marque de note en bas de page, il +@c - vous faut aussi redéfinir @code{\@@fnsymbol}. +@c - @c vincentb1: why ``also'' (aussi), isn't that sufficient to redefine \@fnsymbol ? + +Le comportement par défaut de @LaTeX{} met beaucoup de restrictions sur +l'endroit où l'on peut utiliser une @code{\footnote} ; par exemple, vous +ne pouvez pas l'utiliser dans l'argument d'une commande de rubricage +telle que @code{\chapter} (elle ne peut être utilisée seulement en mode +paragraphe le plus externe). Il y a des contournements ; voir les +rubriques suivantes. +@c xx mention packages that fix this + +@cindex Notes en bas de page, au sein d'une minipage +@cindex mpfootnote, compteur +Au sein d'un environnement @code{minipage} la commande @code{\footnote} +utilise le compteur @code{mpfootnote} au lieu de @code{footnote}, de +sorte que les notes sont numérotéee indépendemment. Elles apparaissent +au bas de l'environnement, et non au bas de la page. Et par défaut +elles apparaissent alphabétiquement. @xref{minipage}. + + +@node \footnotemark +@section @code{\footnotemark} + +@findex \footnotemark + +Synopsis : + +@example +\footnotemark +@end example + +Sans l'argument optionnel, la commande @code{\footnotemark} place dans +le texte le numéro de la note courante. Cette commande peut être +utilisée en mode paragraphe interne. Vous pouvez donner le texte de la +note séparéement la commande @code{\footnotetext}. + +Cette commande pour produire plusieurs marque de note en bas de page +faisant référence à la même note avec + +@example +\footnotemark[\value@{footnote@}] +@end example + +@noindent +après la première commande @code{\footnote}. + + +@node \footnotetext +@section @code{\footnotetext} +@findex \footnotetext + +Synopsis, l'un des deux : + +@example +\footnotetext@{@var{texte}@} +\footnotetext[@var{numéro}]@{@var{texte}@} +@end example + +Place @var{texte} au bas de la page comme une note en bas de page. Cette +This commande peut appraître n'importe où après la commande +@code{\footnotemark}. L'argument optionnel @var{numéro} change le numéro +de note affiché. La commande @code{\footnotetext} ne doit être utilisée +qu'en mode paragraphe externe. + + +@node Footnotes in a table +@section Notes en bas de page dans un tableau + +@cindex Notes en bas de page, dans un tableau + +Au sein d'un environnement @code{table} la commande @code{\footnote} ne +fonctionne pas. Par exemple, si le code ci-dessous apparaît sans plus +alors la note disapaît tout simplement ; il y aura une marque de note +dans la cellule du tableau mais rien n'est composé en bas de la page. + +@example +\begin@{center@} + \begin@{tabular@}@{l|l@} + \textsc@{Ship@} &\textsc@{Book@} \\ \hline + \textit@{HMS Sophie@} &Master and Commander \\ + \textit@{HMS Polychrest@} &Post Captain \\ + \textit@{HMS Lively@} &Post Captain \\ + \textit@{HMS Surprise@} &A number of books\footnote@{Starting with + HMS Surprise.@} + \end@{tabular@} +\end@{center@} +@end example + +La solution est d'entourer l'environnement the @code{tabular} d'un environnement +@code{minipage}, comme ci-après (@pxref{minipage}). + +@example +\begin@{center@} + \begin@{minipage@}@{.5\textwidth@} + .. matériel tabulaire .. + \end@{minipage@} +\end@{center@} +@end example + +La même technique marche au sein d'un environnement @code{table} +flottant (@pxref{table}). To get the footnote at the bottom of the page +use the @file{tablefootnote} package, comme illustré dans l'exemple +ci-apès. Si vous placez @code{\usepackage@{tablefootnote@}} dans le +préambule et utilisez le code source ci-dessous, alors la note +apparaîtra en bas de la page et sera numérotée dans la même séquence que +les autres notes en bas de page. + +@example +\begin@{table@} + \centering + \begin@{tabular@}@{l|l@} + \textsc@{Date@} &\textsc@{Campagne@} \\ \hline + 1862 &Fort Donelson \\ + 1863 &Vicksburg \\ + 1865 &Armée de Virginie du Nord\footnote@{Fin de la + guerre.@} + \end@{tabular@} + \caption@{Forces capturées par le général Grant@} +\end@{table@} +@end example + + +@node Footnotes in section headings +@section Note en bas de page dont le renvoi est au sein d'un titre de rubrique + +@cindex notes en bas de page, dans les titres de rubrique +@cindex table des matières, éviter les notes en bas de page +Mettre une note en bas de page depuis un titre de rubrique, comme dans : + +@example +\section@{Les ensembles complets\protect\footnote@{Ce texte est dû à ...@}@} +@end example + +@PkgIndex{footmisc} +@cindex @code{stable}, option du paquetage @code{footmisc} +@cindex option @code{stable} du paquetage @code{footmisc} +@noindent +a pour effet que la note en bas de page apparaît à la fois en bas de la +page où la rubrique commence, et de celle où son titre apparaît dans la +table des matières, ce qui vraisembablement n'est pas voulu. Pour +qu'elle n'apparaisse pas sur la table des matières utilisez le paquetage +@file{footmisc} avec l'option @code{stable}. + +@example +\usepackage[stable]@{footmisc@} + .. +\begin@{document@} + .. +\section@{Les ensembles complets\footnote@{Ce texte est dû à R~Jones.@}@} +@end example + +Notez que le @code{\protect} a disparu ; l'inclure aurait pour effet que +la note en bas de page apparaîtrait de nouveau dans la table des +matières. + +@node Footnote parameters +@section Paramètres des notes en bas de page +@cindex notes en bas de page, paramètres +@cindex paramètres, pour notes en bas de page + +@ftable @code +@item \footnoterule +Produit le filet de séparation entre texte principal sur une page et les +notes en bas de cette page. Les dimension par défaut : épaisseur (ou +largeur) @code{0.4pt}, et longueur @code{0.4\columnwidth} dans les +classes standard de document (à l'exception @code{slide}, où elle +n'apparaît pas). + +@item \footnotesep +La hauteur de l'étai placé au début de la note en bas de page. Par +défaut, c'est réglé à l'étai nomal pour des police de taille +@code{\footnotesize} (@pxref{Font sizes}), donc il n'y a pas d'espace +supplémentaire entre les notes. Cela vaut @samp{6.65pt} pour des polices +à @samp{10pt}, @samp{7.7pt} pour @samp{11pt}, et @samp{8.4pt} pour +@samp{12pt}. + +@end ftable + + +@node Definitions +@chapter Définitions +@cindex définitions + +@LaTeX{} prend en charges la fabrication de nouvelles commandes de bien +des genres. + +@c xx everything in this chapter needs exemples. +@c xx Add DeclareRobustCommand (see clsguide.pdf) + +@menu +* \newcommand & \renewcommand:: (Re)définir une nouvelle commande. +* \newcounter:: Définir un nouveau compteur. +* \newlength:: Définir une nouvelle longueur. +* \newsavebox:: Définir une nouvelle boîte. +* \newenvironment & \renewenvironment:: Définir un nouvel environnement. +* \newtheorem:: Définir un nouvel environnement de semblable à @code{theorem}. +* \newfont:: Définir un nouveau nom de police. +* \protect:: Utiliser des commandes fragile. +@end menu + +@node \newcommand & \renewcommand +@section @code{\newcommand} & @code{\renewcommand} +@findex \newcommand +@cindex commandes, en définir de nouvelles +@cindex définir une nouvelle commande +@cindex nouvelle commandes, définir + +@code{\newcommand} définit une nouvelle commande, et +@code{\renewcommand} la redéfinit. + +Synopsis : + +@example + \newcommand@{\@var{cmd}@}[@var{nargs}][@var{optargdéfaut}]@{@var{défn}@} +\renewcommand@{\@var{cmd}@}[@var{nargs}][@var{optargdéfaut}]@{@var{défn}@} + \newcommand*@{\@var{cmd}@}[@var{nargs}][@var{optargdéfaut}]@{@var{défn}@} +\renewcommand*@{\@var{cmd}@}[@var{nargs}][@var{optargdéfaut}]@{@var{défn}@} +@end example + +@cindex forme en *, définir de nouvelles commandes +@cindex forme étoilée, définir de nouvelles commandes +La forme étoilée (en @code{*}) de ces commandes exige que les arguments +ne contiennent pas de paragraphes de texte (la commande n'est pas +@code{\long}, dans la terminologie de @TeX{} de base). + +@table @var +@item cmd +Obligatoire ; @code{\@var{cmd}} est le nom de la commande. Pour +@code{\newcommand}, il ne doit pas être déja défini et ne doit pas +commencer avec @code{\end} ; pour @code{\renewcommand}, il doit être +déja défini. + +@item nargs +Optionnel ; un entier compris entre 1 et 9 spécifiant le nombre +d'arguments que commande peut prendre, y compris un éventuel argument +optionnel. Si cet argument n'est pas présent, alors la spécification par +défaut est que la commande ne prend aucun argument. Lorsque on redéfinit +une commande, la nouvelle version peut prendre un nombre différent +d'arguments par rapport à l'ancienne. + +@item optargdéfaut +Optionnel ; si cet argument est present, alors le premier argument de la +commande @code{\@var{cmd}} en définition est optionnel, et sa valeur par +défaut est @var{optargdéfaut} (qui peut être une chaîne vide). Si cet +argument n'est pas présent, alors @code{\@var{cmd}} ne prend pas +d'argument optionnel. + +@cindex paramètre positionnel +C'est à dire que si @code{\@var{cmd}} est utilisé avec des crochets à la +suite, comme dans @code{\@var{cmd}[@var{maval}]}, alors au sein de +@var{défn} le premier @dfn{paramètre positionnel} @code{#1} se développe +en @var{maval}. Par contre si @code{\@var{cmd}} est appelé sans crochet à +la suite, alors au sein de @var{défn} le paramètre positionnel @code{#1} +se développe en la valeur par défaut @var{optargdéfaut}. Dans tous les +cas, tout argument obligatoire sera désigné en commençant par @code{#2}. + +Omettre @code{[@var{maval}]} dans un appel n'est pas la même chose +qu'avoir les crochets ne contenant rien, comme dans @code{[]}. Dans le +premier cas le paramètre @code{#1} se développe en @var{optargdéfaut} ; +alors que dans le secon @code{#1} se développe en une chaîne vide. + +@item défn +Le texte par lequel substituer chaque occurrence de \@code{cmd} ; le +paramètre positionnel @code{#@var{n}} au sein de @var{défn} est +remplacée par le texte passé comme @var{n}ième argument. + +@end table + +@TeX{} ignore les espaces dans le code source à la suite d'une commande (ou de +toute séquence de contrôle), comme dans @samp{\cmd }. Si vous désirez une +espace réellement à cet endroit, une solution est de taper @code{@{@}} après la +commande (@samp{\cmd@{@} }), et un autre est d'utiliser un espace de contrôle +explicite (@samp{\cmd\ }). + +Un exemple simple de définition d'une nouvelle commande : +@code{\newcommand@{\JM@}@{Jean Martin@}} a pour effet le remplacement de +l'abréviation @code{\JM} par le texte plus long de la définition. + +La redéfinition d'une commande existante est similaire : +@code{\renewcommand@{\symbolecqfd@}@{@{\small CQFD@}@}}. + +Voici la définition d'une commande avec un argument obligatoire : + +@example +\newcommand@{\defref@}[1]@{Définition~\ref@{#1@}@} +@end example + +@noindent Alors, @code{\defref@{def:basis@}} se développe en +@code{Définition~\ref@{def:basis@}}, ce qui en fin de compte se développera en +quelque-chose du genre de @samp{Définition~3.14}. + +Un exemple avec deux arguments obligatoires : +@code{\newcommand@{\nbym@}[2]@{$#1 \times #2$@}} est invoqué comme +@code{\nbym@{2@}@{k@}}. + +Un exemple avec un argument optionnel : + +@example +\newcommand@{\salutation@}[1][Madame, Monsieur]@{#1,@} +@end example + +@noindent Alors, @code{\salutation} donne @samp{Madame, Monsieur,} alors +@code{\salutation[Cher Jean]} donne @samp{Cher Jean,}. Et +@code{\salutation[]} donne @samp{,}. + +Les accolades autour de @var{défn} ne définissent pas un groupe, c.-à-d.@: +qu'elle ne délimitent pas la portée du résultat du développement de @var{défn}. +Ainsi la définition @code{\newcommand@{\nomnavire@}[1]@{\it #1@}} est problématique ; +dans cette phrase + +@example +Le \nomnavire@{Monitor@} rencontra le \nomnavire@{Merrimac@}. +@end example + +@noindent les mots @samp{rencontra le} sont mis incorrectement en +italique. Une paire supplémentaire d'accolades est nécessaire, comme cela : +@code{\newcommand@{\nomnavire@}[1]@{@{\it #1@}@}}. Ces accolades font partie de +la définition et par conséquent définissent bien un groupe. + + + + +@c xx \providecommand, * forme (non-\long) + +@node \newcounter +@section @code{\newcounter} +@findex \newcounter +@cindex compteurs, définir de nouveaux + +Synopsis : + +@example +\newcounter@{@var{nomcompteur}@}[@var{super}] +@end example + +La commande @code{\newcounter} définit un nouveau compteur nommé @var{nomcompteur}. +Le nouveau compteur est initialisé à zéro. + +Quand l'argument optionnel @code{[@var{super}]} est fourni, le compteur +@var{nomcompteur} est réinitialisé à chaque incrémentation du compteur +nommé @var{super}. + +@xref{Counters}, pour plus d'information à propos des compteurs. + + +@node \newlength +@section @code{\newlength} +@findex \newlength +@cindex longueurs, définir de nouvelles + +Synopsis : + +@example +\newlength@{\@var{arg}@} +@end example + +La commande @code{\newlength} définit l'argument obligatoire comme une +commande de @dfn{longueur} avec une valeur de @code{0mm}. L'argument +doit être une séquence de contrôle, comme dans +@code{\newlength@{\foo@}}. Une erreur se produit si @code{\foo} est déjà +défini. + +@xref{Lengths}, pour comment régler la nouvelle longeur à une valeur non +nulle, et pour plus d'information à propos des longueurs en général. + + +@node \newsavebox +@section @code{\newsavebox} +@findex \newsavebox + +Synopsis : + +@example +\newsavebox@{\@var{cmd}@} +@end example + +Définit @code{\@var{cmd}} pour se référer à un nouveau bac pour stocker +des boîtes. Une telle boîte sert à détenir du matériel composé, pour +l'utiliser plusieurs fois (@pxref{Boxes}) ou pour le mesurer ou le +manipuler. Le nom @code{\@var{cmd}} doit commencer par une +contr'oblique, et ne doit pas être déjà défini. + +L'allocation d'une boîte est globale. Cette commande est fragile +(@pxref{\protect}). + + +@node \newenvironment & \renewenvironment +@section @code{\newenvironment} & @code{\renewenvironment} +@findex \newenvironment +@findex \renewenvironment +@cindex environnements, defining +@cindex defining new environnements +@cindex redefining environnements + +Ces commandes définissent ou redéfinissent un environnement @var{env}, +c.-à-d., @code{\begin@{@var{env}@} @var{corps} \end@{@var{env}@}}. + +Synopsis : + +@example + \newenvironment@{@var{env}@}[@var{nargs}][@var{argoptdéfaut}]@{@var{défdébut}@}@{@var{déffin}@} + \newenvironment*@{@var{env}@}[@var{nargs}][@var{argoptdéfaut}]@{@var{défdébut}@}@{@var{déffin}@} +\renewenvironment@{@var{env}@}[@var{nargs}]@{@var{défdébut}@}@{@var{déffin}@} +\renewenvironment*@{@var{env}@}[@var{nargs}]@{@var{défdébut}@}@{@var{déffin}@} +@end example + +@cindex forme étoilée des commandes d'environnement +@cindex forme en * des commandes d'environnement +La forme étoilée de ces commandes exige que les arguments (à ne pas +confondre avec le corps de l'environnement) ne contiennent pas de +paragraphes de texte. + +@table @var +@item env +Obligatoire ; le nom de l'environnement. Il est constitué seulement de +lettres ou du caractère astérisque @code{*}, et donc ne commence pas par +une contr'oblique @code{\}. Il ne doit pas commencer par la chaîne +@code{end}. Pour @code{\newenvironment}, @var{env} ne doit pas être le +nom d'un environnement déjà existant, et la commande @code{\@var{env}} +ne doit pas être définie. Pour @code{\renewenvironment}, @var{env} doit +être le nom d'un environnement déjà existant. + +@item nargs +Optionnel ; un entier de 0 à 9 indiquant le nombre d'arguments que +l'environnement attend. Quand l'environnement est utilisé, ces arguments +apparaissent après le @code{\begin}, comme dans +@code{\begin@{@var{env}@}@{@var{arg1}@}@dots{}@{@var{argn}@}}. Si cet +argument n'est pas présent, alors par défaut l'environment n'attend pas +d'argument. Lorsqu'on redéfinit un environment, la nouvelle version peut +prendre un nombre différent d'arguments que la précédente. + +@item argoptdéfaut +Optionnel ; si cet argument est présent alors le premier argument de +l'environnement en définition est optionnel, et sa valeur par défaut est +@var{argoptdéfaut} (éventuellement une chaîne vide). Si cet argument +n'est pas présent alors l'environnement ne prend pas d'argument +optionnel. + +c.-à-d.@: que si @code{[@var{argoptdéfaut}]} est présent dans la +définition de l'environnement, et que @code{\begin@{@var{env}@}} est +utilisé avec des crochets à la suite, comme dans +@code{\begin@{@var{env}@}[@var{maval}]}, alors, au sein de +@var{défdébut}, le paramètre positionnel @code{#1} se développe en +@var{maval}. Si par contre @code{\begin@{@var{env}@}} est appéelé sans +être suivi de crochet, alors, au sein de @var{défdébut}, le +@cindex paramètre positionnel +paramètre positionnel @code{#1} se développe en la valeur par défaut, +c.-à-d.@: @var{optargdefault}. Dans les deux cas, le premier paramètre +positionnel faisant référence à argument obligatoire est @code{#2}. + +Omettre @code{[@var{maval}]} dans l'appel est différent d'avoir des +crochets sans contenu, c.-à-d.@: @code{[]}. Dans le premier cas +@code{#1} se développe en @var{argoptdéfaut}, et dans le second en une +chaîne vide. + +@item défdébut +Obligatoire ; le texte qui est développé à toute occurrence de +@code{\begin@{@var{env}@}} ; au sein de @var{défdébut}, le @var{n}ième +paramètre positionnel, (c.-à-d.@: @code{#@var{n}}), est remplacé au sein +de @var{défdébut} par le texte du @var{n}ième argument. + +@item déffin +Obligatoire ; le texte développé à toute occurrence de +@code{\end@{@var{env}@}}. Il ne doit contenir aucun paramètre +positionnel, ainsi @code{#@var{n}} ne peut pas être utilisé ici (mais +voyez l'exemple final ci-après). + +@end table + +Tous les environnements, c'est à dire le code de @var{défdébut}, le +corps de l'environnement, et le code @var{déffin}, sont traités au sein +d'un groupe. Ansi, dans le premier exemple ci-dessous, l'effet de +@code{\small} est limité à la citation et ne s'étend pas au matériel qui +suit l'environnement. + +Cet exemple dont un environnement semblable à @code{quotation} de +@LaTeX{} à ceci près qu'il sera composé dans une taille de police plus +petite : + +@example +\newenvironment@{smallquote@}@{% + \small\begin@{quotation@} +@}@{% + \end@{quotation@} +@} +@end example + +Celui-ci montre l'utilisation des arguments ; cela donne un environnement de +citation qui affiche l'auteur : + +@example +\newenvironment@{citequote@}[1][Corneille]@{% + \begin@{quotation@} + \noindent\textit@{#1@}: +@}@{% + \end@{quotation@} +@} +@end example + +@noindent Le nom de l'auteur est optionnel, et vaut par défaut @samp{Corneille}. +Dans le document, utilisez l'environnement comme ceci : + +@example +\begin@{citequote@}[Clovis, roi des Francs] + ... +\end@{citequote@} +@end example + +Ce dernier exemple montre comment sauvegarder la valeur d'un argument +pour l'utiliser dans @var{déffin}, dans ce cas dans une boîte +(@pxref{\sbox}). + +@example +\newsavebox@{\quoteauthor@} +\newenvironment@{citequote@}[1][Corneille]@{% + \sbox\quoteauthor@{#1@}% + \begin@{quotation@} +@}@{% + \hspace@{1em plus 1fill@}---\usebox@{\quoteauthor@} + \end@{quotation@} +@} +@end example + + +@node \newtheorem +@section @code{\newtheorem} +@findex \newtheorem +@cindex théorèmes, définition +@cindex définir de nouveaux théorèmes + +@cindex théorème, environnement simili- +@cindex environnement simili-théorème + +Définit une nouvel @dfn{environnement simili-théorème}. Synopsis : + + +@example +\newtheorem@{@var{nom}@}@{@var{titre}@}[@var{numéroté_au_sein_de}] +\newtheorem@{@var{nom}@}[@var{numéroté_comme}]@{@var{titre}@} +@end example + +Ces deux commandes crééent un environnement simili-théorème +@var{nom}. Utiliser la première des deux formes, + +@example +\newtheorem@{@var{nom}@}@{@var{titre}@}[@var{numéroté_au_sein_de}] +@end example + +@noindent avec l'argument optionnel après le second argument +obligatoire, crée un environnement dont le compteur est subordonné au +compteur déjà existant @var{numéroté_au_sein_de}, c.-à-d.@: qui est +réinitialisé à it will chaque réinitialisation de +@var{numéroté_au_sein_de}. + +Utiliser la seconde forme, + +@example +\newtheorem@{@var{nim}@}[@var{numéroté_comme}]@{@var{titre}@} +@end example + +@noindent avec l'argument optionnel entre les deux arguments +obligatoire, crée une environnement dont le compteur partage le compteur +déjà défini @var{numéroté_comme}. + +Vous pouvez spécifier l'un seul de @var{numéroté_au_sein_de} et +@var{numéroté_comme}, ou ni l'un ni l'autre, mais non les deux à la +fois. + +Cette commande crée un compteur nommé @var{name}. De plus, à moins que +l'argument optionnel @var{numéroté_comme} soit utilisé, la valeur +courrante de @code{\ref} est celle de +@code{\the@var{numéroté_au_sein_de}} (@pxref{\ref}). + +Cette déclaration est globale. Elle est fragile (@pxref{\protect}). + +@table @var +@item nom +Le nom de l'environnement. Il ne doit pas commencer avec une +contr'oblique (@samp{\}). Il ne doit pas être le nom d'un environnement +déjà exisant ; en fait le nom de commande @code{\@var{nom}} ne doit pas +être déjà défini de quelque façon que ce soit. + +@item titre +Le texte imprimé au début de l'environnement, avant le numéro. Par +exemple, @samp{Théorème}. + +@item numéroté_au_sein_de +Optionnel ; le nom d'un compteur déjà défini, d'ordinaire une unité +sectionnelle telle que @code{chapter} ou @code{section}. Lorsque le +compteur @var{numéroté_au_sein_de} est re-initialisé, alors le compteur +de l'environnement @var{nom} l'est aussi. + +Si cet argument optionnel est omis alors la commande +@code{\the@var{nom}} est définie comme @code{\arabic@{@var{nom}@}}. + +@item numéroté_comme +Optionnel ; le nom d'un environement simil-théorème déjà défini. Le +nouvel environnement se numéroté en séquence avec @var{numéroté_comme}. + +@end table + +En l'absence des arguments optionnels les environnement sont numérotés +en séquence. L'exemple suivant a une déclaration dans le préambule qui +résulte en @samp{Définition 1} et @samp{Définition 2} en +sortie. + +@example +\newtheorem@{defn@}@{Définition@} +\begin@{document@} +\section@{...@} +\begin@{defn@} + Première déf. +\end@{defn@} + +\section@{...@} +\begin@{defn@} + Seconde déf. +\end@{defn@} +@end example + +Parce que l'exemple suivant spécifie @code{section} comme argument optionnel +@var{numéroté_au_sein_de} à @code{\newtheorem}, l'exemple, reprenant le +même corps de document que l'exemple précédent, donne @samp{Définition 1.1} +et @samp{Définition 2.1}. + +@example +\newtheorem@{defn@}@{Definition@}[section] +\begin@{document@} +\section@{...@} +\begin@{defn@} + Première déf. +\end@{defn@} + +\section@{...@} +\begin@{defn@} + Seconde déf. +\end@{defn@} +@end example + +Dans l'exemple suivant il y a deux déclarations dans le préambule, la +seconde desquelle appelle le nouvel environnement @code{thm} pour +utilise le même compteur que @code{defn}. Cela donne +@samp{Définition 1.1}, suivi de @samp{Théorème 2.1} et @samp{Définition 2.2}. + +@example +\newtheorem@{defn@}@{Définition@}[section] +\newtheorem@{thm@}[defn]@{Théorème@} +\begin@{document@} +\section@{...@} +\begin@{defn@} + Première déf. +\end@{defn@} + +\section@{...@} +\begin@{thm@} + Premier théorème +\end@{thm@} + +\begin@{defn@} + Seconde déf. +\end@{defn@} +\section@{...@} +@end example + + +@node \newfont +@section @code{\newfont}: définit une nouvelle police (obsolète) +@findex \newfont +@cindex polices, commandes pour déclarer de nouvelles +@cindex définir de nouvelles polices + + +@code{\newfont}, desormais obsolète, définit une commande qui commute la +police de caractère. Synopsis : + +@example +\newfont@{\@var{cmd}@}@{@var{description_police}@} +@end example + +Ceci définit une séquence de contrôle @code{\@var{cmd}} qui change la +police courante. @LaTeX{} cherche sur votre système un fichier nommé +@file{@var{nompolice}.tfm}. La séquence de contrôle ne doit pas être +déjà définie. Elle doit commencer par une contr'oblique (@samp{\}). + + + +@findex .fd @r{fichier} +Cette commande est obsolète. c'est une commande de bas niveau pour +mettre en place une police individuelle. De nos jours, les polices sont +pratiquement toujours définies en familles (ce qui vous permet, par +exemple, d'associer un gras et un romain) au travers de ce qu'il est +convenu de nommer le « Nouveau Plan de Sélection de Polices de +caractère », soit en utilisant des fichier @file{.fd} ou à travers +l'utilisation d'un moteur qui sait accéder au système de polices de +caractère, tel que Xe@LaTeX{} (@pxref{@TeX{} engines,Les moteurs +@TeX{}}). +@c xx explain nfss somewhere + + +@cindex clause at, au sein d'une définition de police +@cindex taille de conception, au sein d'une définition de police +Mais puisque cela fait partie de @LaTeX{}, voici l'explication : le +paramètre @var{description_police} consiste en un @var{nompolice} et une +@dfn{clause at} optionnelle ; celle-ci peut avoir soit la forme @code{at +@var{dimen}} ou @code{scaled @var{facteur}}, où un @var{facteur} de +@samp{1000} signifie aucune dilatation/contraction. Pour l'usage de +@LaTeX{}, tout ce que ceci fait est de dilater ou contracter le +caractère et les autre dimension relative à la taille de conception de +la police, ce qui est une valeur définie dans le fichier en @file{.tfm}. + +Cet exemple défnit deux polices équivalente et compose quelques +caractères dans chacune d'elles : + +@example +\newfont@{\testpoliceat@}@{cmb10 at 11pt@} +\newfont@{\testpolicedilatee@}@{cmb10 scaled 1100@} +\testpoliceat abc +\testpolicedilatee abc +@end example + + +@node \protect +@section @code{\protect} +@findex \protect + +@cindex commandes fragiles +@cindex commandes robustes +@cindex fragile, commande +@cindex robuste, commande + +Toutes les commandes de @LaTeX{} sont soit @dfn{fragiles} soit +@dfn{robustes}. Les notes en bas de page, les saut de ligne, toute +commande prenant un argument optionnel, et bien d'autres, sont +fragiles. Une commande fragile peut se disloquer et causer une erreur +lorsque elle est utilisée au sein de l'argument de certaines +commandes. Pour empécher la dislocation de ces commandes l'une des +solutions est de les précéder de la commande @code{\protect}. + +Par exemple, lorsque @LaTeX{} execute la commande +@code{\section@{@var{nom-rubrique}@}} il écrit le texte +@var{nom-rubrique} dans le fichier auxiliaire @file{.aux}, de sorte à +pouvoir le tirer de là pour l'utiliser dans d'autres partie du document +comme la table des matières. On appelle +@cindex arguments mouvants +@dfn{argument mouvant} tout argument qui est développé en interne par +@LaTeX{} sans être directement composé en sortie. Une commande est dite +fragile si elle se développe pendant ce processus en un code @TeX{} non +valide. Certains exemples d'arguments mouvants sont ceut qui apparaissent +au sein des commande @code{\caption@{...@}} (@pxref{figure}), dans la +commande @code{\thanks@{...@}} (@pxref{\maketitle}), et dans les +expression en @@ des environnements @code{tabular} et @code{array} +(@pxref{tabular}). + +Si vous obtenez des erreurs étranges de commandes utilisées au sein +d'arguments mouvants, essayez des les précéder d'un @code{\protect}. Il +faut un @code{\protect} pour chacune des commandes fragiles. + +Bien qu'en général la commande @code{\protect} ne fait pas de mal, les +commandes de gestion de longueurs sont robustes et ne devraient pas être +précédées d'une commande @code{\protect}. Une commande @code{\protect} +ne peut pas non plus être utilisée au sein de l'argument d'une commande +@ref{\addtocounter,@code{\addtocounter}} ou +@ref{\setcounter,@code{\setcounter}}. + +Dans l'exemple qui suit la commande @code{\caption} produit une erreur +mystérieuse + +@example +\begin@{figure@} + ... + \caption@{Company headquarters of A\raisebox@{1pt@}@{B@}\raisebox@{-1pt@}@{C@}@} +\end@{figure@} +@end example + +Dans l'exemple suivant la commande @code{\tableofcontents} produit une +erreur à cause du @code{\(..\)} dans le titre de section qui se +développe en code incorrect @TeX{} dans le fichier @file{.toc}. Vous +pouvez résoudre ceci en remplaçat @code{\(..\)} +par @code{\protect\(..\protect\)}. + +@example +\begin@{document@} +\tableofcontents +... +\section@{Einstein's \( e=mc^2 \)@} +... +@end example + + +@node Counters +@chapter Compteurs +@cindex compteurs, a list of +@cindex variables, a list of + +Tout ce que @LaTeX{} numérote pour vous a un compteur associé avec +soi. Le nom du compteur est le même que le nom de l'environnement ou de +la commande qui produit le numéro, sauf qu'il ne pas de @code{\}. +(@code{enumi}--@code{enumiv} sont utilisés pour les environnements +@code{enumerate} imbriqués). Ci-dessous se trouve une liste des +compteurs utilisée dans les classes standardes de documents @LaTeX{} +pour contrôler la numérotation. + +@example +part paragraphe figure enumi +chapter subparagraph table enumii +section page footnote enumiii +subsection équation mpfootnote enumiv +subsubsection +@end example + +@menu +* \alph \Alph \arabic \roman \Roman \fnsymbol:: Taper la valeur d'un compteur. +* \usecounter:: Utiliser un compteur spécifié dans un environnement de liste. +* \value:: Utiliser la valeur d'un compteur dans une expression. +* \setcounter:: Régler la valeur d'un compteur. +* \addtocounter:: Ajouter une quantité à un compteur. +* \refstepcounter:: Ajouter au compteur, re-initialiser les compteurs subsidiaires. +* \stepcounter:: Ajouter au compteur, re-initialiser les compteurs subsidiaires. +* \day \month \year:: Valeur de date numériques. +@end menu + + +@node \alph \Alph \arabic \roman \Roman \fnsymbol +@section @code{\alph \Alph \arabic \roman \Roman \fnsymbol}: Taper des compteurs + +Toutes ces commandes prennent un unique compteur en argument, par +exemple, @code{\alph@{enumi@}}. + +@ftable @code +@item \alph +tape @var{compteur} en utilisant des lettre en bas de casse : `a', `b', @enddots{} + +@item \Alph +Utilise des lettres capitales : `A', `B', @enddots{} + +@item \arabic +Utilise des numéro en chiffres arabes : `1', `2', @enddots{} + +@item \roman +Utilise des nombres romains en bas de casse : `i', `ii', @enddots{} + +@item \Roman +Utilise des nombres romains en capitales : `I', `II', @enddots{} + +@item \fnsymbol +Tape la valeur de @var{compteur} dans une séquence spécifique de neuf +symboles (utilisés par convention pour la numérotation des notes en bas +de page). La valeur de @var{compteur} doit être comprise entre 1 +et 9 inclus. + +Voici ces symboles : + +@multitable @columnfractions .33 .33 .33 +@headitem Nom@tab Commande@tab@iftexthenelse{Symbole,Équivalent Unicode} +@item +astérisque@tab@code{\ast}@tab@BES{*,\ast} +@item +obèle@tab@code{\dagger}@tab@BES{†,\dagger} +@item +double-obèle@tab@code{\ddagger}@tab@BES{‡,\ddagger} +@item +marque-de-section@tab@code{\S}@tab@BES{§,\S} +@item +marque-de-paragraphe@tab@code{\P}@tab@BES{¶,\P} +@item +parallèle@tab@code{\parallel}@tab@BES{‖,\parallel} +@item +asterisque-double@tab@code{\ast\ast}@tab@BES{**,\ast\ast} +@item +obèle-double@tab@code{\dagger\dagger}@tab@BES{††,\dagger\dagger} +@item +double-obèle-double@tab@code{\ddagger\ddagger}@tab@BES{‡‡,\ddagger\ddagger} +@end multitable + +@end ftable + + +@node \usecounter +@section @code{\usecounter@{@var{compteur}@}} +@findex \usecounter +@cindex article d'une liste, compteur spécifiant +@cindex articles numérotés, compteur spécifiant + +Synopsis : + +@example +\usecounter@{@var{compteur}@} +@end example + +La commande @code{\usecounter} est utilisée dans le second argument de +l'environnement @code{list} pour spécifier le @var{compteur} à utiliser +pour numéroter les articles de la liste. + + +@node \value +@section @code{\value@{@var{compteur}@}} +@findex \value +@cindex compteurs, obtenir la valeur d'un + +Synopsis : + +@example +\value@{@var{compteur}@} +@end example + +La commande @code{\value} produit la valeur de @var{compteur}. Ça peut +être utilisé partout là où @LaTeX{} attend un nombre, par exemple : + +@example +\setcounter@{moncompteur@}@{3@} +\addtocounter@{moncompteur@}@{1@} +\hspace@{\value@{moncompteur@}\parindent@} +@end example + + +@node \setcounter +@section @code{\setcounter@{@var{compteur}@}@{@var{value}@}} +@findex \setcounter +@cindex compteurs, réglage +@cindex réglage de compteurs + +Synopsis : + +@example +\setcounter@{@var{compteur}@}@{@var{value}@} +@end example + +La commande @code{\setcounter} règle la valeur de @var{compteur} à +l'argument @var{value}. + + +@node \addtocounter +@section @code{\addtocounter@{@var{compteur}@}@{@var{valeur}@}} +@findex \addtocounter + +La commande @code{\addtocounter} incrémente @var{compteur} de la +quantité spécifiée par l'argument @var{valeur}, qui peut être negatif. + + +@node \refstepcounter +@section @code{\refstepcounter@{@var{compteur}@}} +@findex \refstepcounter + +La commande @code{\refstepcounter} fonctionne de la même façon que +@code{\stepcounter} @xref{\stepcounter}, à ceci près qu'elle définit +également la valeur courante de @code{\ref} comme le résultat de +@code{\thecounter}. + + +@node \stepcounter +@section @code{\stepcounter@{@var{compteur}@}} +@findex \stepcounter + +La commande @code{\stepcounter} ajouter un à @var{compteur} et +re-initialise tous les compteurs subsidiaires. + + +@node \day \month \year +@section @code{\day \month \year}: Predefined compteurs +@findex \day +@findex \month +@findex \year + +@LaTeX{} définit des compteurs pour le quantième du mois (@code{\day}, +1--31), le mois de l'année (@code{\month}, 1--12), et l'année +(@code{\year}, de l'ère chrétienne). Quand @TeX{} démarre, ils sont mis +à la valeur courante du système sur lequel @TeX{} s'exécute. Ils ne sont +pas remis à jour pendant que le traitement par @TeX{} progresse. + +En relation avec ces compteurs, la commande @code{\today} produit une +chaîne représentant le jour courant (@pxref{\today}). + + +@node Lengths +@chapter Longueurs +@cindex longueurs, définir et utiliser + +@cindex longueur +Une @dfn{longeur} est une mesure de distance. Beaucoup de commandes +@LaTeX{} prennent une longueur en argument. + +@menu +* Unités de longueur: Units of length. Les unités que @LaTeX{} connaît. +* \setlength:: Règle la valeur d'une longueur. +* \addtolength:: Ajoute une quantité à une longueur. +* \settodepth:: Assigne à une longueur la profondeur de quelque-chose. +* \settoheight:: Assigne à une longueur la hauteur de quelque-chose. +* \settowidth:: Assigne à une longueur la largeur de quelque-chose. +* Longueurs prédéfinies: Predefined lengths. Les longueur qui sont, en quelque sorte, prédéfinies. +@end menu + +@node Units of length +@section Unités de longueur + +@cindex unités, de longueur + +@TeX{} et @LaTeX{} connaissent ces unités aussi bien en mode +mathématique qu'en dehors de celui-ci. + +@table @code +@item pt +@findex pt +@cindex Point +Point (1/72,27)@dmn{pouce}. La conversion en unités métriques units, avec deux +chiffres après la virgule, est 1@dmn{point} = 2,85@dmn{mm} = 28,45@dmn{cm}. + +@item pc +@cindex pica +@findex pc +Pica, 12@dmn{pt} + +@item in +@findex in +@findex pouce (inch) +Pouce, 72,27@dmn{pt} + +@item bp +@findex bp +@cindex Big point +Big point, 1/72 pouce. Cette longueur est la défition d'un point en +PostScript et dans beaucoup d'autres systèmes bureautiques d'éditique +(PAO). + +@item cm +@cindex Centimètre +@findex cm +Centimetre + +@item mm +@cindex Millimètre +@findex mm +Millimètre + +@item dd +@cindex point Didot +@findex dd +Point Didot, 1,07@dmn{pt} + +@item cc +@cindex Cicero +@findex cc +Cicero, 12@dmn{dd} + +@item sp +@cindex Point proportionné (Scaled point) +@findex sp +Point proportionné, (1/65536)@dmn{pt} + +@end table + +@cindex cadratin +@cindex x, hauteur d'un +@cindex m, largeur d'un +@findex ex +@cindex em +@findex em +Deux autre longueurs sont souvent utilisées et sont des valeurs réglées +par les créateurs de caractères typographiques. La hauteur @dfn{ex} +d'un x de la fonte coutante , traditionnellement la hauteur de la lettre +x en bas de casse, est souvent utilisée pour les longueurs +verticales. De même le @dfn{em}, traditionnellement la largeur de la +lettre M capitale, est souvant utilisée pour les longueurs horizontales +(il y a aussi @code{\enspace} qui vaut @code{0.5em}). L'utilisation de +ces unités peut aider améliorer le fonctionnement d'une définition lors +des changements de fonte. Par exemple, il est plus probable qu'une +définition de l'espace verticale entre les articles d'une liste donnée +comme @code{\setlength@{\itemsep@}@{1ex plus 0.05ex minus 0.01ex@}} +reste raisonnable si la fonte est changée que si elle était exprimée en +points. + +@cindex mu, unité mathématique +@findex mu +En mode mathématique, beaucoup de définitions sont exprimées dans +l'unité mathématique @dfn{mu} donnée par 1@dmn{em} = 18@dmn{mu}, où le +em est pris de la famille courante des symboles mathématiques. +@xref{Spacing in math mode}. + + +@node \setlength +@section @code{\setlength} +@findex \setlength +@cindex longueur, régler une + +Synopsis : + +@example +\setlength@{\@var{longueur}@}@{@var{valeur}@} +@end example + +La commande @code{\setlength} règle la valeur d'une @dfn{commande de +longueur} +@cindex commande de longueur +@cindex longueur, commande de +@code{\@var{longueur}} à l'argument @var{valeur} qui peut être +exprimé dans n'importe quelle unité comprise par @LaTeX{}, c.-à-d.@: des +pouces (@code{in}), des millimètres (@code{mm}), des points (@code{pt}), +des « big points » (@code{bp}), etc. + +@node \addtolength +@section @code{\addtolength} +@findex \addtolength +@cindex longueur, ajouter à une + +Synopsis : + +@example +\addtolength@{\@var{longueur}@}@{@var{valeur}@} +@end example + +La commande @code{\addtolength} incrémente une commande de longueur +@code{\@var{longueur}} de la quantité spécifiée par l'argument +@var{quantité}, ce qui peut être négatif. + +@node \settodepth +@section @code{\settodepth} +@findex \settodepth + +Synopsis : + +@example +\settodepth@{\@var{longueur}@}@{@var{texte}@} +@end example + +La commande @code{\settodepth} règle la valeur d'une commande le +longueur @code{\@var{longueur}} à la profondeur de l'argument @code{texte}. + +@node \settoheight +@section @code{\settoheight} +@findex \settoheight + +Synopsis : + +@example +\settoheight@{\@var{longueur}@}@{@var{texte}@} +@end example + +La commande @code{\settoheight} règle la valeur d'une commande le +longueur @code{\@var{longueur}} à la hauteur de l'argument @code{texte}. + +@node \settowidth +@section @code{\settowidth} +@findex \settowidth + +Synopsis : + +@example +\settowidth@{\@var{longueur}@}@{@var{texte}@} +@end example + + +La commande @code{\settoheight} règle la valeur d'une commande le +longueur @code{\@var{longueur}} à la largeur de l'argument @code{texte}. + + +@node Predefined lengths +@section Longueurs prédéfinies +@cindex longueurs prédéfinies +@cindex prédéfinies, longueurs + +@code{\width} +@findex \width + +@code{\height} +@findex \height + +@code{\depth} +@findex \depth + +@code{\totalheight} +@findex \totalheight + +Ces paramètres de longueur peuvent être utilisés au sein des arguments +des commandes de fabrication de boîte (@pxref{Boxes}). Il spécifient la +largeur naturelle, etc., du texte dans la boîte. @code{\totalheight} +vaut @math{@code{@backslashchar{}height} + +@code{@backslashchar{}depth}}. Pour frabriquer une boîte dont le texte +est dilaté au double de sa taille naturelle, écrivez par ex.@: : + +@example +\makebox[2\width]@{Dilatez moi@} +@end example + + +@node Making paragraphs +@chapter Faire des paragraphes +@cindex Faire des paragraphes +@cindex paragraphes + +Un paragraphe se termine par une ou plusieurs lignes complètement blanches +--- des lignes ne contenant même pas un @code{%}. Une ligne à blanc ne +devrait pas apparaître là où un nouveau paragraphe n'a pas le droit de +commencer, tel que en mode mathématique ou dans l'argument d'une +commande de rubricage. + +@menu +* \indent:: Renfoncer ce paragraphe. +* \noindent:: Ne pas renfoncer ce paragraphe. +* \parskip:: L'espace ajouté avant les paragraphes. +* Notes en marge: Marginal notes. Mettre des remarques dans la marge. +@end menu + + +@node \indent +@section @code{\indent} +@findex \indent +@findex \parindent +@cindex renfoncement, forcer + +@code{\indent} produit un espace horizontal dont la largeur est égale à +la longueur @code{\parindent}, le +@cindex renfoncement, forcer +@dfn{renfoncement} normal d'un paragraphe. Elle est utilisée pour +ajouter un renfoncement de paragraphe là où il serait autrement +supprimé. + +La valeur par défaut de @code{\parindent} est @code{1em} en mode +@code{two-column}, autrement elle vaut @code{15pt} pour les documents +@code{10pt}, @code{17pt} pour @code{11pt}, et @code{1.5em} pour +@code{12pt}. + + +@node \noindent +@section @code{\noindent} +@findex \noindent +@cindex renfoncement, supprimer + +Utilisée au commencement d'un paragraphe, la commande +@code{\noindent} supprime tout renfoncement de paragraphe. + +@example +... fin du paragraphe précédent. + +\noindent Ce paragraphe n'est pas renfoncé. +@end example + + +Elle est sans effet quand elle est utilisée au milieu d'un paragraphe. + +Pour éliminer le renfoncement de paragraphe dans tout un document, mettez +@code{\setlength@{\parindent@}@{0pt@}} dans le préambule. + + +@node \parskip +@section @code{\parskip} +@findex \parskip +@cindex espace vertical avant les paragraphes + +@code{\parskip} est une longueur élastique définissant l'espace vertical +additionnel ajouté avant chaque paragraphe. La valeur par défaut est @code{0pt +plus1pt}. + + +@node Marginal notes +@section Notes en marge +@cindex Notes en marge +@cindex notes dans la marge +@cindex remarks in the marge +@findex \marginpar + +Synopsis : + +@example +\marginpar[@var{gauche}]@{@var{droite}@} +@end example + +La commande @code{\marginpar} crée une note dans la marge. La première +ligne de la note a la même ligne de base que la ligne dans le texte où le +@code{\marginpar} se trouve. + +Lorsque vous spécifiez seulement l'argument obligatoire @var{droite}, le texte +est placé + +@itemize @bullet +@item +dans la marge de droite pour une disposition en recto simple (option +@code{oneside}, voir @ref{Document class options}) ; +@item +dans la marge extérieure pour une disposition en recto-verso (option +@code{twoside}, voir @ref{Document class options}) ; +@item +dans la nearest la plus proche pour une disposition à deux colonnes +(option @code{twocolumn}, voir @ref{Document class options}). +@end itemize + +@findex \reversemarginpar +@findex \normalmarginpar +La commande @code{\reversemarginpar} place les notes en marge suivante +sur la marge opposée (interne). @code{\normalmarginpar} les replace +dans la position par défaut. + +Lorsque vous spécifier les deux arguments, @var{gauche} est utilisé pour +is used la marge de gauche, et @var{droite} est utilisé pour la marge de +is used droite. + +Le premier mot doit normalement ne pas être sujet à une césure ; Vous +pouvez activer la césure à cet endroit en commençant le nœud avec +@code{\hspace@{0pt@}}. + +Ces paramètres affectent le formattage de la note : + +@ftable @code +@item \marginparpush +Espace verticale minimale entre les notes ; par défaut @samp{7pt} pour +des documents à @samp{12pt}, @samp{5pt} sinon. + +@item \marginparsep +Espace horizontale entre le texte principal et la note ; par défaut +@samp{11pt} pour des documents à @samp{10pt}, @samp{10pt} sinon. + +@item \marginparwidth +Largeur de la note même ; la valeur par défaut est @samp{90pt} pour un +document en recto simple et à @samp{10pt} , @samp{83pt} pour +@samp{11pt}, et @samp{68pt} pour @samp{12pt} ; @samp{17pt} de plus dans +chacun de ces cas pour un document recto-verso. En mode à deux colonnes, +la valeur par défaut est @samp{48pt}. + +@end ftable + +La routine standarde de @LaTeX{} pour les notes en marge n'empêche pas +les notes de déborder hors du bas de la page. +@c @TeX{} FAQ entry on this topic (xx when there): +@c @url{http://www.tex.ac.uk/cgi-bin/texfaq2html?label=marginparside}. +@c (+marginfix) + + +@node Math formulas +@chapter Formules mathématiques + +@cindex formules mathématiques +@cindex formules, math +@cindex mode mathématique, entrer +@EnvIndex{math} +@EnvIndex{displaymath} +@EnvIndex{equation} +Il y a trois environnements qui mettent @LaTeX{} en mode mathématique : + +@table @code +@item math +Pour les formules qui apparaissent directement dans le texte. +@item displaymath +Pour les formules qui apparaissent sur leur propre ligne. +@item equation +Parail que l'environnement @code{displaymath} sauf qu'il ajoute un +numéro d'équation dans la marge de droite. +@end table + +@findex \( +@findex \) +@findex \[ +@findex \] +L'environnement @code{math} peut être utilsé aussi bien en mode +paragraphe qu'en mode LR, mais les environnements @code{displaymath} et +@code{equation} ne peuvent être utilisés qu'en mode paragraphe. Les +environnements @code{math} et @code{displaymath} sont utilisés si +souvent qu'ils ont les formes abrégées suivantes : + +@example +\(...\) @r{au lieu de} \begin@{math@}...\end@{math@} +\[...\] @r{au lieu de} \begin@{displaymath@}...\end@{displaymath@} +@end example + +@findex $ +En fait, l'environnement @code{math} est si fréquent qu'il a une forme +encore plus courte : + +@example +$ ... $ @r{au lieu de} \(...\) +@end example + +@findex \boldmath +@findex \unboldmath +La commande @code{\boldmath} change les lettres and symboles +mathématiques pour qu'il soient en gras. Elle est utilisée @emph{en +dehors} du mode mathématique. À l'inverse, la commande +@code{\unboldmath} change les glyphes mathématique pour qu'ils soient +dans une fonte normale ; elle aussi est à utiliser @emph{en dehors} du +mode mathématique. + +@c xx own section? Math fonts? +@findex \displaystyle +La déclaration @code{\displaystyle} force la taille et le style de la +formule à être ceux de @code{displaymath}, par ex., avec les limites au +dessus et en dessous le signe de sommation. Par exemple +@example +$\displaystyle \sum_@{n=0@}^\infty x_n $ +@end example + +@c xx see also \cal, \mathcal + +@menu +* Indices inférieurs & supérieurs: Subscripts & superscripts. Également connue comme exposant ou indice. +* Symboles mathématiques: Math symbols. Gribouillis mathématiques divers. +* Fonction mathématiques: Math functions. Nom de fonctions mathématiques comme sin et exp. +* Accents en math: Math accents. Accents en math. +* Espacement en mode mathématique: Spacing in math mode. Espaces épaisse, moyenne, fine et négative. +* Miscellanée mathématique: Math miscellany. Tout ce qu'on n'a pas pu casé ailleurs. +@end menu + + +@node Subscripts & superscripts +@section Indices inférieurs & supérieurs +@cindex indice supérieur +@cindex indice inférieur +@cindex exposant +@findex _ +@findex ^ + +En mode mathématique, utilisez le caractère caret @code{^} pour qu'une +expression @var{exp} apparaisse en indice supérieur, c.-à-d.@: tapez +@code{^@{}@var{exp}@code{@}}. Similairement, en mode mathémtique, +@code{_@{}@var{exp}@code{@}} fait un indice inférieur de @var{exp}. + +Dans cet exemple le @code{0} et le @code{1} apparaissent comme indices +inférieurs alors que le @code{2} est un indice supérieur. + +@example +\( (x_0+x_1)^2 \) +@end example + +Pour avoir plus d'un caractère au sein de @var{exp} utilisez des +accolades comme dans @code{e^@{-2x@}}. + +@LaTeX{} manipule la mise en indice supérieur d'un matériel et tout ce +qui tient de cela de la manière naturelle, de sorte que des expressions +telles que @code{e^@{x^2@}} et @code{x_@{a_0@}} seront composées comme +il faut. Il fait même ce qu'il faut quand quelque-chose a à la fois un +indice supérieur et un indice inférieur. Dans cet exemple le @code{0} +apparaît au bas du signe intégrale alors que le @code{10} apparaît en +haut. + +@example +\int_0^@{10@} x^2 \,dx +@end example + +Vous pouvez mettre un indice supérieur ou inférieur avant un symbole +avec une construction telle que @code{@{@}_t K^2} en mode mathématique +(le @code{@{@}} initial empèche l'indice préfixé d'être attaché à +quelque symbole qui le précède dans l'expression). + +En dehors du mode mathématique, une construction comme @code{Un +test$_\textnormal@{indice inf.@}$} produit un indice inférieur composé +en mode texte, non pas en mode mathémque. Notez qu'il y a des paquetage +spécialisée pour écrire des formule chimique, tel que @file{mhchem}. +@c xx display mode + + + +@node Math symbols +@section Symboles mathématiques +@cindex symboles mathématiques +@cindex symbols, mathématiques +@cindex Lettre grecques + +@LaTeX{} fournit presque tout symbole mathématique dont vous êtes +susceptible d'avoir besoin. Par exemple, si vous incluez @code{$\pi$} +dans votre code source, alors vous obtenez le symbole pi @BES{π,\pi}. + +Ci-dessous se trouve une liste de symboles généralement disponibles. Ce +n'est en aucun cas une liste exhaustive. Chaque symbole y est décrit +brièvement et avec sa classe de symbole (qui détermine l'espacement +autour de lui) qui est donnée entre parenthèses. Les commandes pour ces +symboles peuvent, sauf mention contraire, être utilisées seulement en +mode mathématique. + +Pour redéfinir une commande de sorte à pouvoir l'utiliser quel que soit +le mode, voir @ref{\ensuremath}. + +@c xx Add Negation: @code{} for negations of relevant symbols +@c Useful: http://www.w3.org/TR/WD-math-970515/section6.html + +@ftable @code +@item \| +@BES{∥,\|} Parallèle (relation). Synonyme : @code{\parallel}. + +@item \aleph +@BES{ℵ,\aleph} Aleph, cardinal transfini (ordinaire). + +@item \alpha +@BES{α,\alpha} Lettre grecque en bas de casse alpha (ordinaire). + +@item \amalg +@BES{⨿,\amalg} Union disjointe (binaire) + +@item \angle +@BES{∠,\angle} Angle géometrique (ordinaire). Similaire : +sign inférieur-à @code{<} et chevron @code{\langle}. + +@item \approx +@BES{≈,\approx} Presque égal à (relation). + +@item \ast +@BES{∗,\ast} Opérateur astérisque, convolution, à six branches +(binaire). Synonyme : @code{*}, ce qui est souvent un indice +supérieur ou inférieur, comme dans l'étoile de +Kleene. Similaire : @code{\star}, qui est à cinq branches, et est +quelque-fois utilisée comme une opération binaire générale, and +quelques-fois reservée pour la corrélation-croisée. + +@item \asymp +@BES{≍,\asymp} Équivalent asymptomatiquement (relation). + +@item \backslash +\ contr'oblique (ordinaire). Similaire : soustraction +d'ensemble @code{\setminus}, et @code{\textbackslash} pour une +contr'oblique en-dehors du mode mathématique. + +@item \beta +@BES{β,\beta} Lettre grecque en bas de casse beta (ordinaire). + +@item \bigcap +@BES{⋂,\bigcap} De taille Variable, ou n-aire, intersection (opérateur). Similaire : +intersection binaire @code{\cap}. + +@item \bigcirc +@BES{⚪,\bigcirc} Cercle, plus grand (binaire). Similaire : composition de +fonction @code{\circ}. +@c bb Best unicode symbol for this? + +@item \bigcup +@BES{⋃,\bigcup} De taille variable, ou n-aire, union (opérateur). Similaire : union +binaire @code{\cup}. + +@item \bigodot +@BES{⨀,\bigodot} De taille variable, ou n-aire, opérateur point encerclé (opérateur). + +@item \bigoplus +@BES{⨁,\bigoplus} De taille variable, ou n-aire, opérateur plus encerclé (opérateur). + +@item \bigotimes +@BES{⨂,\bigotimes} De taille variable, ou n-aire, opérateur multiplié encerclé (opérateur). + +@item \bigtriangledown +@BES{▽,\bigtriangledown} De taille variable, ou n-aire, triangle ouvert +pointant vers le bas(opérateur). + +@item \bigtriangleup +@BES{△,\bigtriangleup} De taille variable, ou n-aire, triangle ouvert +pointant vers le haut (opérateur). + +@item \bigsqcup +@BES{⨆,\bigsqcup} De taille variable, ou n-aire, union carrée (opérateur). + +@item \biguplus +@BES{⨄,\biguplus} De taille variable, ou n-aire, opérateur union avec un plus +(opérateur). (Notez que le nom a juste un p.) + +@item \bigvee +@BES{⋁,\bigvee} De taille variable, ou n-aire, et-logique (opérateur). + +@item \bigwedge +@BES{⋀,\bigwedge} De taille variable, ou n-aire, ou-logique (opérateur). + +@item \bot +@BESU{⊥,bot} Taquet vers le haut, minimum, plus petit élément d'un ensemble +partiellement ordonné, ou une contradiction +(ordinaire). Voir aussi @code{\top}. + +@item \bowtie +@BES{⋈,\bowtie} Jonction naturelle de deux relations (relation). + +@item \Box +@BESU{□,Box} Opérateur modal pour la nécessité ; boîte ouverte carrée +(ordinaire). @value{NeedsAMSSymb} +@c bb Best Unicode equivalent? + +@item \bullet +@cindex symbole puce +@BES{•,\bullet} Puce (binaire). Similaire : point de +multiplication @code{\cdot}. + +@item \cap +@BES{∩,\cap} Intersection de deux ensembles (binaire). Similaire : +opérateur de taille variable @code{\bigcap}. + +@item \cdot +@BES{⋅,\cdot} Multiplication (binaire). Similaire : Point +puce @code{\bullet}. + +@item \chi +@BES{χ,\chi} Lettre grecque en bas de casse chi (ordinaire). + +@item \circ +@BES{∘,\circ} Composition de fonctions, opérateur rond (binaire). Similaire : +opérateur de taille variable @code{\bigcirc}. + +@item \clubsuit +@BES{♣,\clubsuit} Trèfle de carte à jouer (ordinaire). + +@item \complement +@BESU{∁,complement} Complement d'ensemble, utilisée en indice supérieur +comme dans @code{$S^\complement$} (ordinaire). @value{NeedsAMSSymb} On utilise aussi : @code{$S^@{\mathsf@{c@}@}$} +ou @code{$\bar@{S@}$}. + +@item \cong +@BES{≅,\cong} Congruent (relation). + +@item \coprod +@BES{∐,\coprod} Coproduit (opérateur). + +@item \cup +@BES{∪,\cup} Réunion de deux ensembles (binaire). opérateur de taille +variable @code{\bigcup}. + +@item \dagger +@BES{†,\dagger} Relation obèle (binaire). + +@item \dashv +@BES{⊣,\dashv} Taquet gauche, tiret avec barre verticale à droite, +tourniquet pour gauchers (relation). Similaire : taquet droit, +tourniquet @code{\vdash}. + +@item \ddagger +@BES{‡,\ddagger} Relation double obèle (binaire). + +@item \Delta +@BES{Δ,\Delta} Delta grec capital, utilisé pour indiquer une +incrémentation (ordinaire). + +@item \delta +@BES{δ,\delta} Delta grec bas-de-casse (ordinaire). + +@item \Diamond +@BESU{◇,Diamond} Opérateur grand carreau (ordinaire). @value{NeedsAMSSymb} +@c bb Best Unicode equivalent? + +@item \diamond +@BES{⋄,\diamond} Opérateur Carreau, ou puce carreau (binaire). Similaire : grand +carreau @code{\Diamond}, puce disque @code{\bullet}. + +@item \diamondsuit +@BES{♢,\diamondsuit} Carreau de carte à jouer (ordinaire). + +@item \div +@BES{÷,\div} Signe de division, obélus (binaire). + +@item \doteq +@BES{≐,\doteq} Approche la limite (relation). Similaire : +géométriquement égal à @code{\Doteq}. + +@item \downarrow +@BES{↓,\downarrow} Flèche vers le bas, converge (relation). Similaire : +flèche à ligne double vers le bas @code{\Downarrow}. + +@item \Downarrow +@BES{⇓,\Downarrow} Flèche à ligne double vers le bas (relation). +Similaire : flèche à ligne simple vers le bas @code{\downarrow}. + +@item \ell +@BES{ℓ,\ell} Lettre l bas de casse cursive (ordinaire). + +@item \emptyset +@BES{∅,\emptyset} Symbole ensemble vide (ordinaire). La forme en +variante est @code{\varnothing}. +@c bb Why Unicode has \revemptyset but no \emptyset? + +@item \epsilon +@BES{ϵ,\epsilon} Lettre grecque bas de casse epsilon lunaire +(ordinaire). Sembable à la lettre en texte grec. En mathématiques on +utilise plus fréquemment l'epsilon minuscule de ronde +@code{\varepsilon} @BES{ε,\varepsilon}. En relation avec : la relation +ensembliste « appartenir à » @code{\in} @BES{∈,\in}. +@c src: David Carlisle http://tex.stackexchange.com/a/98018/339 and +@c Unicode referenced there asserts varepsilon is much more widely used. + +@item \equiv +@BES{≡,\equiv} Équivalence (relation). + +@item \eta +@BES{η,\eta} Lettre grecque en bas de casse (ordinaire). + +@item \exists +@BES{∃,\exists} Quanteur « Il existe » (ordinaire). + +@item \flat +@BES{♭,\flat} Bémol (ordinaire). + +@item \forall +@BES{∀,\forall} Quanteur « Pour tout » (ordinaire). + +@item \frown +@BES{⌢,\frown} Moue (ordinaire). + +@item \Gamma +@BES{Γ,\Gamma} Lettre grecque en capitale (ordinaire). + +@item \gamma +@BES{γ,\gamma} Lettre grecque en bas de casse (ordinaire). + +@item \ge +@BES{≥,\ge} Supérieur ou égal à (relation). Synonyme : @code{\geq}. + +@item \geq +@BES{≥,\geq} Supérieur ou égal à (relation). Synonyme : @code{\ge}. + +@item \gets +@BES{←,\gets} Auquel est assignée la valeur (relation). +Synonyme : @code{\leftarrow}. + +@item \gg +@BES{≫,\gg} Beaucoup plus grand que (relation). Similaire : Beaucoup +plus petit que @code{\ll}. + +@item \hbar +@BES{ℏ,\hbar} Constante de Planck sur deux pi (ordinaire). + +@item \heartsuit +@BES{♡,\heartsuit} Cœur de carte jouer (ordinaire). + +@item \hookleftarrow +@BES{↩,\hookleftarrow} Flèche vers la gauche avec crochet (relation). + +@item \hookrightarrow +@BES{↪,\hookrightarrow} Flèche vers la gauche avec crochet (relation). + +@item \iff +@BES{⟷,\iff} Si et seulement si (relation). C'est un @code{\Longleftrightarrow} +avec un @code{\thickmuskip} de chaque côté. + +@item \Im +@BES{ℑ,\Im} Partie imaginaire (ordinaire). Voir aussi : partie réelle @code{\Re}. + +@item \in +@BES{∈,\in} Appartient à (relation). Voir aussi : lettre grecque bas de +casse epsilon lunaire @code{\epsilon} @BES{ϵ,\epsilon} et l'epsilon +minuscule de ronde @code{\varepsilon}. + +@item \infty +@BES{∞,\infty} Infini (ordinaire). + +@item \int +@BES{∫,\int} Intégrale (opérateur). + +@item \iota +@BES{ι,\iota} Lettre grecque en bas de casse (ordinaire). + +@item \Join +@BESU{⨝,Join} Symbole jointure condensé (relation). @value{NotInPlainTeX} + +@item \kappa +@BES{κ,\kappa} Lettre grecque en bas de casse (ordinaire). + +@item \Lambda +@BES{Λ,\Lambda} Lettre grecque en capitale (ordinaire). + +@item \lambda +@BES{λ,\lambda} Lettre grecque en bas de casse (ordinaire). + +@item \land +@BES{∧,\land} Et logique (binaire). Synonyme : @code{\wedge}. +Voir aussi ou-logique @code{\lor}. + +@item \langle +@BES{⟨,\langle} Chevron mathématique gauche, ou séquence, crochet +(ouvrant). Similaire : inférieur à @code{<}. Correspond +à @code{\rangle}. + +@item \lbrace +@BES{@lbracechar{},\lbrace} Accolade gauche +(ouvrant). Synonyme : @code{\@{}. Correspond à @code{\rbrace}. + +@item \lbrack +@BES{[,\lbrack} Crochet gauche (ouvrant). +Synonyme : @code{[}. Correspond à @code{\rbrack}. + +@item \lceil +@BES{⌈,\lceil} Plafond à gauche, ressemble à un crochet mais avec le +pied coupé (ouvrant). Correspond à @code{\rceil}. + +@item \le +@BES{≤,\le} Inférieur ou égal à (relation). C'est un synonyme +de @code{\leq}. + +@item \leadsto +@BESU{⇝,leadsto} flèche vers la droite en tire-bouchon (relation). @value{NeedsAMSSymb} + +@item \Leftarrow +@BES{⇐,\Leftarrow} Est impliqué par, flèche vers la gauche à +double-ligne (relation). Similaire : flèche vers la gauche à simple +ligne @code{\leftarrow}. + +@item \leftarrow +@BES{←,\leftarrow} Flèche vers la gauche à simple ligne (relation). +Synonyme : @code{\gets}. Similaire : Flèche vers la gauche à +double-ligne @code{\Leftarrow}. + +@item \leftharpoondown +@BES{↽,\leftharpoondown} Harpon vers la gauche à simple ligne avec +crochet vers le bas (relation). + +@item \leftharpoonup +@BES{↼,\leftharpoonup} Harpon vers la gauche à simple ligne avec +crochet vers le haut (relation). + +@item \Leftrightarrow +@BES{⇔,\Leftrightarrow} Bi-implication ; double flèche bilatérale +(relation). Similaire : flèche bilatérale @code{\leftrightarrow}. + +@item \leftrightarrow +@BES{↔,\leftrightarrow} Flèche bilatérale (relation). Similaire : +double flèche bilatérale @code{\Leftrightarrow}. + +@item \leq +@BES{≤,\leq} Inférieur ou égal à (relation). Synonyme : @code{\le}. + +@item \lfloor +@BES{⌊,\lfloor} Plancher à gauche (ouvrant). Correspond à : +@code{\rfloor}. + +@item \lhd +@BESU{◁,lhd} Pointe de flèche, c.-à-d.@: triangle pointant vers la +gauche (binaire). @value{NeedsAMSSymb} For the normal +subgroup symbol you should load @file{amssymb} and +use @code{\vartriangleleft} (qui est une relation et ainsi donne un +meilleur espacement). + +@item \ll +@BES{≪,\ll} Beaucoup plus petit que (relation). Similaire : Beaucoup +plus grand que @code{\gg}. + +@item \lnot +@BES{¬,\lnot} Négation logique (ordinaire). Synonyme : @code{\neg}. + +@item \longleftarrow +@BES{⟵,\longleftarrow} Longue flèche vers la gauche à ligne simple (relation). +Similaire : longue flèche gauche à ligne double @code{\Longleftarrow}. + +@item \longleftrightarrow +@BES{⟷,\longleftrightarrow} Longue flèche bilatérale à ligne simple +(relation). Similaire : longue flèche bilatérale à ligne +double @code{\Longleftrightarrow}. + +@item \longmapsto +@BES{⟼,\longmapsto} Longue flèche d'un taquet vers la droite à ligne +simple (relation). Similaire : version courte @code{\mapsto}. + +@item \longrightarrow +@BES{⟶,\longrightarrow} Longue flèche vers la droite à ligne simple +(relation). Similaire : longue flèche vers la droite à ligne +double @code{\Longrightarrow}. + +@item \lor +@BES{∨,\lor} Ou-logique (binaire). Synonyme : @code{\wedge}. + +@item \mapsto +@BES{↦,\mapsto} Flèche d'un taquet vers la droite (relation). + Similaire : version longue @code{\longmapsto}. + +@item \mho +@BESU{℧,mho} Conductance, symbole Ohm culbuté (ordinaire). @value{NeedsAMSSymb} + +@item \mid +@BES{∣,\mid} Barre verticale à ligne simple (relation). une utilisation +typique de @code{\mid} est pour un ensemble @code{\@{\, x \mid x\geq 5 +\,\@}}. + +Similaire : @code{\vert} et @code{|} produisent le même symbole de barre +verticale à ligne simple mais sans aucun espacement (on les classe comme +« ordinaires ») et vous ne devriez pas les utiliser comme symbole de +relation mais seulement comme des ordinaux, c.-à-d.@: comme des symboles +de note en bas de page. Pour dénoter une valeur absolue, voir l'entrée +de @code{\vert} et pour une norme voir l'entrée de @code{\Vert}. + +@item \models +@BES{⊨,\models} Vrai, ou satisfait ; double turnstile, short double dash +(relation). Similaire : long double dash @code{\vDash}. + +@item \mp +@BES{∓,\mp} Moins ou plus (relation). + +@item \mu +@BES{μ,\mu} Lettre grecque en bas de casse (ordinaire). + +@item \nabla +@BES{∇,\nabla} Del de Hamilton, ou différentiel, opérateur (ordinaire). + +@item \natural +@BES{♮,\natural} Bécarre (ordinaire). + +@item \ne +@BES{≠,\ne} Non égal (relation). Synonyme : @code{\neq}. + +@item \nearrow +@BES{↗,\nearrow} Flèche nord-est (relation). + +@item \neg +@BES{¬,\neg} Négation logique (ordinaire). +Synonyme : @code{\lnot}. Utilisé parfois au lieu du symbole de +négation: @code{\sim}. + +@item \neq +@BES{≠,\neq} Non égal (relation). Synonyme : @code{\ne}. + +@item \ni +@BES{∋,\ni} Signe d'appartenance réfléchi ; « contient comme élément » +(relation). Synonyme : @code{\owns}. Similaire : « appartient +à » @code{\in}. + +@item \not +@BES{ ,\not}@BES{ ,}@BES{̸,} Barre oblique longue utilisée pour rayer un + opérateur la suivant (relation). +@c Need blank space for it to overstrike + +Beaucoup opérateurs en négation qui n'ont pas besoin de @code{\not} sont +disponibles, en particulier avec le paquetage @file{amssymb}. Par +exemple, @code{\notin} est sans doute préférable à @code{\not\in} d'un +point de vue typographique. + +@item \notin +@BES{∉,\notin} N'appartient pas à (relation). Similaire : non contenu +dans @code{\nsubseteq}. + +@item \nu +@BES{ν,\nu} Lettre grecque en bas de casse (ordinaire). + +@item \nwarrow +@BES{↖,\nwarrow} Flèche nord-ouest (relation). + +@item \odot +@BES{⊙,\odot} Point cerclé (binaire). Similaire : opérateur de taille +variable @code{\bigodot}. + +@item \oint +@BES{∮,\oint} Intégrale de contour, intégrale avec un cercle au milieu (opérateur). + +@item \Omega +@BES{Ω,\Omega} Lettre grecque en capitale (ordinaire). + +@item \omega +@BES{ω,\omega} Lettre grecque en bas de casse (ordinaire). + +@item \ominus +@BES{⊖,\ominus} Signe moins, ou tiret, cerclé (binaire). + +@item \oplus +@BES{⊕,\oplus} Signe plus cerclé (binaire). Similaire : opérateur de +taille variable @code{\bigoplus}. + +@item \oslash +@BES{⊘,\oslash} Barre de fraction, ou barre oblique, cerclée (binaire). + +@item \otimes +@BES{⊗,\otimes} Signe de multiplication, ou croix, cerclé (binaire). Similaire : +opérateur de taille variable @code{\bigotimes}. + +@item \owns +@BES{∋,\owns} Epsilon d'appartenance réfléchi ; « contient comme +élément » (relation). Synonyme : @code{\ni}. Similaire : appartient +à @code{\in}. + +@item \parallel +@BES{∥,\parallel} Parallèle (relation). Synonyme : @code{\|}. + +@item \partial +@BES{∂,\partial} Différentielle partielle (ordinaire). + +@item \perp +@BES{⟂,\perp} Perpendiculaire (relation). Similaire : @code{\bot} +utilise le même glyphe mais l'espacement est différent parce qu'il est +dans la classe ordinaire. + +@item \phi +@BES{ϕ,\phi} Lettre grecque en bas de casse (ordinaire). La forme en variante est +@code{\varphi} @BES{φ,\varphi}. + +@item \Pi +@BES{Π,\Pi} Lettre grecque en capitale (ordinaire). + +@item \pi +@BES{π,\pi} Lettre grecque en bas de casse (ordinaire). La forme en variante est +@code{\varpi} @BES{ϖ,\varpi}. + +@item \pm +@BES{±,\pm} Plus or minus (binaire). + +@item \prec +@BES{≺,\prec} Précède (relation). Similaire : inférieur à @code{<}. + +@item \preceq +@BES{⪯,\preceq} Précède ou égal, précède par-dessus signe égal à une +ligne (relation). Similaire : inférieur ou égal @code{\leq}. + +@item \prime +@BES{′,\prime} Prime, ou minute au sein d'une expression temporelle +(ordinaire). Typiquement utilisé en indice supérieur @code{$A^\prime$}. +Il est à noter sque @code{$f^\prime$} et @code{$f'$} produisent le même +résultat. Un avantage de la seconde forme est que @code{$f'''$} produit +le symbole désiré, c.-à-d.@: le même résultat que +@code{$f^@{\prime\prime\prime@}$}, mais en nécessitant moins de +saisie. Il est à noter que vous ne pouvez utiliser @code{\prime} qu'en +mode mathématique. Utiliser le quote @code{'} en mode texte produit un +caractère différent (apostrophe ou guillemet anglais simple de droite). + +@item \prod +@BES{∏,\prod} Produit (opérateur). + +@item \propto +@BES{∝,\propto} Proportionnel à (relation) + +@item \Psi +@BES{Ψ,\Psi} Lettre grecque en capitale (ordinaire). + +@item \psi +@BES{ψ,\psi} Lettre grecque en bas de casse (ordinaire). + +@item \rangle +@BES{⟩,\rangle} Chevron mathématique droit, ou séquence, crochet +(fermant). Similaire : supérieur à @code{>}. Correspond +à @code{\langle}. + +@item \rbrace +@BES{@rbracechar{},\rbrace} Accolade de droite +(fermante). Synonyme : @code{\@}}. Correspond à @code{\lbrace}. + +@item \rbrack +@BES{],\rbrack} Crochet droit (fermant). Synonyme : @code{]}. Correspond +à @code{\lbrack}. + +@item \rceil +@BES{⌉,\rceil} Plafond droit (fermant). Correspond à @code{\lceil}. + +@item \Re +@BES{ℜ,\Re} Partie réelle, nombres réels, R capital gothique +(ordinaire). En relation avec : R majuscule ajouré, ou gras de tableau +d'école @code{\mathbb@{R@}} ; pour accéder à cela charger le paquetage +@file{amsfonts}. + +@item \restriction +@BESU{↾,restriction} Restriction d'une fonction +(relation). Synonyme : @code{\upharpoonright}. @value{NeedsAMSSymb} + +@item \revemptyset +@BESU{⦰,revemptyset} Symbole ensemble vide inversé (ordinaire). +En relation avec : @code{\varnothing}. @value{NeedsSTIX} + +@item \rfloor +@BES{⌋,\rfloor} Plancher droit, un crochet droit avec la dent du haut +coupée (fermant). Correspond à @code{\lfloor}. + +@item \rhd +@BESU{◁,rhd} Pointe de flèche, c.-à-d.@: u triangle pointant vers la +droite (binaire). @value{NeedsAMSSymb} Pour le symbole +normal de sousgroupe vous devriez plutôt charger @file{amssymb} et +utiliser @code{\vartriangleright} (qui est une relation et ainsi donne +un meilleur espacement). + +@item \rho +@BES{ρ,\rho} Lettre grecque en bas de casse (ordinaire). La forme en variante est +@code{\varrho} @BES{ϱ,\varrho}. + +@item \Rightarrow +@BES{⇒,\Rightarrow} Implique, flèche vers la droite à double-ligne +(relation). Similaire : flèche vers la droite @code{\rightarrow}. + +@item \rightarrow +@BES{→,\rightarrow} Flèche vers la droite à ligne simple +(relation). Synonyme : @code{\to}. Similaire : flèche vers droite à +ligne double @code{\Rightarrow}. + +@item \rightharpoondown +@BES{⇁,\rightharpoondown} Harpon vers la droite avec crochet vers le bas +(relation). + +@item \rightharpoonup +@BES{⇀,\rightharpoonup} Harpon vers la droite avec crochet vers la haut (relation). + +@item \rightleftharpoons +@BES{⇌,\rightleftharpoons} Harpon vers la droite avec crochet vers le +haut au dessus d'un harpon vers la gauche avec crochet vers le bas +(relation). + +@item \searrow +@BES{↘,\searrow} Flèche pointant sud-est (relation). + +@item \setminus +@BES{⧵,\setminus} Difference ensembliste, barre de faction inversée ou +contr'oblique, comme \ (binaire). Similaire : +contr'oblique @code{\backslash} et aussi @code{\textbackslash} hors du +mode mathémaitque. + +@item \sharp +@BES{♯,\sharp} Dièse (ordinaire). + +@item \Sigma +@BES{Σ,\Sigma} Lettre grecque en capitale (ordinaire). + +@item \sigma +@BES{σ,\sigma} Lettre grecque en bas de casse (ordinaire). La forme en +variante est @code{\varsigma} @BES{ς,\varsigma}. + +@item \sim +@BES{∼,\sim} Similaire à, dans une relation (relation). + +@item \simeq +@BES{≃,\simeq} Similaire ou égal à, dans une relation (relation). + +@item \smallint +@BES{∫,\smallint} Signe intégrale qui ne change pas en taille plus +grande au sein d'une formule hors texte (opérateur). + +@item \smile +@BES{⌣,\smile} Arc concave en haut, sourire (ordinaire). + +@item \spadesuit +@BES{♠,\spadesuit} Pique de carte à jouer (ordinaire). + +@item \sqcap +@BES{⊓,\sqcap} Symbole d'intersection carré (binaire). Similaire : +intersection @code{cap}. + +@item \sqcup +@BES{⊔,\sqcup} Symbole d'union carré (binaire). Similaire : +union @code{\cup}. En relation avec : opérateur de taille +variable @code{\bigsqcup}. + +@item \sqsubset +@BESU{⊏,sqsubset} Symbole carré de sous-ensemble (relation). Similaire : +sous-ensemble @code{\subset}. @value{NeedsAMSSymb} + +@item \sqsubseteq +@BES{⊑,\sqsubseteq} Symbole carré de sous-ensemble ou égal à +(binaire). Similaire : subset or égal à @code{\subseteq}. + +@item \sqsupset +@BESU{⊐,sqsupset} Symbole carré de sur-ensemble (relation). Similaire : +superset @code{\supset}. @value{NeedsAMSSymb} + +@item \sqsupseteq +@BES{⊒,\sqsupseteq} Symbole carré de sur-ensemble ou égal à +(binaire). Similaire : sur-ensemble ou égal @code{\supseteq}. + +@item \star +@BES{⋆,\star} Étoile à cinq branches, quelque-fois utilisée comme une +opération binaire générale mais quelque-fois réservée pour la +corrélation croisée (binaire). Similaire : les +synonymes astérisque @code{*} anet @code{\ast}, qui sont à six branches, +et apparaissent plus souvent comme indice supérieur et inférieur, comme +c'est le cas avec l'étoile de Kleene. + +@item \subset +@BES{⊂,\subset} Est contenu (occasionnellement, est impliqué par) (relation). + +@item \subseteq +@BES{⊆,\subseteq} Est contenu ou égal à (relation). + +@item \succ +@BES{≻,\succ} Vient après, suit (relation). Similaire : inférieur +à @code{>}. + +@item \succeq +@BES{⪰,\succeq} Suit ou est égal à (relation). Similaire : inférieur ou égal à @code{\leq}. + +@item \sum +@BES{∑,\sum} Summation (opérateur). Similaire : Lettre grecque +capitale @code{\Sigma}. + +@item \supset +@BES{⊃,\supset} Contient (relation). + +@item \supseteq +@BES{⊇,\supseteq} Contient ou est égal à (relation). + +@item \surd +@BES{√,\surd} Symbole racine (ordinaire). La commande @LaTeX{} +@code{\sqrt@{..@}} compose la racine de l'argument, avec une barre qui +s'étend pour couvrir l'argument. + +@item \swarrow +@BES{↙,\swarrow} Flèche pointant au sud-ouest (relation). + +@item \tau +@BES{τ,\tau} Lettre grecque en bas de casse (ordinaire). + +@item \theta +@BES{θ,\theta} Lettre grecque en bas de casse (ordinaire). La forme en +variante est @code{\vartheta} @BES{ϑ,\vartheta}. + +@item \times +@BES{×,\times} Signe de multiplication d'école primaire (binaire). Voir aussi @code{\cdot}. + +@item \to +@BES{→,\to} Flèche en ligne simple vers la droite (relation). +Synonyme : @code{\rightarrow}. + +@item \top +@BESU{⊤,top} Taquet vers le haut ; dessus, plus grand élément d'un +poset (ordinaire). Voir aussi @code{\bot}. + +@item \triangle +@BES{△,\triangle} Triangle (ordinaire). + +@item \triangleleft +@BES{◁,\triangleleft} Triangle non-rempli pointant à gauche +(binaire). Similaire : @code{\lhd}. Pour le symbole normal de +sous-groupe vous devez charger @file{amssymb} et +utiliser @code{\vartriangleleft} (qui est une relation et ainsi +donne un meilleur espacement). + +@item \triangleright +@BES{▷,\triangleright} Triangle non-rempli pointant à droite +(binaire). Pour le symbole normal de sousgroupe vous devez à la place +charger @file{amssymb} et utiliser @code{\vartriangleright} (qui +est une relation et ainsi donne un meilleur espacement). + +@item \unlhd +@BESU{⊴,unlhd} Pointe de flèche non-pleine soulignée pointant vers la +gauche, c.-à-d.@: triangle avec une ligne en dessous +(binaire). @value{NeedsAMSSymb} Pour le symbole normal de sous-groupe +chargez @file{amssymb} et utilisez @code{\vartrianglelefteq} (qui est +une relation et ainsi donne un meilleur espacement). + +@item \unrhd +@BESU{⊵,unrhd} Pointe de flèche non-pleine soulignée pointant vers la +droite, c.-à-d.@: triangle avec une ligne en dessous +(binaire). @value{NeedsAMSSymb} Pour le symbole normal de sous-groupe +chargez @file{amssymb} et utilisez @code{\vartrianglerighteq} (qui est +une relation et ainsi donne un meilleur espacement). + +@item \Uparrow +@BES{⇑,\Uparrow} Flèche vers le haut à ligne double +(relation). Similaire : flèche vers le haut à ligne +simple @code{\uparrow}. + +@item \uparrow +@BES{↑,\uparrow} Single-line upward-pointing flèche, diverges (relation). Similaire : +double-line up-pointing flèche @code{\Uparrow}. + +@item \Updownarrow +@BES{⇕,\Updownarrow} Double-line upward-and-downward-pointing flèche (relation). Similaire : +single-line upward-and-downward-pointing flèche @code{\updownarrow}. + +@item \updownarrow +@BES{↕,\updownarrow} flèche haut et bas à ligne simple (relation). Similaire : +flèche haut et bas à ligne double @code{\Updownarrow}. + +@item \upharpoonright +@BESU{↾,upharpoonright} Harpon vers le haut avec crochet à droite +(relation). Synonyme : @code{@backslashchar{}restriction}. +@value{NeedsAMSSymb} + +@item \uplus +@BES{⊎,\uplus} Union de multiensemble, un symbole union avec un symbole +plus en son sein (binaire). Similaire : union @code{\cup}. En relation +avec : opérateur de taille variable @code{\biguplus}. + +@item \Upsilon +@BES{Υ,\Upsilon} Lettre grecque en capitale (ordinaire). + +@item \upsilon +@BES{υ,\upsilon} Lettre grecque en bas de casse (ordinaire). + +@item \varepsilon +@BES{ε,\varepsilon} Epsilon de ronde en bas de casse (ordinaire). Plus +largement utilise en mathematique que la forme non variante epsilon +lunaire @code{\epsilon} @BES{ϵ,\epsilon}. En relation avec : +« appartient à » @code{\in}. + +@item \vanothing +@BESU{∅,varnothing} Symbole ensemble vide. Similaire : +@code{\emptyset}. En relation avec : +@code{\revemptyset}. @value{NeedsAMSSymb} + +@item \varphi +@BES{φ,\varphi} Variante de la lettre grecque bas de casse (ordinaire). +La forme non en variante est @code{\phi} @BES{ϕ,\phi}. + +@item \varpi +@BES{ϖ,\varpi} Variante de la lettre grecque bas de casse (ordinaire). +La forme non en variante est @code{\pi} @BES{π,\pi}. + +@item \varrho +@BES{ϱ,\varrho} Variante de la lettre grecque bas de casse (ordinaire). +La forme non en variante est @code{\rho} @BES{ρ,\rho}. + +@item \varsigma +@BES{ς,\varsigma} Variante de la lettre grecque bas de casse +(ordinaire). La forme non en variante est @code{\sigma} @BES{σ,\sigma}. + +@item \vartheta +@BES{ϑ,\vartheta} Variante de la lettre grecque bas de casse +(ordinaire). La forme non en variante est @code{\theta} @BES{θ,\theta}. + +@item \vdash @BES{⊢,\vdash} Taquet droit ; prouve, implique ; +portillon/tourniquet ; barre verticale et un tiret +(relation). Similaire : portillon inversé @code{\dashv}. + +@item \vee +@BES{∨,\vee} Ou logique ; une forme de v pointant vers le bas +(binaire). En relation avec : Et logique @code{\wedge}. Similaire : +Opérateur de taille variable @code{\bigvee}. + +@item \Vert +@BES{‖,\Vert} Double barre verticale (ordinaire). Similaire : barre +verticale simple @code{\vert}. + +Pour une norme vous pouvez utiliser le paquetage @file{mathtools} et +ajouter @code{\DeclarePairedDelimiter\norm@{\lVert@}@{\rVert@}} à votre +préambule. Ceci vous donne trois variantes de commande pour faire des +barres verticales correctement espacées horizontalement : si dans le +corps du document vous écrivez la version étoilée +@code{$\norm*@{M^\perp@}$} alors la hauteur des barres verticales +correspond à celle de l'argument, alors qu'avec @code{\norm@{M^\perp@}} +les barres ne grnadissent pas avec la hauteur de l'argument mais à la +place reste de la hauteur par défaut, et +@code{\norm[@var{commande-taille}]@{M^\perp@}} donne aussi des barres +qui ne grandissent pas mais sont de la taille donnée dans la +@var{commande-taille}, par ex.@: @code{\Bigg}. + +@item \vert +@BES{|,\vert} Barre verticale simple (ordinaire). Similaire : barre à +double-ligne verticale @code{\Vert}. Pour usage tel qu'au sein de la +définition d'un ensemble, utilisez @code{\mid} parce que c'est une +relation. + +Pour une valeur aboslue vous pouvez utilise le paquetage +@file{mathtools} et ajouter +@code{\DeclarePairedDelimiter\abs@{\lvert@}@{\rvert@}} à votre +préambule. Ceci vous donne trois variantes de commande pour les barres +simples verticales qui sont correctement espacées verticalement : si +dans le corps du document vous écrivrez la version étoilée +@code{$\abs*@{\frac@{22@}@{7@}@}$} alors la hauteur des barres +verticales correspond à la hauteur de l'argument, alors qu'avec +@code{\abs@{\frac@{22@}@{7@}@}} les pabarres ne grandissent pas avec +l'argument ais à la place sont de la hauteur par défaut, et +@code{\abs[@var{commande-taille}]@{\frac@{22@}@{7@}@}} donne aussi des +barres qui ne grandissent pas mais qui sont rélgées à la taille donnée +par la @var{commande-taille}, par ex.@: @code{\Bigg}. + +@item \wedge +@BES{∧,\wedge} Et logique (binaire). Synonyme : @code{\land}. Voir aussi +ou logique @code{\vee}. Similaire : opérateur de taille variable @code{\bigwedge}. + +@item \wp +@BES{℘,\wp} « p » de Weierstrass, fonction elliptique de +Weierstrass (ordinaire). + +@item \wr +@BES{≀,\wr} Produit couronnne (binaire). + +@item \Xi +@BES{Ξ,\Xi} Lettre grecque en capitale (ordinaire). + +@item \xi +@BES{ξ,\xi} Lettre grecque en bas de casse (ordinaire). + +@item \zeta +@BES{ζ,\zeta} Lettre grecque en bas de casse (ordinaire). + +@end ftable + +@node Math functions +@section Fonctions mathématiques +@cindex fonctions mathématiques +@cindex math, fonctions + +En mode mathématique ces commandes produisent des noms de fonction en +police romaine et avec l'espacement adéquat. + +@ftable @code +@item \arccos +@math{\arccos} + +@item \arcsin +@math{\arcsin} + +@item \arctan +@math{\arctan} + +@item \arg +@math{\arg} + +@item \bmod +Opérateur modulo binaire (@math{x \bmod y}) + +@item \cos +@math{\cos} + +@item \cosh +@math{\cosh} + +@item \cot +@math{\cos} + +@item \coth +@math{\cosh} + +@item \csc +@math{\csc} + +@item \deg +@math{\deg} + +@item \det +@math{\deg} + +@item \dim +@math{\dim} + +@item \exp +@math{\exp} + +@item \gcd +@math{\gcd} + +@item \hom +@math{\hom} + +@item \inf +@math{\inf} + +@item \ker +@math{\ker} + +@item \lg +@math{\lg} + +@item \lim +@math{\lim} + +@item \liminf +@math{\liminf} + +@item \limsup +@math{\limsup} + +@item \ln +@math{\ln} + +@item \log +@math{\log} + +@item \max +@math{\max} + +@item \min +@math{\min} + +@item \pmod +Modulo parenthésé, comme dans (@math{\pmod 2^n - 1}) + +@item \Pr +@math{\Pr} + +@item \sec +@math{\sec} + +@item \sin +@math{\sin} + +@item \sinh +@math{\sinh} + +@item \sup +@iftex +@math{\mathop {\rm sup}} +@end iftex +@ifnottex +@math{\sup} +@end ifnottex +@c don't try to use \sup with dvi/pdf output since that turned into a +@c Texinfo command and it's not worth hassling with different versions +@c when it's just three roman letters anyway. + + +@item \tan +@math{\tan} + +@item \tanh +@math{\tanh} + +@end ftable + + +@node Math accents +@section Accents mathématiques +@cindex Accents mathématiques +@cindex math, accents + +@LaTeX{} fournit diverse commandes pour produire des lettres accentuées en +math. Elles diffèrent de celles concernant les accents en texte normal +(@pxref{Accents}). + +@ftable @code +@item \acute +@cindex accent aigu en math +@cindex math, accent aigu +Accent aigu mathématique : @math{\acute{x}}. + +@item \bar +@cindex accent barre suscrite en math +@cindex accent macron en math +@cindex math, accent barre suscrite +@cindex math, accent macron +Accent barre suscrite mathématique : @math{\bar{x}}. + +@item \breve +@cindex accent brève en math +@cindex math, accent brève +Accent brève mathématique : @math{\breve{x}}. + +@item \check +@cindex accent caron en math +@cindex accent h@'a@v{c}ek en math +Accent h@'a@v{c}ek (caron) mathématique : @math{\check{x}}. + +@item \ddot +@cindex accent tréma en math +@cindex accent diérèse en math +Accent diérèse (tréma) mathématique : @math{\ddot{x}}. + +@item \dot +@cindex accent point suscrit en math +@cindex math, accent point suscrit +Accent point suscrit mathématique : @math{\dot{x}}. + +@item \grave +@cindex accent grave en math +@cindex math, accent grave +Accent grave mathématique : @math{\grave{x}}. + +@item \hat +@cindex accent chapeau en math +@cindex accent circonflexe en math +Accent chapeau (circonflexe) mathématique : @math{\hat{x}}. + +@item \imath +@cindex i sans point en math +I sans point mathématique. + +@item \jmath +@cindex j sans point en math +J sans point mathématique. + +@item \mathring +@cindex accent rond-en-chef en math +@cindex math, accent rond-en-chef +Accent rond-en-chef mathématique : @ringaccent{x}. @c don't bother implementing in texinfo + +@item \tilde +@cindex accent tilde en math +Accent tilde mathématique : @math{\tilde{x}}. + +@item \vec +@cindex symbole vecteur en math +Symbole vecteur mathématique : @math{\vec{x}}. + +@item \widehat +@cindex wide hat accent, math +Accent chapeau large mathématique : @math{\widehat{x+y}}. + +@item \widetilde +@cindex wide tilde accent, math +Accent tilde mathématique : @math{\widetilde{x+y}}. + +@end ftable + + +@node Spacing in math mode +@section Espacement en mode mathématique + +@cindex espacement au sein du mode mathématique +@cindex mode mathématique, espacement + +Au sein d'un environnement @code{math}, @LaTeX{} ignore les espaces que +vous tapez et met à la place l'espacement correspondant aux règles +normales pour les textes mathématiques. + +En mode mathématique, beaucoup de définitions sont exprimées dans +l'unité mathématique @dfn{mu} donnée par 1 em = 18 mu, où le em est pris +de la famille courante des symboles mathématiques (@pxref{Units of length}). + +@table @code +@item \; +@cindex thickspace +@findex \; +@findex \thickspace +Normalement @code{5.0mu plus 5.0mu}. Le nom long est +@code{\thickspace}. Utilisable seulement en mode mathématique. + +@item \: +@itemx \> +@findex \: +@findex \> +@findex \medspace +Normalement @code{4.0mu plus 2.0mu minus 4.0mu}. The longer name is +@code{\medspace}. Utilisable seulement en mode mathématique. + +@item \, +@cindex thinspace +@findex \, +@findex \thinspace +Normalement @code{3mu}. Le nom long est @code{\thinspace}. Utilisable à +la fois en mode mathématique et en mode texte. @xref{\thinspace}. + +@item \! +@findex \! +Une espace finie négative. Normalement @code{-3mu}. Utilisable +seulement en mode mathématique. + + +@item \quad +@cindex quad +@findex \quad +Vaut 18@dmn{mu}, c.-à-d.@: 1@dmn{em}. Souvent utilisé pour l'espace +entourant les équation ou expression, par ex.@: pour l'espace entre deux +équation au sein d'un environnement @code{displaymath}. Utilisable à la +fois en mode mathématique et en mode texte. + +@item \qquad +@findex \qquad +Une longueur de 2 quads, soit 36@dmn{mu} = 2@dmn{em}. Utilisable à la +fois en mode mathématique et en mode texte. +@end table + +Dans cet exemple une espace fine sépare la fonction de la forme +différentielle. + +@example +\int_0^1 f(x)\,dx +@end example + + +@node Math miscellany +@section Recueil de diverses commandes utiles en math +@cindex math, miscellanées +@cindex miscellanées en math + +@ftable @code + +@item \* +@cindex multiplication discrétionnaire +@cindex symbole de multiplication, saut de ligne discretionnaire +Un symbole de multipliciation @dfn{discrétionnaire}, sur lequel un saut +de ligne est autorisé. En l'absence de saut, la multiplication est +indiquée implicitement par un espace, alors qu'en cas de saut un symbole +@BES{×,\times} est imprimé immédiatement avant le saut. Ainsi + +@example +\documentclass@{article@} +\usepackage[utf8]@{inputenc@} +\usepackage@{french@} +\begin@{document@} +Mais \(A_3 = 0\), ainsi le produit de tous les termes de +\(A_1\) à \(A_4\), c.-à-d.\ \(A_1\* A_2\* A_3 \* A_4\), +est égal à zéro. +\end@{document@} +@end example + +produit une sortie de ce type@c +@ifnottex +@w{ }(on a omis une partie du texte pour faire apparaître la césure au +même endroit que dans une sortie @TeX{})@c +@end ifnottex + : + +@indentedblock +Mais @math{A_3 = 0}, ainsi +@iftex +le produit de tous les termes +@end iftex +@ifnottex +[@dots{}] +@end ifnottex +de @math{A_1} +à @math{A_4}, c.-à-d.@: @math{A_1 A_2 \times}@*@math{A_3 A_4}, est +égal à zéro. +@end indentedblock + +@item \cdots +Des points de suspension élevés au centre de la ligne. +@tex +Comme dans : `$\cdots$'. +@end tex + +@item \ddots +Des points de suspension en diagonale : @math{\ddots}. + +@item \frac@{@var{num}@}@{@var{dén}@} +@findex \frac +Produit la fraction @var{num} divisé par @var{dén}. +@ifset HAS-MATH +Par ex.@: @math{{1}\over{4}}. +@end ifset + +@item \left @var{delim1} ... \right @var{delim2} +@findex \right +@cindex délimiteur nul +Les deux délimiteurs ne se correspondent par nécessairement ; @samp{.} +tient lieu de @dfn{délimiteur nul}, ne produisant rien en sortie. Les +délimiteurs sont dimensionnés selon la portion de formule mathématique +qu'ils embrassent. Exemple : @code{\left( \sum_@{i=1@}^@{10@} a_i +\right]}. + +@item \mathdollar +Signe dollar en mode mathématique : $. + +@item \mathellipsis +Points de suspension (épacés pour du texte) en mode mathématique : @dots{}. + +@item \mathparagraph +Signe paragraphe (pied-de-mouche) en mode mathématique : @BES{¶,\P}. + +@item \mathsection +Signe section en mode mathématique. + +@item \mathsterling +Signe livre sterling mode mathématique : @pounds{}. + +@item \mathunderscore +Signe « souligné » en mode mathématique : _. + +@item \overbrace@{@var{math}@} +Génère une accolade au dessus de @var{math}. +Par exemple, @code{\overbrace@{x+\cdots+x@}^@{k \;\textrm@{fois@}@}}. +@ifset HAS-MATH +Le résultat ressemble à cela : @math{\overbrace{x+\cdots+x}^{k \rm\;fois}} +@end ifset + +@item \overline@{@var{texte}@} +Génère une ligne horizontale au dessus de @var{texte}. +Par exemple, @code{\overline@{x+y@}}. +@ifset HAS-MATH +Le résultat ressemble à cela : @math{\overline{x+y}}. +@end ifset + +@item \sqrt[@var{nième}]@{@var{arg}@} +Produit la représentation de la racine carrée de @var{arg}. L'argument +optionnel @var{nième} détermine quelle racine produire. Par exemple, la +racine cubique de @code{x+y} serait tapée comme +@code{$\sqrt[3]@{x+y@}$}. +@ifset HAS-MATH +Le résultat ressemble à cela : @math{\root 3 \of {x+y}}. +@end ifset + +@item \stackrel@{@var{texte}@}@{@var{relation}@} +Place @var{texte} au dessus de @var{relation}. Par exemple, +@code{\stackrel@{f@}@{\longrightarrow@}}. +@ifset HAS-MATH +Le resultat ressemble à cela : @math{\buildrel f \over \longrightarrow}. +@end ifset + +@item \underbrace@{@var{math}@} +Génère @var{math} avec une accolade en-dessous. Par exemple, @code{\underbrace@{x+y+z@}_@{>\,0@}}. +@ifset HAS-MATH +Le résultat ressemble à cela : @math{\underbrace{x+y+z}_{>\,0}}. +@end ifset + +@item \underline@{@var{texte}@} +A pour effet que @var{texte}, ce qui peut être ou non en mode +mathématique, soit souligné. La ligne est toujours sous le texte, en +prenant en compte les jambages. +@ifset HAS-MATH +Le résultat ressemble à cela : @math{\underline{xyz}} +@end ifset + +@item \vdots +Produit des points de suspension alignés verticalement. +@ifset HAS-MATH +Le résultat ressemble à cela : @math{\vdots}. +@end ifset + +@end ftable + + +@node Modes +@chapter Modes +@cindex modes +@cindex mode paragraphe +@cindex mode math +@cindex mode gauche-à-droite (left-to-right) +@cindex mode LR + + +Quand @LaTeX{} traite votre texte en entrée, il est forcément dans l'un +de ces trois modes : + +@itemize @bullet +@item +Mode paragraphe +@item +Mode math +@item +Mode gauche-à-doite, appelé également mode LR (left-to-right) pour +faire bref +@end itemize + +@LaTeX{} change le mode seulement lorsqu'il monte ou descend un escalier +le menant à un niveau différent, quoique tous les changement de niveau +ne produisent pas de changement de mode. Les changements de mode se +produisent seulement lorsqu'on entre dans ou quitte un environnement, ou +quand @LaTeX{} traite l'argument de cetraines commandes qui produisent +du texte. + +Le « mode paragraphe » est le plus usuel ; c'est celui dans lequel +@LaTeX{} se trouve lorsqu'il traite du texte ordinaire. Dans ce +mode-là, @LaTeX{} fragments votre texte en lignes et fragmentes les +lignes en pages. @LaTeX{} est en « mode math » quand il est en train de +générer une formule mathématique. En « mode LR », comme en mode +paragraphe, @LaTeX{} considère la sortie qu'il produit comme une chaîne +de mots avec des espaces entre eux. Toutefois, contrairement au mode +paragraphe, @LaTeX{} continue à progresser de la gauche vers la droite ; +il ne démarre jamais une nouvelle ligne en mode LR. Même si vous mettez +une centraine de mots dans une @code{\mbox}, @LaTeX{} continue à les +composer de gauche à droite au sein d'une seule boîte, et ensuite se +plaindra que la boîte résultante est trop large pour tenir dans la +ligne. + +@LaTeX{} est en mode LR quand il commence à fabriquer une boîte avec une +commande @code{\mbox}. Vous pouver le faire entrer dans un mode +different mode au sein de la boîte --- par exemple, vous pouvez le faire +entrer en mode math pour mettre un forume dans la boîte. Il y a aussi +plusieurs commandes qui produisent du texte et environnement pour +fabriquer une boîte qui mettre @LaTeX{} en mode paragraphe. La boîte +fabriquée par l'une de ces commandes ou environnements est appelée une +@code{parbox}. Quand @LaTeX{} est en mode paragraphe alors qu'il +fabrique une boîte, on dit qu'il est en « mode paragraphe interne ». +Son mode paragraphe normal, celui dans lequel il démarre, est appelé +« mode paragraphe externe ». + +@menu +* \ensuremath:: Assurer qu'on est en mode mathématique +@end menu + +@node \ensuremath +@section @code{\ensuremath} + +Synopsis : + +@example +\ensuremath@{@var{formule}@} +@end example + +La commande @code{\ensuremath} assure que @var{formule} est composée en +mode mathématique quel que soit le mode courant où la commande apparaît. + +Par exemple : + +@example +\documentclass@{report@} +\usepackage@{french@} +\newcommand@{\ab@}@{\ensuremath@{(\delta, \varepsilon)@}@} +\begin@{document@} +Le couple \ab\ vaut alors \(\ab = (\frac@{1@}@{\pi@}, 0)\), ... +\end@{document@} +@end example + +Il est possible de redéfinir des commandes qui ne peuvent être utilisées +qu'en mode mathématique pour qu'elles puissent être utilisées en tout +mode comme dans l'exemple ci-dessous avec @code{\leadsto} : + +@example +\documentclass@{report@} +\usepackage@{amssymb@} +\usepackage@{french@} +\newcommand@{\originalMeaningOfLeadsTo@}@{@} +\let\originalMeaningOfLeadsTo\leadsto +\renewcommand\leadsto@{\ensuremath@{\originalMeaningOfLeadsTo@}@} +\begin@{document@} +Tous les chemins \leadsto\ Rome. +\end@{document@} +@end example + + +@node Page styles +@chapter Styles de page +@cindex styles, page +@cindex page styles + +La commande @code{\documentclass} détermine la taille et la position de +l'en-tête et du bas de page. Le style de page détermine leur contenu. + +@menu +* \maketitle:: Génère une page de titre. +* \pagenumbering:: Règle le style utilisé pour les numéros de pages. +* \pagestyle:: Change le style des en-têtes et bas de pages. +* \thispagestyle:: Change le style de l'en-tête et bas de pages de la + page courante. +@end menu +@c +@c +@node \maketitle +@section @code{\maketitle} +@c @cindex titles, making +@c @findex \maketitle +@c +@c la commande @code{\maketitle} generates a title on a separate title +@c page---except in the @code{article} class, where the title is placed +@c at the top of the first page. Information used to produce the title +@c is obtained from the following déclarations: +@c +@c @ftable @code +@c @item \author@{@var{name} \and @var{name2}@} +@c @cindex author, for titlepage +@c @findex \\ @r{for @code{\author}} +@c @findex \and @r{for @code{\author}} +@c la commande @code{\author} declares the document author(s), where the +@c argument is a list of authors separated by commande @code{\and}s. Use +@c @code{\\} to separate lines within a single author's entry---for +@c exemple, to give the author's institution or address. +@c +@c @item \date@{@var{texte}@} +@c @cindex date, for titlepage +@c la commande @code{\date} declares @var{texte} to be the document's +@c date. Avec no commande @code{\date}, the current date (@pxref{\today}) +@c is used. +@c +@c @item \thanks@{@var{texte}@} +@c @cindex thanks, for titlepage +@c @cindex credit footnote +@c la commande @code{\thanks} produces a @code{\footnote} to the title, +@c usually used for credit acknowledgements. +@c +@c @item \title@{@var{texte}@} +@c @cindex title, pour la page de titre +@c @findex \\ @r{for @code{\title}} +@c la commande @code{\title} declares @var{texte} to be the title of the +@c document. Use @code{\\} to force a line break, as usual. +@c +@c @end ftable +@c +@c +@node \pagenumbering +@section @code{\pagenumbering} +@findex \pagenumbering +@cindex numérotation de page, style +@cindex style de numérotation de page + +Synopsis : + +@example +\pagenumbering@{@var{style}@} +@end example + +Spécifie le style des numéros de page numbers selon +@var{style}. @code{\pagenumbering} remet également le numéro de page à +@math{1}. L'argument @var{style} peut prendre les valeurs suivantes : + +@table @code +@item arabic +nombres arabes + +@item roman +Nombres romain en bas de casse + +@item Roman +Nombres romain en capitales + +@item alph +Lettres en bas de casse + +@item Alph +Lettre en capitales +@end table + + +@node \pagestyle +@section @code{\pagestyle} +@c @findex \pagestyle +@c @cindex header style +@c @cindex footer style +@c @cindex running header and footer style +@c +@c Synopsis : +@c +@c @example +@c \pagestyle@{@var{style}@} +@c @end example +@c +@c la commande @code{\pagestyle} spécifie how the headers and footers +@c are typeset from the current page onwards. Values for @var{style}: +@c +@c @table @code +@c @item plain +@c Just a plain page numéro. +@c +@c @item empty +@c Empty headers and footers, e.g., no page numbers. +@c +@c @item headings +@c Put running headers on each page. The document style spécifie what +@c goes in the headers. +@c +@c @item myheadings +@c Custom headers, spécifié via the @code{\markboth} or the +@c commande @code{\markright}s. +@c +@c @end table +@c +@c Here are the descriptions of @code{\markboth} and @code{\markright}: +@c +@c @ftable @code +@c @item \markboth@{@var{gauche}@}@{@var{droite}@} +@c Sets both the left and the right heading. A ``left-hand heading'' +@c (@var{gauche}) is généré by the last commande @code{\markboth} before +@c the end of the page, while a ``right-hand heading'' (@var{droite}) is +@c généré by the first @code{\markboth} or @code{\markright} that +@c comes on the page if there is one, otherwise by the last one before +@c the page. +@c +@c @item \markright@{@var{droite}@} +@c Sets the right heading, leaving the left heading unchanged. +@c +@c @end ftable +@c +@c +@node \thispagestyle +@section @code{\thispagestyle@{@var{style}@}} +@findex \thispagestyle + +La commande @code{\thispagestyle} fonctionne de la même manière que la +commande @code{\pagestyle} (voir section pécédente) à ceci près qu'elle +change en @var{style} pour la page courante seulement. + + +@node Spaces +@chapter Espaces +@cindex espaces + +@LaTeX{} a beaucoup de façons de produire de l'espace blanc (ou rempli). + +Une autre commande produisant de l'espace est @code{\,} pour produire une +espace « fine » (d'habitude 1/6@dmn{quad}). Elle peut être utilisée en +mode texte, mais est le plus souvent utile en mode math (@pxref{Spacing +in math mode,Espacement en mode mathématique}). + +@menu +Espace horizontal +* \hspace:: Espace horizontal fixe. +* \hfill:: Espace horizontal extensible. +* \@key{<espace>} et \@@: \(SPACE) and \@@. Espace après un point. +* \@key{<espace>} après séq.@: de control: \(SPACE) after control sequence. Espaces (avalement des) après une séquence de contrôle. +* \frenchspacing:: Rendre égaux les espacements inter-phrase et inter-mot. +* \thinspace:: Un sixième d'@dmn{em}. +* \/:: Correction italique par caractère. +* \hrulefill \dotfill:: Filet ou pointillés horizontaux extensibles. + +Espace vertical +* \addvspace:: Ajouter un espace vertical arbitraire si besoin est. +* \bigskip \medskip \smallskip:: Espaces verticaux fixes. +* \vfill:: Espace vertical extensible indéfiniment. +* \vspace:: Ajouter de l'espace vertical en quantité arbitraire. +@end menu +@c +@c +@node \hspace +@section @code{\hspace} +@findex \hspace + +Synopsis : + +@example +\hspace@{@var{longueur}@} +\hspace*@{@var{longueur}@} +@end example + +La commande @code{\hspace} ajoute de l'espace horizontal. L'argument +@var{longueur} peut être exprimé en toute unité que @LaTeX{} comprend : +points, pouces, etc.@: C'est une longueur elastique. Vous pouvez +ajouter aussi bien de l'espace négatif que de l'espace positif avec une +commande @code{\hspace} ; ajouter de l'espace negatif revient à +retourner en arrière. + +@LaTeX{} enlève normalement l'espace horizontal qui vient au début ou à +la fin d'une ligne. Pour préserver cet espace, utilisez la forme +étoilée, c.-à-d.@: avec le suffixe @code{*} optionnel. + + +@node \hfill +@section @code{\hfill} + +@findex \hfill +La commande @code{\hfill} de remplissage produit une ``longueur +élastique'' qui n'a aucun espace naturel mais peut s'allonger ou se +rétrécir horizontalement autant que nécessaire. + +@findex \fill +Le paramètre @code{\fill} est la longueur élastique elle-même (c.-à-d.@: +pour parler technique, la valeur de glue @samp{0pt plus1fill}) ; ainsi, +@code{\hspace\fill} équivaut à @code{\hfill}. + + +@node \(SPACE) and \@@ +@section @code{\@key{<espace>}} et \@@ +@findex \@key{espace} +@findex \@key{tabulation} +@findex \@key{sautdeligne} + +Ces commandes permettent de marquer un caractère de ponctuation, +typiquement un point, comme soit finissant une phrase, soit finissant +une abréviation. + +Par défaut, lorsque @LaTeX{} justifie une ligne il ajuste l'espace après +le point final de chaque phrase (ou le point d'interrogation, la +virgule, ou le deux-points) plus que pour l'espace inter-mot +(@pxref{\frenchspacing}). @LaTeX{} suppose que le point finit une phrase +à moins qu'il soit précédé d'une lettre capitale, dans quel cas il +considère que ce point fait partie d'une abréviation. Il est à noter que +si un point final de phrase est immédiatement suivit d'une parenthèse ou +crochet de droite, ou d'un guillemet-apostrophe simple ou double de droite, +alors l'espace inter-phrase suit cette parenthèse ou ce guillemet. + +Si vous avez un point finissant une abréviation dont la dernière lettre +n'est pas une capitale, et que cette abréviation n'est pas le dernier +mot d'une phrase, alors faites suivre ce point d'un +contr'oblique-espace (@code{\ }), où d'un tilde (@code{~}). Voici des +exemples : @code{Nat.\ Acad.\ Science}, et @code{Mr.~Bean}, et @code{(du +fumier, etc.)\ à vendre}. + +Pour une autre utilisation de @code{\ }, @pxref{\(SPACE) after control +sequence,@code{\ } après une séquence de contrôle}. + +Dans la situation opposée, si vous avez une lettre capitale suivi d'un point +qui finit la phrase, alors placez @code{\@@} avant ce point. Par ex., +@code{book by the MAA\@@.} aura l'espacement inter-phrase après ce point. + +Par contre, placer @code{\@@} après un point dit à @TeX{} que ce point ne finit +pas la phrase. Dans l'exemple @code{les mot réservés (if, then, etc.\@@) sont +différents}, @TeX{} met un espace inter-mot après la parenthèse fermante (notez +que @code{\@@} est avant la parenthèse). + +@node \(SPACE) after control sequence +@section @code{\ } après une séquence de contrôle + +La commande @code{\ } est aussi souvent utilisée après les +séquences de contrôle pour les empêcher d'avaler les espaces qui +suivent, comme dans @samp{\TeX\ c'est chouette.} Et, +dans des circonstances normales, @code{\}@key{tabulation} et +@code{\}@key{sautdeligne} sont équivalents à @code{\ }. Pour une autre utilisation de @code{\ }, voir aussi @ref{\(SPACE) and \@@}. + +Certaines personnes préfèrent utiliser @code{@{@}} dans le même but, comme dans +@code{\TeX@{@} c'est chouette}. Ceci a l'avantage que vous écrivez toujours la +même chose, en l'occurrence @code{\TeX@{@}}, qu'elle soit suivie d'un espace ou +d'un signe de ponctuation. Comparez : + +@example +\TeX\ est un chouette système. \TeX, un chouette système.@* +\TeX@{@} est un chouette système. \TeX@{@}, un chouette système. +@end example + + +@PkgIndex{xspace} +Certaines commandes, notamment celles définies avec le paquetage +@code{xspace}, ne suivent pas ce comportement standard. + + +@node \frenchspacing +@section @code{\frenchspacing}, rendre égaux les espacements inter-phrase et inter-mot + +@findex \frenchspacing +@findex \nonfrenchspacing +@cindex espacement inter-phrase + +Cette déclaration (provenant de @TeX{} de base) cause que @LaTeX{} +traite l'espacement inter-phrase de la même façon que l'espacement inter-mot. + +En justifiant le texte sur une ligne, certaine traditions typographique, +y comrpis l'anglaise, préfèrent ajuster l'espace entre les phrase (ou +après d'autres signes de ponctuation) plus que l'espace entre les +mots. À la suite de cette déclaration, tous les espaces sont traités de +la même façon. + +Revenez au comportement par défaut en déclarant +@code{\nonfrenchspacing}. + +@node \thinspace +@section @code{\thinspace} +@findex \thinspace + +@code{\thinspace} produit une espace insécable et non-elastique qui vaut + 1/6 d'@dmn{em}. C'est l'espace adéquate entre des guillemets anglais + simples emboîtés, comme dans '@dmn{}''.@c Abuse @dmn, which is a thin + @c space in Texinfo. + + +@node \/ +@section @code{\/} : insérer une correction italique +@findex \/ +@cindex Correction italique + +La commande @code{\/} produit une @dfn{correction italique}. C'est une +espace fine deéfni par le créateur de caractères typographiques pour un +caractère donné, pour éviter que le caractère entre en collision avec ce +qui suit. Le caractère italique @i{f} a typiquement une valeur +importante de correction italique. + +Si le caractère suivant est un point ou une virgule, il n'est pas +nécessaire d'insérer une correction italique, puisque ces symboles de +ponctuation ont une très faible hauteur. Toutefois, avec les +point-virgules ou les deux-points, de même qu'avec les lettres normales, +il peut être utilie. Comparez : +@tex +{\it f\/: f\/;} +@end tex +@ifnottex +@i{f: f;} (dans la sortie @TeX{}, les `f's sont séparés joliment) +@end ifnottex +avec @i{f: f;}. + +Lorsque on change de fontes avec des commandes telles que +@code{\textit@{italic text@}} ou @code{@{\itshape italic text@}}, +@LaTeX{} insère automatiquement une correction italique appropriée si +nécessaire (@pxref{Font styles}). + +Malgré leur nom, les caractères romains peuvent aussi avoir une +correction italique. Comparez : +@tex +pdf\/\TeX{} +@end tex +@ifnottex +pdf@TeX{} (dans la sortie @TeX{}, il y a une espace fine après le `f') +@end ifnottex +avec pdf@TeX{}. + +Le concept de correction italique n'existe pas en mode mathématique ; +l'espacement y est fait d'une façon différente. + + +@node \hrulefill \dotfill +@section @code{\hrulefill \dotfill} +@findex \hrulefill +@findex \dotfill + +Produit une longueur elastique infinie (@pxref{Lengths}) remplie avec un +filled filet horizontal (c.-à-d.@: une ligne) ou avec des pointillés, au +lieu de just de l'espace blanche. + +Quand on le place entre deux lignes à blanc cet exemple crée un +paragraphe qui est justifié à gauche et à droite, où l'espace au milieu +est rempli avec des pointillés uniformément espacés. + +@example +\noindent Jack Aubrey\dotfill Melbury Lodge +@end example + +Pour que le filet ou les pointillés aillent jusqu'au bout de la ligne +utilisez @code{\null} au début ou à la fin. + +Pour changer l'épaisseur du filet, copiez la définition et ajustez là, +comme avec @code{\renewcommand@{\hrulefill@}@{\leavevmode\leaders\hrule +height 1pt\hfill\kern\z@@@}}, ce qui cuange l'épaisseur par défaut de +0.4@dmn{pt} à 1@dmn{pt}. De même, ajustez l'espacement inter-pointillé +comme avec +@code{\renewcommand@{\dotfill@}@{\leavevmode\cleaders\hb@@xt@@ +1.00em@{\hss .\hss @}\hfill\kern\z@@@}}, ce qui change la longeur par +défaut de 0.33@dmn{em} à 1.00@dmn{em}. + +@c xx undone +@node \addvspace +@section @code{\addvspace} +@findex \addvspace +@cindex espace vertical +@cindex espace vertical, insérer + +@code{\addvspace@{@var{length}@}} + +Ajoute un espace vertical de longeur @var{length}, ce qui est une +longueur élatsique (@pxref{Lengths}). Toutefois, si l'espace vertical a +déjà été ajouté au même point de la sortie par une commande +@code{\addvspace} précédente, alors cette commande n'ajoutera pas plus +d'espace que nécessaire à fabriquer la longeur naturelle de l'espace +vertical total égale à @var{length}. + +Utilisez cette commande pour ajuster l'espace vertical au-dessus ou +au-dessous d'un environnement qui commence un nouveau paragraphe. (Par +exemple, un environnement Theorem est défini pour commencer et finir en +@code{\addvspace@{..@}} de sorte que deux Theorem consécutifs sont +séparés par un espace vertical, et non deux.) + +Cette commande est fragile (@pxref{\protect}). + +L'erreur @samp{Something's wrong--perhaps a missing \item} signifie que +vous n'é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'une commande @code{\par}. + + +@node \bigskip \medskip \smallskip +@section @code{\bigskip \medskip \smallskip} + +Ces commandes produisent une quantité donnée d'espace, spécifiée par la +classe de document. + +@ftable @code +@item \bigskip +@findex \bigskipamount +La même chose que @code{\vspace@{\bigskipamount@}}, ordinairement environ +l'espace d'une ligne, avec dilatation et rétrécissement (la valeur par +défaut pour les classes @code{book} et @code{article} et @code{12pt +plus 4pt minus 4pt}). + +@item \medskip +@findex \medskipamount +La même chose que @code{\vspace@{\medskipamount@}}, ordinairement +environ la moitié de l'espace d'une ligne, avec dilatation et +rétrécissement (la valeur par défaut pour les classes @code{book} et +@code{article} et @code{6pt plus 2pt minus 2pt}). + +@item \smallskip +@findex \smallskipamount +La même chose que @code{\vspace@{\smallskipamount@}}, ordinairement +environ le quart de l'espace d'une ligne, avec dilatation et +rétrécissement (la valeur par défaut pour les classes @code{book} et +@code{article} et @code{3pt plus 1pt minus 1pt}). + +@end ftable + +@node \vfill +@section @code{\vfill} +@findex \vfill + +@cindex dilatation verticale infinie +@cindex verticale infinie, dilatation + +Finit le paragraphe courante et insère une longueur elastique verticale +(@pxref{Lengths}) qui est infinie, de sorte qu'elle puisse se dilater ou +that is se rétrécire autant que nécessaire. + +On l'utilise souvent de la même façon que @code{\vspace@{\fill@}}, à +ceci près que @code{\vfill} finit le paragraphe courant, tandis que +@code{\vspace@{\fill@}} ajoute une espace verticale infinin sous sa +ligne sans tenir compte de la structure du paragraphe. Dans les deux +cas cette espace disparaît à la fin de la page ; pour éviter cela +voir @ref{\vspace}. + +Dans l'exemple qui suit la page est remplie, de sorte que les lignes en +haut et en bas contiennent le texte @samp{Chien perdu !} et que le +troisième @samp{Chien perdu !} est exactement à mi-chemin entre eux. + +@example +\begin@{document@} +Chien perdu ! +\vfill +Chien perdu ! +\vfill +Chien perdu ! +\end@{document@} +@end example + + +@node \vspace +@section @code{\vspace} +@findex \vspace +@cindex espace verticale +@cindex verticale, espace + +Synopsis, l'une des deux formes suivantes : + +@example +\vspace@{@var{longueur}@} +\vspace*@{@var{longueur}@} +@end example + +Ajout l'espace verticale @var{longueur}. Celle-ci peut-être négative ou positive, +et c'est une longueur élastique (@pxref{Lengths}). + +@LaTeX{} enlève l'espace verticale provenant de @code{\vspace} aux sauts +de page, c.-à-d.@: au sommet et au bas des pages. La version étoilée +@code{\vspace*@{...@}} permet de conserver cette espace. + +Si @code{\vspace} est utilisée au milieu d'un paragraphe (c.-à-d.@: en +mode horizontal), l'esace est insérée @emph{après} la ligne comprenant +la commande @code{\vspace} sans commencer un nouveau paragraphe. + +Dans cet exemple les deux questions sont espacées uniformément +verticalement sur la page, avec au moins 2,5@dmn{cm} d'espace sous +chacune d'elle. + +@example +\begin@{document@} +1) Z'avez pas vu Mirza ? Oh la la la la la la +\vspace@{2.5cm plus 1fill@} + +2) Où est donc passé ce chien ? Je le cherche partout +\vspace@{2.5cm plus 1fill@} +\end@{document@} +@end example + + +@node Boxes +@chapter Boîtes +@cindex boîtes + +Tous les paramètres de longueurs prédéfinies (@pxref{Predefined lengths}) +peuvent être utilisés au sein des arguments des commandes de fabrication +de boîtes. + +@menu +* \mbox:: Boîtes horizontales. +* \fbox and \framebox:: Mettre un cadre autour d'une boîte. +* lrbox:: Un environnement similaire à @code{\sbox}. +* \makebox:: Boîte, adjustable position. +* \parbox:: Boîte avec du texte en mode paragraphe. +* \raisebox:: Élève ou abaisse le texte. +* \savebox:: Comme @code{\makebox}, mais sauvegarde le texte pour usage ultérieur. +* \sbox:: Comme @code{\mbox}, mais sauvegarde le texte pour usage ultérieur. +* \usebox:: Compose le texte sauvegardé. +@end menu + + +@node \mbox +@section @code{\mbox@{@var{texte@}}} +@findex \mbox + +@cindex césure, empécher +@cindex coupure de mot, empécher +La commande @code{\mbox} crée un boîte qui a la largeur juste du texte +créé par son argument. Le @var{texte} n'est pas coupé en plusieurs +lignes, c'est pourquoi cette commande peut être utilisée pour empécher +la césure. + + +@node \fbox and \framebox +@section @code{\fbox} and @code{\framebox} + +@findex \fbox +@findex \framebox + +Synopsis : + +@example +\fbox@{@var{texte}@} +\framebox[@var{largeur}][@var{position}]@{@var{texte}@} +@end example + +Les commandes @code{\fbox} et @code{\framebox} sont similaires à +@code{\mbox}, à ceci près qu'elle mettent un cadre autour de l'extérieur +de la boîte ainsi créée. + +De plus, la commande @code{\framebox} permet de spécifier explicitement +la largeur de la boîte avec l'argument optionnel @var{largeur} +(une longueur), et sa position sur la ligne avec l'argument optionnel @var{position}. @c xxref + +@findex \fboxrule +@findex \fboxsep +Les deux commandes produisent un filet d'épaisseur @code{\fboxrule} +(valant par défaut @samp{.4pt}), et laisse un espace de @code{\fboxsep} +(valant par défaut @samp{3pt}) entre le filet et le contenu de la boîte. + +@xref{\framebox (picture)}, pour la commande @code{\framebox} dans +l'environnement @code{picture}. + + +@node lrbox +@section @code{lrbox} +@findex lrbox + +Synopsis : + +@example +\begin@{lrbox@}@{\@var{cmd}@} + @var{texte } +\end@{lrbox@} +@end example + +Ceci est la forme environnement de la commande @ref{\sbox,@code{\sbox}}. + +Le @var{texte} au sein de l'environnement est sauvegarder dans une boîte +@code{\@var{cmd}} qui doit avoir préalablement été déclarée avec +@code{\newsavebox}. + + +@node \makebox +@section @code{\makebox} +@findex \makebox + +Synopsis : + +@example +\makebox[@var{largeur}][@var{position}]@{@var{texte}@} +@end example + +La commande @code{\makebox} crée une boîte juste assez large pour +contenir le @var{texte} spécifié. La largeur de la boîte peut-être +emportée par l'argument optionnel @var{largeur}. La position du +texte au sein de la boîte est determinée par l'argument optionnel +@var{position} qui peut prendre l'une des valeurs suivantes : + +@table @code +@item c +Centré (par défaut). +@item l +(Left) justifié à gauche. +@item r +(Right) justifié à droite. +@item s +(Stretch) justifié à travers la @var{largeur} entière ; @var{texte} doit +contenir de l'espace dilatable pour que cela marche. +@end table + +@code{\makebox} est aussi utilisé au sein de l'environnement @code{picture}, +@pxref{\makebox (picture)}. + + +@node \parbox +@section @code{\parbox} +@findex \parbox + +Synopsis : + +@example +\parbox[@var{position}][@var{hauteur}][@var{pos-interne}]@{@var{largeur}@}@{@var{texte}@} +@end example + +@cindex mode paragraphe +@cindex paragraphe, mode +La commande @code{\parbox} produit une boîte dont le contenu est créé en +@dfn{mode paragraphe}. On devrait l'utiliser pour fabriquer une boîte à +partir de petits moreaux de texte, avec rien de trop élaboré à +l'intérieur. En particulier, vous ne devriez utiliser aucun +environnement de fabrication de paragraphe au sein de l'argument +@var{texte} d'une @code{\parbox}. Pour des morceaux de texte de plus +grande taille, y compris ceux comprenant un environnement de +fabrication de paragraphe, vous devriez utiliser un environnement +@code{minipage} (@pxref{minipage}). + +@code{\parbox} a deux arguments obligatoires : + +@table @var +@item largeur +la largeur de la parbox; +@item texte +le texte qui à mettre dans la parbox. +@end table + +Par défault @LaTeX{} positionne verticallement un parbox de sorte que +son centre soit aligné avec le centre de la ligne de texte +alentour. Lorsque l'argument optionnel @var{position} est présent et +vaut soit @samp{t} soit @samp{b}, cela vous permet respectivement +d'aligner soit la ligne du haut, soit la ligne du bas de la parbox avec +la ligne de base du texte alentour. Il est possible de spécifier +@var{position} à @samp{m} pour avoir le comportement par défaut. + +L'argument optionnel @var{hauteur} l'emporte sur la hauteur naturelle de la +boîte. + +L'argument @var{pos-interne} contrôle la position du texte au sein de la +boîte, comme suit ; s'il n'est pas spécifié, @var{position} est utilisé. + +@table @code +@item t +le texte est placé en haut de la boîte. +@item c +le texte est centré dans la boîte. +@item b +le texte est placé en bas de la boîte. +@item s +dilatation (stretch) verticale ; le texte doit contenir de l'espaces +dilatable verticalement pour que cela fonctionne. +@end table + + +@node \raisebox +@section @code{\raisebox} +@findex \raisebox + +Synopsis : + +@example +\raisebox@{@var{distance}@}[@var{hauteur}][@var{profondeur}]@{@var{texte}@} +@end example + +La commande @code{\raisebox} élève ou abaisse du @var{texte}. Le +premier argument obligatoire spécifie la longueur dont le @var{texte} +doit être élevé (ou abaissé si c'est une longueur négative). Le +@var{texte} lui-même est traité en mode LR. + +Les arguments optionnels @var{hauteur} et @var{profondeur} sont des +longueurs. S'ils sont spécifiés, @LaTeX{} traite @var{texte} comme s'il +s'étendait une certaine distance (@var{hauteur}) au-dessus de la ligne +de base, ou au dessous (@var{profondeur}), en ignorant ses hauteur et +profondeur naturelles. + + +@node \savebox +@section @code{\savebox} +@findex \savebox + +Synopsis : + +@example +\savebox@{@var{\boxcmd}@}[@var{largeur}][@var{pos}]@{@var{texte}@} +@end example + +Cette commande compose @var{texte} dans une boîte de la même façon +qu'avec @code{\makebox} (@pxref{\makebox}), à ceci près qu'au lieu +d'imprimer la boîte résultante, elle la sauvegarde dans une boîte +étiquettée @var{\boxcmd}, ce qui doit avoir été déclaré avec +@code{\newsavebox} (@pxref{\newsavebox}). + + +@node \sbox +@section @code{\sbox@{@var{\boxcmd}@}@{@var{texte}@}} +@findex \sbox + +Synopsis : + +@example +\sbox@{@var{\boxcmd}@}@{@var{texte}@} +@end example + +@code{\sbox} tape @var{texte} au sein d'une boîte tout comme @code{\mbox} +(@pxref{\mbox}) à ceci près qu'au lieu que la boîte résultante soit +incluse dans la sortie normale, elle est sauvegardée dans la boîte +étiquetée @var{\boxcmd}. @var{\boxcmd} doit avoir été préalablement +déclarée avec @code{\newsavebox} (@pxref{\newsavebox}). + + +@node \usebox +@section @code{\usebox@{@var{\boxcmd}@}} +@findex \usebox + +Synopsis : + +@example +\usebox@{@var{\boxcmd}@} +@end example + +@code{\usebox} produit la boîte la plus récemment sauvegardée dans le +bac @var{\boxcmd} par une commande @code{\savebox} (@pxref{\savebox}). + + +@node Special insertions +@chapter Insertions spéciales + +@LaTeX{} fournit des commandes pour insérer les caractères qui ont une +signification spéciale mais ne correspondent à aucun caractère simple +que vous pouvez taper. + +@menu +* Caractères réservés: Reserved characters. Insérer @samp{# $ % & @{ @} _ ~ ^ \} +* Symboles d'une police: Symbols by font position. Insérer des symboles d'une police par leur numéro. +* Symboles dans du texte: Text symbols. Insérer d'autres symboles non-lettre dans le texte. +* Accents:: Insérer des accents. +* Caractères non-anglais: Non-English characters. Insérer d'autres caractères non-Américain. +* \rule:: Insérer des lignes et des rectangles. +* \today:: Insérer la date du jour. +@end menu + + +@node Reserved characters +@section Caractères réservés +@cindex caractères réservés +@cindex réservés, caractères +@cindex caractères spéciaux +@cindex spéciaux, caractères + +@LaTeX{} réserve les caractères suivant à un usage spécial (par exemple, +le signe pourcent @code{%} sert aux commentaires) c'est pourquoi on les +appelle @dfn{caractères réservés} ou @dfn{caractères spéciaux}. + +@example +# $ % & @{ @} _ ~ ^ \ +@end example + +@findex \# +@findex \$ +@findex \% +@findex \& +@findex \_ +@findex \@{ +@findex \@} +Si vous voulez qu'un caractère réservés soit imprimé comme lui-même, +dans la même police que le corps du texte, alors pour tous les +caractères hormis les trois derniers de cette liste il suffit de les +faire précéder d'une contr'oblique @code{\}. Ainsi @code{\$1.23} +produit @code{$1.23} en sortie. + +@findex \~ +@findex \^ +@findex \textbackslash +Quant aux trois derniers caractères, pour faire un tilde dans la police +du corps du texte utilisez @code{\~@{@}} (sans les accolades cela +mettrait un accent tilde sur le caractère suivant). De même pour faire +un accent circonflexe dans la police du corps du texte utilisez +@code{\^@{@}}. Une contr'oblique dans la police du corps de texte se +fait avec @code{\textbackslash@{@}}. + +Pour produire les caractères réservé dans la police d'une machine à écrire utilisez +@code{\verb!!} comme ci-dessous : + +@example +\begin@{center@} + \# \$ \% \& \@{ \@} \_ \~@{@} \^@{@} \textbackslash \\ + \verb!# $ % & @{ @} _ ~ ^ \! +\end@{center@} +@end example + +Dans cet exemple la double contr'oblique @code{\\} n'est là que pour +sauter à la ligne. + + +@node Symbols by font position +@section Symboles appelés par leur position dans une police + +@findex \symbol +@cindex accéder à un caractère quelconque d'une police +@cindex symboles d'une police, par leur numéro +@cindex police, symboles par leur numéro + +Vous pouvez accéder à n'importe quel caractère de la police courante en +utilisant son numéro avec la commande @code{\symbol}. Par exemple, le +caractère espace visible utilisé dans la commande @code{\verb*} a le +code décimal 32, ainsi on peut le taper avec @code{\symbol@{32@}}. + +Vous pouvez également spécifier le numéro en octal (base 8) en utilisant +un préfixe @code{'}, ou en hexadécimal (base 16) avec un préfixe +@code{"}, ainsi l'exemple précédent pourrait tout aussi bien être écrit +comme @code{\symbol@{'40@}} ou @code{\symbol@{"20@}}. + + +@node Text symbols +@section Symboles en texte + +@cindex symboles texte +@findex textcomp, @r{paquetage} +@LaTeX{} fournit des commandes pour générer divers symboles qui ne sont +pas des lettres dans le cours sein du texte. Certaines d'entre elles, +en particulier les plus obscures, ne sont pas disponible en OT1 ; il se +peut que vous deviez charger le paquetage @code{textcomp}. + +@ftable @code + +@item \copyright +@itemx \textcopyright +@cindex droit d'auteur, symbole +@cindex symbole droit d'auteur +Le symbole « droit d'auteur », @copyright{}. + +@item \dag +@cindex obèle, dans le texte +Le symbole obèle (dans le texte). + +@item \ddag +@cindex double obèle, dans le texte +Le symbole double obèle (dans le texte). + +@item \LaTeX +@cindex @LaTeX{}, logo +@cindex logo @LaTeX{} +Le logo @LaTeX{}. + +@item \LaTeXe +@cindex @LaTeX{}2e logo +@cindex logo @LaTeX{}2e +Le logo @LaTeX{}2e. + +@item \guillemotleft @r{(@guillemotleft{})} +@itemx \guillemotright @r{(@guillemotright{})} +@itemx \guilsinglleft @r{(@guilsinglleft{})} +@itemx \guilsinglright @r{(@guilsinglright{})} +@cindex guillemets double +@cindex guillemets simple +@cindex chevron gauche, guillemets +@cindex chevron droit, guillemets +@cindex chevron double, guillemets +@cindex chevron simple, guillemets +@cindex guillemets français +@cindex français, guillemets +Guillemets à chevron double et simple, utilisés communément en français : +@guillemotleft{}, @guillemotright{}, @guilsinglleft{}, @guilsinglright{}. + +@item \ldots +@itemx \dots +@itemx \textellipsis +@cindex points de suspension +@cindex suspension, points de +Des points de suspension (trois points sur la ligne de base) : +`@dots{}'. @code{\ldots} et @code{\dots} peuvent également être +utilisés en mode mathématique. + +@item \lq +@cindex gauche, guillemet-apostrophe simple de +@cindex ouvrant, , guillemet-apostrophe simple +guillemet-apostrophe simple de gauche (ouvrant) : `. + +@item \P +@itemx \textparagraph +@cindex paragraphe, symbole +@cindex Pied-de-mouche +Signe paragraphe : @BES{¶,\P} (pied-de-mouche). + +@item \pounds +@itemx \textsterling +@cindex livre, symbole +@cindex sterling, symbole +Livre sterling anglais : @pounds{}. + +@item \quotedblbase @r{(@quotedblbase{})} +@itemx \quotesinglbase @r{(@quotesinglbase{})} +@cindex guillemet-virgule inférieur double +@cindex guillemet-virgule inférieur simple +@cindex inférieur, guillemet-virgule simple +@cindex inférieur, guillemet-virgule double +@cindex guillemets-virgule inférieurs, simple et double +Guillemets-virgule inférieur double et simple : @quotedblbase{} et +@quotesinglbase{}. + +@item \rq +@cindex droite, guillemet-apostrophe simple +@cindex fermant, guillemet-apostrophe simple +@cindex droite, guillemet anglais simple +@cindex fermant, guillemet anglais simple +Guillemet-apostrophe simple de gauche (fermant) : '. + +@item \S +\itemx \textsection +@cindex section, symbole +Signe section : @BES{§,\S}. + +@item \TeX +@cindex logo @TeX{} +@cindex @TeX{}, logo +Le logo @TeX{}. + +@item \textasciicircum +@cindex circonflexe ASCII, dans le texte +@cindex ASCII, circonflexe dans le texte +circonflexe ASCII : ^. + +@item \textasciitilde +@cindex tilde ASCII, dans le texte +@cindex ASCII, tilde dans le texte +tilde ASCII : ~. + +@item \textasteriskcentered +@cindex astérisque centré, dans le texte +@cindex centré, astérisque, dans le texte +Astérisque centré : *. + +@item \textbackslash +@cindex contr'oblique, dans le texte +Contr'oblique : \. + +@item \textbar +@cindex verticale, barre dans le texte +@cindex barre verticale, dans le texte +Barre verticale : |. + +@item \textbardbl +@cindex barre verticale double, dans le texte +@cindex barre, double verticale, dans le texte +@cindex double, barre verticale, dans le texte +Barre verticale double. + +@item \textbigcircle +@cindex Grand rond, symbole, dans le texte +@cindex rond, grand symbole, dans le texte +Symbole grand rond. + +@item \textbraceleft +@cindex accolade gauche, dans le texte +@cindex gauche, accolade, dans le texte +Accolade gauche : @{. + +@item \textbraceright +@cindex accolade droite, dans le texte +@cindex droite, accolade, dans le texte +Accolade droite : @}. + +@item \textbullet +@cindex puce, dans le texte +Puce : @bullet{}. + +@item \textcircled@{@var{lettre}@} +@cindex encerclée, lettre, dans le texte +@var{lettre} dans un cercle, comme dans @registeredsymbol{}. + +@item \textcompwordmark +@itemx \textcapitalcompwordmark +@itemx \textascendercompwordmark +@c @cindex composite word mark, dans le texte +@c @cindex cap height +@c @cindex ascender height +Marque de mot composé (invisible). La forme @code{\textcapital...} à la +hauteur de capitale de la fonte, alors que la forme +@code{\textascender...} a la hauteur de hampe. + +@item \textdagger +@cindex obèle, dans le texte +Obèle : @math{\dag}. + +@item \textdaggerdbl +@cindex obèle double, dans le texte +@cindex double, obèle, dans le texte +Double-obèle : @math{\ddag}. + +@item \textdollar @r{(ou @code{\$})} +@cindex dollar, signe +@cindex monnaie, dollar +Signe Dollar : $. + +@item \textemdash @r{(ou @code{---})} +@cindex cadratin +Cadratin : --- (pour la ponctuation). + +@item \textendash @r{(ou @code{--})} +@cindex cadratin, demi +@cindex demi-cadratin +Demi cadratin : -- (pour les plages en anglais). + +@item \texteuro +@cindex euro, symbole +@cindex monnaie, euro +Le symbole Euro : @euro{}. + +@item \textexclamdown @r{(ou @code{!`})} +@cindex point d'exclamation culbuté +Point d'exclamation culbuté : @exclamdown{}. + +@item \textgreater +@cindex supérieur à, symbole dans le texte +Supérieur à : >. + +@item \textless +@cindex inférieur à, symbole dans le texte +Inférieur à : <. + +@item \textleftarrow +@cindex flèche gauche, left, dans le texte +@cindex gauche, flèche, dans le texte +Flèche gauche. + +@item \textordfeminine +@itemx \textordmasculine +@cindex féminin, symbole ordinal +@cindex masculin, symbole ordinal +@cindex Ordinaux, féminin et masculin +@cindex Ordinaux espagnols, féminin et masculin +Symboles ordinaux féminin et masculin : @ordf{}, @ordm{}. + +@item \textperiodcentered +@cindex point centré, dans le texte +@cindex centré, point, dans le texte +Point centré : @BES{·,\cdot}. + +@item \textquestiondown @r{(ou @code{?`})} +@cindex point d'interrogation culbuté +Point d'interrogation culbuté : @questiondown{}. + +@item \textquotedblleft @r{(ou @code{``})} +@cindex guillemet-apostrophe double culbuté +@cindex double, guillemet-apostrophe culbuté +Guillemet-apostrophe double culbuté : ``. + +@item \textquotedblright @r{(ou @code{''})} +@cindex guillemet-apostrophe de droite double +@cindex double, guillemet-apostrophe de droite +Guillemet-apostrophe de droite double : ''. + +@item \textquoteleft @r{(ou @code{`})} +@cindex guillemet-apostrophe simple culbuté +@cindex simple, guillemet-apostrophe culbuté +Guillemet-apostrophe simple culbuté : `. + +@item \textquoteright @r{(ou @code{'})} +@cindex guillemet-apostrophe simple +@cindex simple, guillemet-apostrophe +Guillemet-apostrophe simple : '. + +@item \textquotesingle +@cindex guillemet-apostrophe simple droit +@cindex simple droit, guillemet-apostrophe +@cindex droit, guillemet-apostrophe simple +Guillemet-apostrophe simple droit. (Du codage TS1.) + +@item \textquotestraightbase +@itemx \textquotestraightdblbase +@cindex guillemet droit simple sur la ligne de base +@cindex droit, guillemet simple sur la ligne de base +@cindex guillemet droit double sur la ligne de base +@cindex droit, guillemet double sur la ligne de base +Guillemets droit simple et double sur la ligne de base. + +@item \textregistered +@cindex marque déposée, symbole +@cindex symbole marque déposée +Symbole « marque déposée » : @registeredsymbol{}. + +@item \textrightarrow +@cindex flèche droite, dans le texte +@cindex droite, flèche, dans le texte +Flèche droite. + +@item \textthreequartersemdash +@cindex trois-quarts, cadratin +@cindex cadratin, trois-quarts +Cadratin « trois quarts ». + +@item \texttrademark +@cindex marque de fabrique, symbole +@cindex symbole marque de fabrique +Symbole marque de commerce : @BES{™,^{\hbox{TM}}}. + +@item \texttwelveudash +@cindex deux-tiers cadratin +@cindex cadratin, deux tiers +Deux-tiers cadratin. + +@item \textunderscore +@cindex souligné, dans le texte +@cindex tiret bas, dans le texte +Tiret bas : _. + +@item \textvisiblespace +@cindex visible, symbole espace, dans le texte +@cindex espace visible, symbole, dans le texte +Symbol espace visible. + +@end ftable + + +@node Accents +@section Accents + +@cindex accents +@cindex signes diacrtitiques +@cindex diacrtitiques, signes +@cindex accentuées, lettres +@cindex accentués, caractères + +@LaTeX{} a une prise en charge très large de beaucoup des scripts et +langages du monde, à travers ce qu'offre le paquetage @code{babel}. +Cette section ne tente pas de couvrir la totalité de cette prise en +charge. Elle liste simplement les commandes @LaTeX{} c@oe{}ur pour +créer des caractères accentués, et plus généralement des caractères +portant un signe diacritique. + +Les commandes @code{\capital...} produisent des formes alternatives +pouvant être utilisées avec les lettres capitales. Elles ne sont pas +disponible avec l'OT1. + +@table @code +@item \" +@itemx \capitaldieresis +@findex \" @r{(accent tréma)} +@findex \capitaldieresis +@cindex accent tréma +@cindex diacrtique tréma + +Produit une tréma, comme dans @"{o}. + +@item \' +@itemx \capitalacute +@findex \' @r{(acute accent)} +@findex \capitalacute +@cindex accent aigu +@cindex diacrtique accent aigu +Produit un accent aigu, comme dans @'{o}. Dans l'environnement +@code{tabbing}, pousse la colonne courante à droite de la colonne +précédente (@pxref{tabbing}). + +@item \. +@findex \. @r{(dot-over accent)} +@cindex accent point +@cindex accent point suscrit +@cindex accent point en chef +@cindex diacritique point suscrit +@cindex point en chef, diacritique +@cindex point suscrit, diacritique +Produit un point suscrit à la lettre qui suit, comme dans +@dotaccent{o}. + +@item \= +@itemx \capitalmacron +@findex \= @r{(macron accent)} +@findex \capitalmacron +@cindex macron, diacritique +@cindex barre, diacritique +@cindex barre par-dessus, accent +Produit un macron (une barre) suscrit à la lettre qui suit, comme +dans @={o}. + +@item \^ +@itemx \capitalcircumflex +@findex \^ @r{(accent circonflexe)} +@findex \capitalcircumflex +@cindex accent circonflexe +@cindex diacritique circonflexe +@cindex circonflexe, accent +@cindex circonflexe, diacritique +@cindex chapeau, accent +Produit un accent circonflexe (un chapeau) suscrit à la lettre qui suit, comme dans @^{o}. + +@item \` +@itemx \capitalgrave +@findex \` @r{(accent grave)} +@findex \capitalgrave +@cindex grave accent +Produit un accent grave suscrit à la lettre qui suit, comme dans +@`{o}. Au sein de l'environnement @code{tabbing}, déplace le texte qui +suit à la marge de droite (@pxref{tabbing}). + +@item \~ +@itemx \capitaltilde +@findex \~ @r{(accent tilde)} +@findex \capitaltilde +@cindex diacritique tilde +@cindex tilde, diacritique +Produit un diacritique tilde suscrit à la lettre qui suit, comme dans +@~{n}. + +@item \b +@findex \b @r{(accent barre-souscrite)} +@cindex diacritique barre-souscrite +@cindex diacritique macron-souscrit +@cindex barre-souscrite, diacritique +@cindex macron-souscrit, diacritique +Produit un diacritique barre souscrite à la lettre qui suit, comme dans +@ubaraccent{o}. Voir aussi @code{\underbar} ci-après. + +@item \c +@itemx \capitalcedilla +@findex \c @r{(cédille)} +@findex \capitalcedilla +@cindex cédille, diacritique +@cindex diacritique cédille +Produit une cedille souscrite à la lettre qui suit, comme dans @,{c}. + +@item \d +@itemx \capitaldotaccent +@findex \d @r{(dot-under accent)} +@findex \capitaldotaccent +@cindex diacritique point-souscrit +Produit un point souscrit à la lettre qui suit, comme dans +@udotaccent{o}. + +@item \H +@itemx \capitalhungarumlaut +@findex \H @r{(tréma hongrois)} +@findex \capitalhungarumlaut +@cindex accent tréma hongrois +@cindex tréma hongrois, accent +@cindex diacritique tréma hongrois +@cindex tréma hongrois, diacritique +Produit un long tréma hongrois suscrit à la lettre qui suit, comme dans @H{o}. + +@item \i +@findex \i @r{(i sans point)} +@cindex i sans point +Produit un i sans point, comme dans `@dotless{i}'. + +@item \j +@findex \j @r{(j sans point)} +@cindex j sans point +Produit un j sans point, comme dans `@dotless{j}'. + +@item \k +@itemx \capitalogonek +@findex \k @r{(ogonek)} +@findex \capitalogonek +@cindex ogonek, diacritique +@cindex diacritique ogonek +Produit un ogonek, comme dans `@ogonek{o}'. Non disponible dans le +codage OT1. + +@item \r +@itemx \capitalring +@findex \r @r{(ring accent)} +@findex \capitalring +@cindex accent rond en chef +@cindex diacritique rond en chef +@cindex rond en chef, diacritique +Produit un rond en chef, comme dans `@ringaccent{o}'. + +@item \t +@itemx \capitaltie +@itemx \newtie +@itemx \capitalnewtie +@findex \t @r{(tie-after accent)} +@findex \capitaltie +@findex \newtie +@findex \capitalnewtie +@cindex diacritique tirant susscrit +@cindex diacritique double-brève-renversée +@cindex accent double-brève-renversée +@cindex double-brève-renversée, diacritique +@cindex tirant suscrit, diacritique +Produit un tirant suscrit (double brève renversée), comme dans +`@tieaccent{oo}'. La forme @code{\newtie} est centrée dans sa boîte. + +@item \u +@itemx \capitalbreve +@findex \u @r{(breve accent)} +@findex \capitalbreve +@cindex brève, accent +@cindex brève, diacritique +@cindex diacritique brève +Produit un accent brève, comme dans `@u{o}'. + +@item \underbar +@findex \underbar +@cindex barre sousscite +@cindex barre au-dessous +Ce n'est pas vraiement un diacritique. Produit une barre au-dessous de +l'argument texte. L'argument est toujours traité en mode horizontal. +La barre est toujours à une position fixée sous la ligne de base, de la +sorte elle traverse les descentes. Voir aussi @code{\underline} dans +@ref{Math miscellany}. Voir aussi @code{\b} ci-avant. + +@item \v +@itemx \capitalcaron +@findex \v @r{(breve accent)} +@findex \capitalcaron +@cindex accent h@'{a}@v{c}ek +@cindex diacritique h@'{a}@v{c}ek +@cindex accent caron +@cindex diacritique caron +@cindex caron, diacritique +Produit un accent h@'a@v{c}ek (caron), comme dans `@v{o}'. + +@end table + + +@node Non-English characters +@section Lettres latines supplémentaires + +@cindex caractères speciaux +@cindex speciaux, caractères +@cindex caractères latins non diacrités +@cindex lettres latines non diacritées + +Voici les commandes de base de @LaTeX{} pour insérer des caractères +utilisés généralement utilisés dans des langages autres que l'anglais. + +@table @code + +@item \aa +@itemx \AA +@findex \aa (@aa{}) +@findex \AA (@AA{}) +@cindex a rond-en-chef +@aa{} et @AA{}. + +@item \ae +@itemx \AE +@findex \ae (@ae{}) +@findex \AE (@AE{}) +@cindex a, e dans l'a +@cindex e dans l'a +@cindex a e liés +@ae{} et @AE{}. + +@item \dh +@itemx \DH +@findex \dh (@dh{}) +@findex \DH (@DH{}) +@cindex eth islandais +@cindex eth, lettre islandaise +Lettre islandaise eth : @dh{} et @DH{}. Non disponible dans le codage +@sc{OT1}, il vous faut le paquetage @file{fontenc} pour sélectionner un +autre codage de police, tel que @sc{T1}. + +@item \dj +@itemx \DJ +@findex \dj +@findex \DJ +d et D barre, lettre d capitale et bas-de-casse avec une barre +traversant la hampe. Non disponible dans le codage @sc{OT1}, il vous +faut le paquetage @file{fontenc} pour sélectionner un autre codage de +police, tel que @sc{T1}. + +@item \ij +@itemx \IJ +@findex \ij (ij) +@findex \IJ (IJ) +@cindex lettre ij, Holandais +ij et IJ (à ceci près que les deux lettre apparaissent plus liées qu'ici). + +@item \l +@itemx \L +@findex \l (@l{}) +@findex \L (@L{}) +@cindex l polonais +@l{} et @L{}. + +@item \ng +@itemx \NG +@findex \ng +@findex \NG +Lettre eng laponais, utilisé aussi en phonétique. Non disponible dans le codage +@sc{OT1}, il vous faut le paquetage @file{fontenc} pour sélectionner un +autre codage de police, tel que @sc{T1}. + +@item \o +@itemx \O +@findex \o (@o{}) +@findex \O (@O{}) +@cindex oslash +@o{} et @O{}. + +@item \oe +@itemx \OE +@findex \oe (@oe{}) +@findex \OE (@OE{}) +@cindex o e liés +@cindex o, e dans l'o +@cindex e dans l'o +@oe{} et @OE{}. + +@item \ss +@itemx \SS +@findex \ss (@ss{}) +@findex \SS (SS) +@cindex eszet lettre allemande +@cindex s long +@ss{} et SS. + +@item \th +@itemx \TH +@findex \th (@th{}) +@findex \TH (@TH{}) +@cindex Icelandic thorn +@cindex thorn, lettre islandaise +Lettre islandaise thorn : @th{} et @TH{}. Non disponible dans le codage +@sc{OT1}, il vous faut le paquetage @file{fontenc} pour sélectionner un +autre codage de police, tel que @sc{T1}. + +@end table + + +@node \rule +@section @code{\rule} +@findex \rule + +Synopsis : + +@example +\rule[@var{élévation}]@{@var{largeur}@}@{@var{épaisseur}@} +@end example + +la commande @code{\rule} produit un @dfn{filet}, c.-à-d.@: une ligne ou +un rectangle. Les arguments sont : + +@table @var +@item élévation +De combien élever le filet (optionnel). + +@item largeur +La longueur du filet (obligatoire). + +@item épaisseur +L'épaisseur du filet (obligatoire). +@end table + + +@node \today +@section @code{\today} +@findex \today +@cindex date d'aujourd'hui + +La commande @code{\today} produit la date d'aujourd'hui, par défaut dans +le format @samp{@var{mois} @var{jj}, @var{aaaa}} ; par exemple, `July 4, +1976'. Elle utilise les compteurs prédéfinis @code{\day}, +@code{\month}, et @code{\year} (@pxref{\day \month \year}) pour faire +cela. Elle n'est pas mise à jour durant l'execution de la compilation. + +Les extensions multilingues comme entre autres le paquetage @file{babel} +ou la classe @file{lettre} localisent @code{\today}. Par exemple le code +suivant produit @samp{4 juillet 1976} : + +@example +\year=1976 \month=7 \day=4 +\documentclass@{minimal@} +\usepackage[french]@{babel@} +\begin@{document@} +\today +\end@{document@} +@end example + + +@PkgIndex{datetime} +Le paquetage @code{datetime}, entre autres, produit un large choix +d'autres formats de date. + + +@node Splitting the input +@chapter Partitionner le fichier d'entrée +@cindex partitionner le fichier d'entrée +@cindex fichier d'entrée + +Un document de grande taille nécessite beaucoup de données en +entrée. Plutôt que de mettre toutes les entrées dans un seul grand +fichier, il est plus efficace de les partitionner en plusieurs fichiers +plus petits. Indépendamment du nombre de fichiers distincts que vous +utilisez, il y en a un seul qui est le +@cindex racine, fichier +@cindex fichier racine +@dfn{fichier racine} ; c'est le fichier dont vous passer le nom à la +ligne de commande quand vous exécutez @LaTeX{}. + +@xref{filecontents}, pour un environnement qui permet de grouper un +fichier externe à créer avec le document principal. + +@menu +* \include:: Inclure conditionnellement un fichier. +* \includeonly:: Determiner quels fichiers sont à inclure. +* \input:: Inclure inconditionnellement un fichier. +@end menu + + +@node \include +@section @code{\include} +@findex \include + +Synopsis : + +@example +\include@{@var{fichier}@} +@end example + +Si aucune commande @code{\includeonly} n'est présente, la commande +@code{\include} exécute un @code{\clearpage} pour commencer une nouvelle +page (@pxref{\clearpage}), puis elle lit @var{fichier}, et ensuite fait +encore un @code{\clearpage}. + +Précédé d'une commande @code{\includeonly}, les actions de +@code{\include} ne sont exécutées que si @var{fichier} est un élément des +fichiers listés en argument de l'@code{\includeonly}. Voir @ref{\includeonly}. + +@cindex @code{\include} emboîtés interdits +La commande @code{\include} ne doit apparaître ni dans le préambule, ni +au sein d'un fichier lu par une autre commande @code{\include}. + + +@node \includeonly +@section \@code{includeonly} +@findex \includeonly + +Synopsis : + +@example +\includeonly@{@var{fichier1},@var{fichier2},...@} +@end example + +La commande @code{\includeonly} contrôle quels fichiers sont lisible par +toute commande @code{\include} venant ensuite. La liste des noms de +fichier est à éléments séparés par des virgules. Chaque élément +@var{fichier1}, @var{fichier2}, @dots{} doit exactement correspondre à +un nom de fichier spécifié en argument d'une commande @code{\include} +pour que la sélection soit effective. + +Cette commande ne peut apparaître que dans le préambule. + + +@node \input +@section \input +@findex \input + +Synopsis : + +@example +\input@{@var{nomfichier}@} +@end example + +La commande @code{\input} a pour effet que le @var{nomfichier} spécifié +soit lu et traité comme si son contenu était inséré dans le fichier +courant à cet endroit. + +Si @var{nomfichier} ne se termine pas en @samp{.tex} (par ex., +@samp{toto} ou @samp{toto.tata}), on essaie en premier en ajoutant cette +extension (@samp{toto.tex} ou @samp{toto.tata.tex}). Si aucun fichier +n'est trouvé avec ce nom, alors on essaie le @var{nomfichier} original +(c.-à-d.@: @samp{toto} ou @samp{toto.tata}). + +@node Front/back matter +@chapter Prologue et épilogue + +@menu +* Table des matières: Tables of contents. +* Glossaires: Glossaries. +* Index:Indexes. +@end menu + + +@node Tables of contents +@section Tables des matières + +@cindex table des matière, création + +@findex \tableofcontents +@findex .toc, @r{fichier} +On produit une table des matières avec la commande +@code{\tableofcontents}. Placez la commande à l'endroit même où vous +voulez que la table des matière apparaisse ; @LaTeX{} fera le reste pour +vous. Une seconde compilation est nécessaire pour qu'un fichier +@file{.toc} ait été produit à la précédente. + +La commande @code{\tableofcontents} produit un titre, mais il ne produit +pas automatiquement un début de nouvelle page. Si vous voulez une +nouvelle page après la table des matières, mettez une commande +@code{\newpage} après la commande @code{\tableofcontents}. + +@findex \listoffigures +@findex \listoftables +Les commandes analogues @code{\listoffigures} et @code{\listoftables} +produisent respectivement une liste des figures et une listes des +tableaux. Le fonctionnement est exactement le même que pour la table des matières. + +@findex \nofiles +La commande @code{\nofiles} l'emporte sur ces commandes, et +@emph{empèche} la génération de ces listes. + +@menu +* \addcontentsline:: Ajouter une entrée dans la table des matières etc. +* \addtocontents:: Ajouter du texte directement au fichier table des matières etc. +@end menu + + +@node \addcontentsline +@subsection @code{\addcontentsline} +@findex \addcontentsline@{@var{ext}@}@{@var{unit}@}@{@var{texte}@} +@cindex table of contents entry, manually adding + +Synopsis : + +@example +\addcontentsline@{@var{ext}@}@{@var{unit}@}@{@var{texte}@} +@end example + +La commande @code{\addcontentsline} ajoute une entrée a la liste ou +table specifiée où : + +@table @var +@item ext +L'extension de nom de fichier du fichier dans lequel l'information doit +être écrite, typiquement c'est l'une des trois suivante :: @code{toc} +pour la table des matière (« table of contents » en langue anglaise), +@code{lof} pour la liste des figures (« list of figures »), ou +@code{lot} pour la liste des tableaux (« list of tables »). + +@item unit +Le nom de l'unité sectionnelle à ajouter, typiquement l'une des +suivantes, selon la valeur de l'argument @var{ext} : + +@table @code +@item toc +Les unités sectionnelles : @code{part}, @code{chapter}, +@code{section}, @code{subsection}, @code{subsubsection}. +@item lof +Pour la liste des figures : @code{figure}. +@item lot +Pour la liste des tableaux : @code{table}. +@end table + +@item texte +Le texte de l'entrée. +@end table + +@findex \contentsline +Ce qui est écrit dans le fichier @file{.@var{ext}} est la commande +@code{\contentsline@{@var{unit}@}@{@var{texte}@}@{@var{numéro}@}}, où +@code{@var{numéro}} est la valeur courante du compteur +@code{@var{unit}}. + +@c ?? how hardwired are these values? other unit names? + + +@node \addtocontents +@subsection @code{\addtocontents} +@findex \addtocontents@{@var{ext}@}@{@var{texte}@} + +La commande @code{\addtocontents}@{@var{ext}@}@{@var{texte}@} ajoute du +texte (ou des commandes de formatage) directement au fichier +@file{.@var{ext}} 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. + +@table @var +@item ext +L'extension de nom de fichier du fichier dans lequel l'information est à +écrire : @file{toc} (table des matières), @file{lof} (liste des +figures), ou @file{lot} (liste des tableaux). + +@item texte +Le texte à écrire. +@end table + + +@node Glossaries +@section Glossaires +@cindex glossaires + +@findex \makeglossary +La commande @code{\makeglossary} active la création des glossaires. + +@findex \glossary +@cindex @file{.glo}, fichier +La commande @code{\glossary@{@var{texte}@}} écrit un article de +glossaire pour @var{texte} dans un fichier auxiliaire nommé avec +l'extension @file{.glo}. + +@findex \glossaryentry +Plus précisément, ce qui est écrit est la commande +@code{\glossaryentry@{@var{texte}@}@{@var{numpage}@}}, où @var{numpage} +est la valeur courante de @code{\thepage}. + +Le paquetage @code{glossary} disponible sur le CTAN fournit une prise en +charge de glossaires plus élaborée. + + +@node Indexes +@section Index +@cindex index + +@findex \makeindex +La commande @code{\makeindex} active la création d'index. Placez là dans le +préambule. + +@findex \index +@cindex @file{.idx}, fichier +La commande @code{\index@{@var{texte}@}} écrit un article d'index pour +@var{texte} dans un fichier auxiliaire nommé avec une extention +@file{.idx}. + +@findex \indexentry +Plus précisément, ce qui est écrit est la commande +@code{\indexentry@{@var{texte}@}@{@var{numpage}@}}, où @var{numpage} est +la valeur courante de @code{\thepage}. + +@cindex « Voir » et « Voir aussi », article d'index +Pour générer un article d'index pour « toto » qui dit « Voir titi », +utilisez une barre verticale : @code{\index@{toto|see@{titi@}@}}. +Utilisez @code{seealso} au lieu de @code{see} pour fabriquer un article +en « Voir aussi ». + +@findex \seename +@findex \alsoname +Le texte « Voir » est défini par la macro @code{\seename}, et le texte +« Voir aussi » par la macro @code{\alsoname}. Ils peuvent être redéfinis +pour d'autres langages. + +@cindex @command{makeindex}, programme +@cindex @command{xindy}, programle +@cindex @file{.ind}, fichier +Le fichier en @file{.idx} généré est ensuite trié avec une commande +externe, d'ordinaire soit @command{makeindex} +(@url{http://mirror.ctan.org/indexing/makeindex}) ou la commande ( +multi-lingue) @command{xindy} (@url{http://xindy.sourceforge.net}). +Ceci résulte en un fichier en @file{.ind}, ce qui peut ensuite être lu +pour composer l'index. + +@findex \printindex +@PkgIndex{makeidx} +L'index est d'ordinaire généré avec la commande @code{\printindex}. +Celle-ci est définie dans le paquetage @code{makeidx}, ainsi vous devez +mettre @code{\usepackage@{makeidx@}} dans le préambule. + +@findex \indexspace +La longueur élastique @code{\indexspace} est insérée avant chaque +nouvelle lettre dans l'index imprimé ; sa valeur par défaut est +@samp{10pt plus5pt minus3pt}. + +@PkgIndex{showidx} +Le paquetage @code{showidx} a pour effet que chaque article de l'index +est affiché dans la marge de la page où l'article apparaît. Ceci peut +aider à la préparation de l'index. + +@PkgIndex{multind} +Le paquetage @code{multind} prend en charge la pluralité des index. +Voir aussi l'article de la FAQ @TeX{} FAQ à ce propos, +@url{http://www.tex.ac.uk/cgi-bin/texfaq2html?label=multind}. + + +@node Letters +@chapter Des lettres +@cindex lettres, écrire des +@cindex écrire des lettres + +Synopsis : + +@example +\documentclass@{letter@} +\address@{@var{adresse expéditeur}@} +\signature@{@var{nom de l'expéditeur}@} +\begin@{document@} +\begin@{letter@}@{@var{adresse destinataire}@} +\opening@{@var{apostrophe}@} + @var{corps-de-la-lettre} +\closing@{@var{texte de salutation}@} +\end@{letter@} + ... encore des lettres ... +\end@{document@} +@end example + +Produit une ou plusieurs lettres. + +Chaque lettre est dans un environnement séparé @code{letter}, dont +l'argument @var{adresse desinataire} contient souvent plusieurs lignes +séparées par une double contr'oblique (@code{\\}). Par exemple, vous +pourriez avoir : + +@example + \begin@{letter@}@{M. Joseph Fabre \\ + 25 rue de la République\\ + 35700 Rennes@} + ... + \end@{letter@} +@end example + +Le début de l'environnement @code{letter} reinitialise le numéro de page +à 1, et le numéro de note en bas de page à 1 aussi. + +Les @var{adresse expéditeur} et @var{nom de l'expéditeur} sont +communs à toutes les lettres, qu'il y en ait une ou plus, ainsi il est +préférable de mettre ces déclarations dans le préambule. Comme avec +l'adresse du destinataire, souvent @var{adresse expéditeur} contient plusieurs +lignes séparées par une double contr'oblique @code{\\}. @LaTeX{} place +le @var{nom de l'expéditeur} sous la salutation, après un espace +vertical pour la signature manuscrite traditionnelle ; il peut aussi +contenir plusieurs lignes. + +Le corps de chaque environnement @code{letter} commence par une commande +@code{\opening} obligatoire telle que @code{\opening@{Madame, +Monsieur,@}}. Le texte @var{corps-de-la-lettre} est du code @LaTeX{} +ordinaire et peut donc tout contenir de la liste énumérée à des formules +mathématique en hors texte, à ceci près que la commandes de rubricage +telles que @code{\chapter} qui n'ont pas lieu d'être au sein d'une +lettre sont indisponibles. Chaque environnement @code{letter} se termine +typiquement par une commande @code{\closing} telle que dans +@code{\closing@{Je vous prie, Madame, Monsieur, d'agréer l'expression de +mes sentiments les meilleurs.@}}. + +@findex \\ @r{pour les lettres} +Du matériel suppélementaire peut venir après le @code{\closing}. Vous +pouvez préciser qui est en copie de la lettre avec une commande comme +@code{\cc@{Le Patron\\Le Patron du Patron@}}. Il y a une commande +@code{\encl} similaire pour spécifier une liste de pièces jointes. Et, +vous pouvez ajouter un postscriptum avec @code{\ps}. + +Par défaut @LaTeX{} renfonce la signature et la salutation +@code{\closing} la précédant d'une longueur valant +@code{\longindentation}. Celle-ci vaut par défaut +@code{0.5\textwidth}. Pour les aligner à gauche, il suffit de spécifier +@code{\setlength@{\longindentation@}@{0em@}} dans votre préambule. + +Pour fixer la date utilisez quelque-chose comme +@code{\renewcommand@{\today@}@{2015-10-12@}}. En plaçant ce code dans +votre préambule, il s'appliquera à toutes les lettres du document. + +Cet exemple est avec un seul environnement @code{letter}. Les trois +lignes marquées en commentaire comme optionnelles sont typiquement +omises. + +@example +\documentclass@{letter@} +\usepackage[T1]@{fontenc@} +\usepackage@{french@} +\address@{Rue de l'expéditeur \\ Ville de l'expéditeur@} +\signature@{Nom de l'expéditeur\\ Titre de l'expéditeur@} +% optionnel : \location@{Boîte Postale 13@} +% optionnel : \telephone@{(102) 555-0101@} +\begin@{document@} +\begin@{letter@}@{Nom du destinataire \\ Adresse du destinataire@} +\opening@{Monsieur,@} +% optionnel : \thispagestyle@{firstpage@} +I ne suis pas intéressé à faire affaire avec vous. +\closing@{Je vous prie, Monsieur, de recevoir mes salutations distinguées.@} +\end@{letter@} +\end@{document@} +@end example + +Ces commandes sont utilisées avec la classe @code{letter}. + +@menu +* \address:: Adresse de l'expéditeur. +* \cc:: Liste des personnes en copie. +* \closing:: Dire au-revoir. +* \encl:: Liste des pièces jointes. +* \location:: L'adresse de votre organisation. +* \makelabels:: Fabriquer des étiquette d'adresse. +* \name:: Votre nom, pour l'adresse de l'expéditeur. +* \opening:: Dire bonjour. +* \ps:: Ajouter un postscriptum. +* \signature:: Votre signature. +@c * \startbreaks:: Autorisez les sauts de page. +@c * \stopbreaks:: Interdire les sauts de page. +* \telephone:: Votre numéro de téléphone. +@end menu + + +@node \address +@section @code{\address} +@findex \address + +Synopsis : + +@example +\address@{@var{adresse-expéditeurs}@} +@end example + +Spécifie l'adresse de retour telle qu'elle apparaît sur la lettre et sur +l'enveloppe. Séparez des lignes multiples au sein de +@var{adresse-expéditeurs} avec une double contr'oblique @code{\\}. + +Parce qu'elle peut s'appliquer à des lettres multiples cette déclaration +est souvent placée dans le préambule. Toutefois elle peut être faite +n'importe où, y compris au sein d'un environnement @code{letter} +individuel. + +Cette commande est optionnelle : sans la déclaration @code{\address} 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é. (@xref{Overview}, +pour les détails concernant votre implémentation locale). Avec la +déclaration @code{\address}, elle est formatée comme une lettre +personnelle. + + +@node \cc +@section @code{\cc} + +@findex \cc +@cindex copie, liste des personnes en, dans une lettre +@cindex liste des personnes en copie, dans une lettre + +Synopsis : + +@example +\cc@{@var{premier nom}\\...@} +@end example + +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 @code{\closing}. En cas de ligne multiple, séparez +les avec une double contr'oblique @code{\\}, comme dans : + +@example +\cc@{Président \\ + Vice-président@} +@end example + + + +@node \closing +@section @code{\closing} + +@findex \closing +@cindex lettres, salutation +@cindex fin d'une lettre + +Synopsis : + +@example +\closing@{@var{texte}@} +@end example + +@c XXXX TODO en français la signature est au dessus du nom, pas en +@c dessous! + +D'ordinaire à la fin d'une lettre, au dessus de la signature manuscrite, +il y a un @code{\closing} (bien que cette commande soit +optionnelle). Par exemple : + +@example +\closing@{Je vous prie, Madame, Monsieur, d'agréer l'expression de ma + confiance.@} +@end example + + +@node \encl +@section @code{\encl} + +@findex \encl +@cindex pièces jointes, liste + +Synopsis : + +@example +\encl@{@var{ligne1}\\@var{ligne2}@} +@end example + +Déclare une liste d'une ou plus de pièces jointes. + + +@node \location +@section @code{\location} +@findex \location + +Synopsis : + +@example +\location@{@var{texte}@} +@end example + +Le @var{texte} apparaît centré au bas de chaque page. Il apparaît +seulement si le style de la page est @code{firstpage}. + + +@node \makelabels +@section @code{\makelabels} +@findex \makelabels + +Synopsis : + +@example +\makelabels +@end example + +Crée une feuille d'étiquettes d'adresses à partir des adresses des +destinataires, une pour chaque lettre. Cette feuille sera sortie avant +les lettres, avec dans l'idée de la copier sur une feuille vierge de +vignettes autocollantes. Cette commande est à mettre dans le préambule. + +Vous pouvez personnaliser les étiquettes en redéfinissant les trois +commandes @code{\startlabels}, @code{\mlabel} et @code{\returnaddress} +dans le préambule. Ces commandes ne sont pas à appeler directement par +l'utilisateur, c'est la classe @code{letter} qui les appelle. La +commande @code{\startlabels} compose la page sur laquelle les étiquettes +sont imprimées en termes de largeur, de hauteur, et de nombre de +colonnes, etc. La commande @code{\mlabel@{@var{adresse +expéditeur}@}@{@var{adresse destinataire}@}} est appelée pour chaque +lettre du document avec deux arguments : + +@itemize +@item +Le premier, @var{adresse expéditeur}, est le contenu courant de la macro +@code{\returnaddress} +@item +Le second, @var{adresse destinataire}, est l'adresse du destinataire +telle que passée en argument à l'environnement @code{letter}. +@end itemize + +La définition par défaut de @code{\mlabel} ignore le premier argument, +c'est à dire que si vous placez seulement un @code{\makelabels} dans le +préambule, la feuille d'étiquettes ne contiendra des étiquettes que pour +les destinataires. + +Si vous désirez imprimer une étiquette d'adresse expéditeur et d'adresse +destinataire pour chaque lettre, vous devez faire deux choses : +@enumerate +@item +La première est de redéfinir @code{\mlabel} pour fabriquer deux +étiquettes au lieu d'une, vous pouvez pour cela mettre ce qui suit dans le préambule : + +@example +\newcommand*\originalMlabel@{@} +\let\originalMlabel\mlabel +\def\mlabel#1#2@{\originalMlabel@{@}@{#1@}\originalMlabel@{@}@{#2@}@} +@end example + +Ceci ne suffit toutefois pas, parce que la première des deux étiquettes +est vide, vu que la définition par défaut de @code{\returnaddress} l'est. +@item +La seconde est de redéfinir @code{\returnaddress} pour contenir +l'adresse de l'expéditeur, vous pouvez faire cela en plaçant dans le +préambule : + +@example +\renewcommand*\returnaddress@{\protect\fromname\\\protect\fromaddress@} +@end example + +@end enumerate + +@node \name +@section @code{\name} +@findex \name + +@code{\name@{June Davenport@}} + +Le nom de l'expéditeur, à imprimer sur l'enveloppe avec l'adresse de +retour. + + +@node \opening +@section @code{\opening@{@var{texte}@}} +@findex \opening +@cindex lettres, commencer + +Synopsis : + +@example +\opening@{@var{texte}@} +@end example + +Cette commande est obligatoire. Elle commence la lettre, en suivant le +@code{\begin@{letter@}@{...@}}. L'argument obligatoire @var{texte} est le +@cindex appel +texte d'@dfn{appel} de votre lettre. Par exemple : + +@example +\opening@{Dear John,@} +@end example + + +@node \ps +@section @code{\ps} +@findex \ps +@cindex postscriptum, dans une lettre + +Synopsis : + +@example +\ps@{@var{texte}@} +@end example + + +Utilisez la commande @code{\ps} pour commencer un postscriptum dans une lettre, après +@code{\closing}. + + +@node \signature +@section @code{\signature@{@var{texte}@}} +@findex \signature + +Synopsis : + +@example +\signature@{@var{première ligne} \\ + ... @} +@end example + +@findex \signature + +Le nom de l'expéditeur. Cette commande est optionnelle, quoique son +inclusion soit habituelle. + +Le texte de l'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 lignes multiples avec une double +contr'oblique @code{\\}. Par exemple : + +@example +\signature@{J Fred Muggs \\ + White House@} +@end example + +La valeur par défault de @LaTeX{} pour l'espace verticale space du texte +de @code{\closing} au texte de @code{\signature} est +@code{6\medskipamount}, ce qui vaut six fois 0,7@dmn{em}. + +Cette commande est d'ordinaire dans le preambule, de sorte à s'appliquer +à toutes les lettres du document. Pour qu'elle ne s'applique qu'à une +seule lettre, placez la au sein d'un environnement @code{letter} et +avant le @code{\closing}. + +Vous pouvez inclure un graphique dans la signature, par exemple avec +@code{\signature@{\vspace@{-6\medskipamount@}\includegraphics@{sig.png@}\\ +My name@}} (ceci nécessite d'écrire @code{\usepackage@{graphicx@}} dans +le préambule). + +@c Jim a écrit: I think this is not a user-level command; it is used to keep from breaking +@c the page between the closing and the signature +@c @node \startbreaks +@c @section @code{\startbreaks} +@c @findex \startbreaks +@c +@c @code{\startbreaks} +@c +@c Used after une commande @code{\stopbreaks} to allow page breaks again. +@c +@c +@c +@c @node \stopbreaks +@c @section @code{\stopbreaks} +@c @findex \stopbreaks +@c +@c @code{\stopbreaks} +@c +@c Inhibit page breaks until une commande @code{\startbreaks} occurs. +@c + + +@node \telephone +@section @code{\telephone} +@findex \telephone + +Synopsis : + +@code{\telephone@{@var{numéro}@}} + +C'est le numéro de telephone de l'expéditeur. Déclaré typiquement dans +le préambule, où il s'applique à toutes les lettres. Ceci apparaît +seulement si le style de +@c vincentb1: vérifier ce que pagestyle veut dire. +page (@code{pagestyle}) @code{firstpage} est sélectionné. Dans ce cas, +il apparaît en bas à droite de la page. + + +@node Terminal input/output +@chapter Entrée/sortie console +@cindex entrée/sortie console + +@menu +* \typein:: Lire du texte à partir de la console. +* \typeout:: Écrire du texte vers la console. +@end menu + + +@node \typein +@section @code{\typein[@var{cmd}]@{@var{msg}@}} +@findex \typein + +Synopsis : + +@example +\typein[@var{\cmd}]@{@var{msg}@} +@end example + +@code{\typein} tape @var{msg} sur la console et fait que @LaTeX{} +s'arrête et attend que vous saisisiez une ligne d'entrée, en la +terminant par un retour-chariot. Si l'argument optionnel @var{\cmd} est +omis, l'netrée tapée est traitée comme si elle avec été incluse dans le +fichier d'entrée à la place de la commande @code{\typein}. Si +l'argument @var{\cmd} est présent, cela doit être un nom de commande. +Ce nom de commande est alors défini, ou redéfini, pour se développer en +le texte en entrée qui a été tapé. + + +@node \typeout +@section @code{\typeout@{@var{msg}@}} +@findex \typeout + +Synopsis : + +@example +\typeout@{@var{msg}@} +@end example + +Tape @code{msg} sur le terminal et dans le journal (fichier +@code{log}). Les commandes dans @code{msg} qui sont définis avec +@code{\newcommand} ou @code{\renewcommand} (entre autres) sont +remplacées par leurs définitions avant d'être tapée. + +Les règles usuelles de @LaTeX{} pour le traitement de plusieurs espaces +comme un seul espace et pour ignorer les espaces après un nom de +commande s'appliquent à @code{msg}. Une commande @code{\space} dans +@code{msg} provoque un unique espace tapé, indépendant des espaces qui +l'entourent. Un @code{^^J} dans @code{msg} tape un saut à la ligne. + +@node Command line +@chapter Ligne de commande +@cindex ligne de commande + +La spécification du fichier d'entrée indique le fichier à être formaté ; +@TeX{} utilise @file{.tex} comme extension de fichier par défaut. Si +vous omettez complètment le fichier d'entrée, @TeX{} accèpte en entrée +les caractères saisis à partir de la console. Vous spécifiez les +options de commande en fournissant une chaîne en paramètre de la +commande ; par ex. + +@example +latex '\nonstopmode\input foo.tex' +@end example + +@noindent +Traitera @file{foo.tex} sans faire de pause après chaque erreur. + +@cindex invite @samp{*} +@cindex @samp{*}, invite +@findex \stop +Si @LaTeX{} s'arrête au milieu du document et vous fait une invite en +@samp{*}, c'est qu'il attend que vous saisissiez quelque chose. Vous +pouvez taper @code{\stop} (et retour-chariot) et il terminera +prématurément le document. + +@xref{@TeX{} engines}, pour les autres commandes système invoquant @LaTeX{}. + +@node Document templates +@appendix Patrons de documents +@cindex patron de document +@cindex modèle de document + +Bien que ce ne soit pas un matériel de référence, peut-être que ces +patrons de document vous seront utiles. Davantage de resources de +patrons sont listé à @url{http://tug.org/interest.html#latextemplates}. + +@menu +* patron @code{beamer}: beamer template. +* patron @code{book}: book template. +* patron @code{tugboat}: tugboat template. +@end menu + + +@node beamer template +@section Un patron @code{beamer} + +@cindex @code{beamer} patron et classe +@cindex patron, @code{beamer} + +La classe @code{beamer} crée des présentations en diapositives. Elle a +de très nombreuses possibilités, mais voici un patron de base : + +@verbatim +\documentclass{beamer} +\usepackage[latin1]{inputenc} + +\title{Patron pour la classe Beamer} +\author{Alex L'Auteur} +\date{31 juillet 2007} + +\begin{document} + +\maketitle + +% sans [fragile], n'importe quel code {verbatim} se prend des erreurs mystérieuses. +\begin{frame}[fragile] + \frametitle{Première diapositive} + +\begin{verbatim} + C'est \verbatim! +\end{verbatim} + +\end{frame} + +\end{document} +@end verbatim + +Une ressource web pour cela : +@url{http://robjhyndman.com/hyndsight/beamer/}. + + +@node book template +@section Un patron @code{book} + +@cindex patron, @code{book} + + +@verbatim +\documentclass{book} +\title{Le Patron de la classe book} +\author{Alex L'Auteur} + +\begin{document} +\maketitle + +\chapter{Premier} +Du texte. + +\chapter{Second} +Et du texte. + +\section{Un sujet secondaire} +La fin. +\end{document} +@end verbatim + + +@node tugboat template +@section Un patron @code{tugboat} + +@cindex patron, TUGboat +@cindex classe @code{ltugboat} + +@cite{TUGboat} est la revue du groupe des utilisateur de @TeX{} (@TeX{} +Users Group), @url{http://tug.org/TUGboat}. + +@verbatim +\documentclass{ltugboat} +\usepackage{graphicx} +\usepackage{ifpdf} +\ifpdf +\usepackage[breaklinks,hidelinks]{hyperref} +\else +\usepackage{url} +\fi + +\title{Exemple d'article \TUB} + +% 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} +Ceci est un exemple d'article pour le \TUB{}. +Prière d'écrire un abrégé. +\end{abstract} + +\section{Introduction} + +Ceci est un exemple d'article pour le \TUB, à partir du lien +\url{http://tug.org/TUGboat/location.html}. + +Nous recommandons le paquetage graphicx pour les inclusionj d'iimage, et +le paquetage hyperref pour des adresses réticulaires (url) actives (dans +la sortie \acro{PDF}). De nos jour le \TUB\ est produit en utilisant +exclusivement des fichiers \acro{PDF}. + +La classe \texttt{ltugboat} fournit ces abréviations (et bien d'autres) : + +% verbatim blocks are often better in \small +\begin{verbatim}[\small] +\AllTeX \AMS \AmS \AmSLaTeX \AmSTeX \aw \AW +\BibTeX \CTAN \DTD \HTML +\ISBN \ISSN \LaTeXe +\mf \MFB +\plain \POBox \PS +\TUB \TUG \tug +\UNIX \XeT \WEB \WEAVE + +\, \bull \Dash \dash \hyph + +\acro{FRED} -> {\small[er] fred} % prière d'utiliser ! +\cs{fred} -> \fred +\meta{fred} -> <fred> +\nth{n} -> 1st, 2nd, ... +\sfrac{3/4} -> 3/4 +\booktitle{Book of Fred} +\end{verbatim} + +Pour faire référence à d'autre numéros du \TUB\, veuillez utiliser le +format \textsl{volno:issno}, par ex., ``\TUB\ 32:1'' pour notre numéro +\nth{100}. + +Ce fichier n'est qu'un patron. La documentation du style \TUB\ est dans +le document \texttt{ltubguid} se trouvant à +\url{http://ctan.org/pkg/tugboat}. (Pour les références au \CTAN\ nous +recommandons cette forme d'URL utilisant \texttt{/pkg/} quand cela fait +sens ; ou, si vous avez besoin de faire référence spécifiquement à une +localisation : \texttt{http://mirror.ctan.org/\textsl{chemin}}.) + +Écrivez par mél à \verb|tugboat@tug.org| en cas de problèmes ou +questions. + +\bibliographystyle{plain} % nous recommandons le style de bibliographie plain +\nocite{book-minimal} % pour forcer la bibliographie à ne pas être vide +\bibliography{xampl} % xampl.bib est compris dans BibTeX + +\makesignature +\end{document} +@end verbatim +@node License translation, Concept Index, Document templates, Top +@comment node-name, next, previous, up +@appendix Traduction de la licence + +La traduction qui suit est donnée uniquement à titre informatif, et ne +remplace pas le texte en anglais donné au début de ce document. + +Permission vous est donnée de distribuer des copies conformes de ce +manuel à condition que les mentions du droit d'auteur et de permission +soient préservées sur toutes les copies. + +@ignore +Il est permis de traiter ce fichier par @TeX{} et d'imprimer le +résultat, à condition que le document imprimé porte une mention de +permission de copier identique à celle-ci à l'exception de la +suppression de ce paragraphe (ce paragraphe n'étant pas pertinent pour +le manuel imprimé). +@end ignore + +Permission vous est donnée de copier et distribuer des versions +modifiées de ce manuel dans les conditions d'une copie conforme, à +condition que l'ensemble de l'ouvrage dérivé résultant soit distribué +sous les termes d'une mention de permission identique à celle-ci. + +Permission vous est donnée de copier et distribuer des traductions de ce +manuel dans une autre langue, dans les conditions ci-dessus pour les +versions modifiées. + +@node Concept Index +@unnumbered Index des concepts + +@printindex cp + +@c The name of the `Commande Index' node must NOT be altered for ltx-help.el. +@node Command Index +@unnumbered Index des commandes + +@printindex fn + +@bye + +\def\DeclareTextCommand{\foo}{T1} +% then |\foo| is defined to be |\T1-cmd \foo \T1\foo|, +% % where |\T1\foo| is \emph{one} control sequence, not two! +\newcommand + +\def\ProvideTextCommand -- same with \providecommand +\@onlypreamble\DeclareTextCommand +\@onlypreamble\DeclareTextSymbol +\gdef\TextSymbolUnavailable#1{% +\@onlypreamble\def\DeclareTextCommandDefault#1{% +\def\ProvideTextCommandDefault#1{% +\def\DeclareTextAccent#1#2#3{% +\def\DeclareTextCompositeCommand#1#2#3#4{% +\@onlypreamble\def\DeclareTextComposite#1#2#3#4{% +\def\UseTextAccent#1#2#3{% +\def\UseTextSymbol#1#2{% +\@onlypreamble\DeclareTextSymbolDefault@item +\@onlypreamble\DeclareTextAccentDefault@item +\def\UndeclareTextCommand#1#2{% + +@c Local Variables: +@c ispell-dictionary: "francais" +@c coding: utf-8-unix +@c input-method-history: ("french-postfix") +@c TeX-open-quote: "« " +@c TeX-close-quote: " »" +@c End: |