diff options
Diffstat (limited to 'Master/texmf-dist/doc/latex/latex2e-help-texinfo-fr/latex2e-fr.dbk')
| -rw-r--r-- | Master/texmf-dist/doc/latex/latex2e-help-texinfo-fr/latex2e-fr.dbk | 3557 |
1 files changed, 2395 insertions, 1162 deletions
diff --git a/Master/texmf-dist/doc/latex/latex2e-help-texinfo-fr/latex2e-fr.dbk b/Master/texmf-dist/doc/latex/latex2e-help-texinfo-fr/latex2e-fr.dbk index 70a500266a8..151c9cf13f3 100644 --- a/Master/texmf-dist/doc/latex/latex2e-help-texinfo-fr/latex2e-fr.dbk +++ b/Master/texmf-dist/doc/latex/latex2e-help-texinfo-fr/latex2e-fr.dbk @@ -7,7 +7,7 @@ <!-- $Id: common.texi 729 2018-11-13 23:22:27Z karl $ --> <!-- Public domain. --> -<title>Manuel de référence officieux de &latex;2e (Septembre 2020)</title> +<title>Manuel de référence officieux de &latex;2e (Décembre 2020)</title> <!-- % ** fin de tête (c'est pour courir Texinfo sur une région.) --> <!-- latex 2.09 commandes devraient tous être présents maintenant, --> @@ -34,8 +34,28 @@ <!-- xx fusionner latex manuel de la savane --> <!-- xx fusionner style mathématique hors texte --> <!-- xx mode veritical, mode horizontal --> +<!-- xx check recent ltnews for (lots of) changes --> +<!-- xx \write of non-ASCII chars (vincent mail of 14 Mar 2020 21:39:41) --> +<!-- xx \nonstopmode etc., if they are officially supported by LaTeX? --> +<!-- xx JH explain nfss somewhere --> +<!-- xx JH expand BiBTeX --> +<!-- xx JH expand theorem, AMS math --> +<!-- xx JH something on code listings --> +<!-- xx JH ligatures --> +<!-- xx JH \xspace --> +<!-- xx JH \stretch --> +<!-- xx JH \mathstrut --> +<!-- xx JH \phantom https://tex.stackexchange.com/questions/4519/how-do-i-create-an-invisible-character --> +<!-- xx JH \baselineskip https://texfaq.org/FAQ-baselinepar --> +<!-- xx JH \contentsline, \@@dottedtocline? --> +<!-- xx JH \numexpr, \dimexpr, \glueexpr, \muexpr --> <!-- --> -<!-- --> +<!-- xx The typeset source2e has an index with all kernel --> +<!-- xx commands, though some are internal and shouldn't be included. --> +<!-- xx classes.dtx et al. define additional commands. --> +<!-- xx See also http://ctan.org/pkg/macros2e. --> +<!-- --> +<!-- xx All the special characters should be definitively described. --> <!-- --> <!-- xx Notes de P. Bideault --> <!-- --> @@ -51,7 +71,7 @@ <!-- xx Voir aussi http://ctan.org/pkg/macros2e. --> <!-- xx Tous les caractères spéciaux devraient une fois pour toute être dérits --> <!-- --> -<!-- packages xx - requis, plus, utile; Oberdiek; polices --> +<!-- xx packages & classes - requis, plus, utiles; Oberdiek; polices --> <!-- ressources pour les termes typographiques en français: --> <!-- http://david.carella.free.fr/fr/typographie/glossaire-typographique.html --> @@ -64,7 +84,7 @@ <!-- http://mirror.ctan.org/info/impatient/fr/fbook.pdf --> <bookinfo><legalnotice><para>Ce document est un manuel de référence officieux pour &latex;, un -système de préparation de documents, version « Septembre 2020 ». +système de préparation de documents, version « Décembre 2020 ». </para> <para>Ce manuel a été traduit du fichier <filename>LATEX.HLP</filename> v1.0a de la bibliothèque d’aide VMS. La version pré-traduction a été rédigée par @@ -107,7 +127,7 @@ into another language, under the above conditions for modified versions. <para>Ce document est un manuel de référence officieux pour &latex;, un -système de préparation de documents, version « Septembre 2020 ». +système de préparation de documents, version « Décembre 2020 ». </para> <para>Ce manuel a été traduit du fichier <filename>LATEX.HLP</filename> v1.0a de la bibliothèque d’aide VMS. La version pré-traduction a été rédigée par @@ -148,14 +168,13 @@ into another language, under the above conditions for modified versions. <!-- end of License --> </para> - <!-- Best Effort Symbol --> <chapter label="" id="Top"> <title>&latex;2e : un manuel de référence officieux</title> <para>Ce document est un manuel de référence officieux pour &latex;2e, un -système de préparation de document, dans sa version « Septembre 2020 ». +système de préparation de document, dans sa version « Décembre 2020 ». </para> @@ -167,7 +186,7 @@ système de préparation de document, dans sa version « Septembre 2020 ». <para>Ceci est un manuel de référence officieux pour le système &latex;2e de préparation de document. Ce système est mis en œuvre sous forme d’un paquet de macros pour le programme de composition &tex; -(see <link linkend="Overview">Overview</link>). La page d’accueil de ce document est +(voir <link linkend="Overview">Overview</link>). La page d’accueil de ce document est <ulink url="https://latexref.xyz">https://latexref.xyz</ulink>. Cette page contient des liens vers différentes versions de ce document, dans différents formats et langues, mais aussi vers ses sources, vers les archives des listes de diffusion qui lui sont consacrées ainsi que vers d’autres @@ -299,7 +318,7 @@ Bonjour le monde \LaTeX. elle est implémentée dans une fichier <filename>article.cls</filename>. 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. See <link linkend="Document-classes">Document classes</link>. +largement disponibles. Voir <link linkend="Document-classes">Document classes</link>. </para> <indexterm role="cp"><primary>préambule, définition</primary></indexterm> <para>Vous pouvez inclure d’autres commandes &latex; entre les commandes @@ -310,9 +329,9 @@ appelée le <firstterm>préambule</firstterm>). <indexterm role="cp"><primary>environnement</primary></indexterm> appelle un <firstterm>environnement</firstterm> ; l’environnement ‘<literal>document</literal>’ (et aucun autre) est obligatoire dans tous les documents &latex; -(see <link linkend="document">document</link>). &latex; fournit lui-même beaucoup +(voir <link linkend="document">document</link>). &latex; fournit lui-même beaucoup d’environnements, et bien plus encore sont définis séparément. -See <link linkend="Environments">Environments</link>. +Voir <link linkend="Environments">Environments</link>. </para> <para>Les rubriques suivantes sont consacrées aux façons de produire, à partir d’un fichier d’entrée &latex;, des documents PDF ou @@ -324,7 +343,7 @@ d’autres formats. <title>Fichiers de sortie</title> <para>&latex; produit un fichier de sortie principal et au moins deux -fichiers accessoires. Le nom du fichier de sortie principal se termine +fichiers auxiliaires. Le nom du fichier de sortie principal se termine soit en <filename>.dvi</filename> soit en <filename>.pdf</filename>. </para> <variablelist><varlistentry><term><literal>.dvi</literal> @@ -334,7 +353,7 @@ soit en <filename>.dvi</filename> soit en <filename>.pdf</filename>. <indexterm role="fn"><primary>commande dvips</primary></indexterm> <indexterm role="fn"><primary>commande dvipdfmx</primary></indexterm> <indexterm role="fn"><primary>commande dvitype</primary></indexterm> -<para>S’il est invoqué avec la commande système <command>latex</command>, alors il +<anchor id="output-files-dvi"/><para>S’il est invoqué avec la commande système <command>latex</command>, alors il produit un fichier « DeVice Independent<footnote><para>Indépendant du périphérique de sortie, ce n’est toutefois pas un format portable de document</para></footnote> » (<filename>.dvi</filename>). Vous pouvez visualiser ce fichier avec une @@ -348,11 +367,11 @@ pour fichiers DVI sont disponibles (<ulink url="http://mirror.ctan.org/dviware"> </term><listitem><indexterm role="fn"><primary>.pdf fichier</primary></indexterm> <indexterm role="cp"><primary>pdf&tex;</primary></indexterm> <indexterm role="fn"><primary>commande pdflatex</primary></indexterm> -<para>Si &latex; est invoqué avec la commande système <command>pdflatex</command>, +<anchor id="output-files-pdf"/><para>Si &latex; est invoqué avec la commande système <command>pdflatex</command>, alors la sortie principale est un fichier “Portable Document Format” (<filename>.pdf</filename>). Typiquement, il s’agit d’un fichier autonome, avec toutes les polices et images incorporées. -D’autres commandes (see <link linkend="TeX-engines">&tex; engines</link>) produisent des fichiers PDF. +D’autres commandes (voir <link linkend="TeX-engines">&tex; engines</link>) produisent des fichiers PDF. </para> <!-- - Cela peut être très utile, mais cela rend le fichier de sortie beaucoup --> <!-- - plus grand que le fichier @file{.dvi} produit à partir du même document. --> @@ -371,13 +390,13 @@ D’autres commandes (see <link linkend="TeX-engines">&tex; engines</link>) <!-- - Beaucoup d'autres variantes moins courantes de @LaTeX{} (et @TeX{}) existent, qui --> <!-- - peuvent produire du HTML, XML, et d'autres choses. --> -<para>&latex; produit aussi au moins deux fichier supplémentaires. +<para>&latex; produit toujours au moins deux fichier supplémentaires. </para> <variablelist><varlistentry><term><literal>.log</literal> </term><listitem><indexterm role="cp"><primary>fichier de transcription</primary></indexterm> <indexterm role="cp"><primary>fichier journal</primary></indexterm> <indexterm role="fn"><primary>fichier .log</primary></indexterm> -<para>Ce fichier de transcription, ou <firstterm>fichier journal</firstterm>, contient des +<anchor id="output-files-log"/><para>Ce fichier de transcription, ou <firstterm>fichier journal</firstterm>, contient des informations sommaires telles que la liste des paquetages chargés. Il contient aussi des messages de diagnostic <!-- - pour toutes les erreurs découvertes dans le fichier d'entrée. --> @@ -390,7 +409,7 @@ erreurs. <indexterm role="cp"><primary>double renvoi, résolution</primary></indexterm> <indexterm role="cp"><primary>renvoi en aval, résolution</primary></indexterm> <indexterm role="cp"><primary>renvoi, résolution</primary></indexterm> -<para>De l’information auxiliaire est utilisée par &latex; pour des choses +<anchor id="output-files-aux"/><para>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 @@ -417,9 +436,9 @@ d’interrogation avec la localisation mémorisée. terminaison du nom de fichier. Ceux-ci incluent un fichier <literal>.lof</literal> qui est utilisé pour fabriquer la liste des figures, un fichier <literal>.lot</literal> utilisé pour fabriquer une liste des tableaux, et un fichier -<literal>.toc</literal> 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. +<literal>.toc</literal> utilisé pour fabriquer une table des matières (voir <link linkend="Table-of-contents-etc_002e">Table +of contents etc.</link>). Une classe de document particulière peut en créer +d’autres ; cette liste n’a pas de fin définie. </para> </sect1> @@ -432,17 +451,28 @@ fin définie. <indexterm role="cp"><primary>entrée Unicode, native</primary></indexterm> <indexterm role="cp"><primary>polices TrueType</primary></indexterm> <indexterm role="cp"><primary>polices OpenType</primary></indexterm> -<para>&latex; est défini comme un ensemble de commandes qui sont exécutées par -une implémentation &tex; (see <link linkend="Overview">Overview</link>). Cette section donne une -brève vue d’ensemble des principaux programmes. -</para> -<variablelist><varlistentry><term><literal>latex</literal> -</term><term><literal>pdflatex</literal> -</term><listitem><indexterm role="cp"><primary>pdf&tex;, moteur</primary></indexterm> +<indexterm role="cp"><primary>&tex;, format</primary></indexterm> +<indexterm role="cp"><primary>format &tex;, fichier (<literal>.fmt</literal>)</primary></indexterm> +<indexterm role="cp"><primary>format &latex;, fichier (<literal>.fmt</literal>)</primary></indexterm> +<indexterm role="cp"><primary>&latex;, format, fichier (<literal>.fmt</literal>)</primary></indexterm> +<indexterm role="cp"><primary>fichier format &tex;</primary></indexterm> +<indexterm role="fn"><primary>.fmt, fichier</primary></indexterm> +<para>&latex; est un vaste ensemble de commandes qui sont exécuté par un +programme &tex; (voir <link linkend="Overview">Overview</link>). Un tel ensemble de commande est +appelé un <firstterm>format</firstterm>, et peut être matérialisé dans un fichier binaire +<literal>.fmt</literal>, ce qui permet qu’il soit lu bien plus rapidement que le +source &tex; correspondant. +</para> +<para>Cette rubrique donne une brève vue d’ensemble des programmes &tex; +les plus répandus (voir aussi <link linkend="Command-line-interface">Command line interface</link>). +</para> +<variablelist><varlistentry><term><indexterm role="fn"><primary>latex</primary></indexterm><literal>latex</literal> +</term><term><indexterm role="fn"><primary>pdflatex</primary></indexterm><literal>pdflatex</literal> +</term><listitem><indexterm role="fn"><primary>etex, commande</primary></indexterm> +<indexterm role="cp"><primary>pdf&tex;, moteur</primary></indexterm> <indexterm role="cp"><primary>moteur pdf&tex;</primary></indexterm> -<indexterm role="fn"><primary>etex, commande</primary></indexterm> <indexterm role="cp"><primary>e-&tex;</primary></indexterm> -<para>Dans &tex; Live (<ulink url="http://tug.org/texlive">http://tug.org/texlive</ulink>, si &latex; est invoqué +<anchor id="tex-engines-latex"/><para>Dans &tex; Live (<ulink url="http://tug.org/texlive">http://tug.org/texlive</ulink>, si &latex; est invoqué avec les commandes système <command>latex</command> ou <command>pdflatex</command>, alors le moteur pdf&tex; est exécuté (<ulink url="http://ctan.org/pkg/pdftex">http://ctan.org/pkg/pdftex</ulink>). Selon qu’on invoque <command>latex</command> ou <command>pdflatex</command>, la sortie @@ -461,25 +491,24 @@ est un <filename>.dvi</filename>). 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;. </para> -</listitem></varlistentry><varlistentry><term><literal>lualatex</literal> +</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>lualatex</primary></indexterm><literal>lualatex</literal> </term><listitem><indexterm role="fn"><primary>lualatex commande</primary></indexterm> <indexterm role="cp"><primary>Lua&tex;</primary></indexterm> -<para>Si &latex; est invoqué avec la commandes systèmes <command>lualatex</command>, +<anchor id="tex-engines-lualatex"/><para>Si &latex; est invoqué avec la commandes systèmes <command>lualatex</command>, alors le moteur Lua&tex; est exécuté (<ulink url="http://ctan.org/pkg/luatex">http://ctan.org/pkg/luatex</ulink>). Ce programme permet que du code écrit dans le langage script Lua (<ulink url="http://luatex.org">http://luatex.org</ulink>) interagisse avec la compostion faite par &tex;. Lua&tex; traite nativement l’entrée en codage Unicode UTF-8, peut traiter les polices OpenType et TrueType, et produit un fichier <filename>.pdf</filename> par défaut. Il y a aussi -<command>dvilualatex</command> pour produire un fichier <filename>.dvi</filename>, mais cela -est rarement utilisé. +<command>dvilualatex</command> pour produire un fichier <filename>.dvi</filename>. </para> -</listitem></varlistentry><varlistentry><term><literal>xelatex</literal> +</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>xelatex</primary></indexterm><literal>xelatex</literal> </term><listitem><indexterm role="fn"><primary>xelatex commande</primary></indexterm> <indexterm role="cp"><primary>Xe&tex;</primary></indexterm> <indexterm role="fn"><primary>.xdv fichier</primary></indexterm> <indexterm role="fn"><primary>xdvipdfmx</primary></indexterm> -<para>Si &latex; est invoqué avec la commandes système <command>xelatex</command>, le +<anchor id="tex-engines-xelatex"/><para>Si &latex; est invoqué avec la commandes système <command>xelatex</command>, le moteur Xe&tex; est exécuté (<ulink url="http://tug.org/xetex">http://tug.org/xetex</ulink>). Comme Lua&tex;, Xe&tex; prend en charge nativement le codage Unicode UTF-8 et les polices TrueType et OpenType, bien que leur implémentation soit @@ -492,13 +521,44 @@ DVI, et traduit cela en PDF en utilisant le programme (<literal>x</literal>)<literal>dvipdfmx</literal>, mais ce processus est automatique. Le fichier <literal>.xdv</literal> n’est utile que pour le débogage. </para> -</listitem></varlistentry></variablelist> -<para>D’autres variantes de &latex; et &tex; existent, par exemple pour fournir -une prise en charge supplémentaire du japonais et d’autres langages -([u]p&tex;, <ulink url="http://ctan.org/pkg/ptex">http://ctan.org/pkg/ptex</ulink>, -<ulink url="http://ctan.org/pkg/uptex">http://ctan.org/pkg/uptex</ulink>). +</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>platex</primary></indexterm><literal>platex</literal> +</term><term><indexterm role="fn"><primary>uplatex</primary></indexterm><literal>uplatex</literal> +</term><listitem><para>Ces commandes fournissent une prise en charge significativement plus riche du Japanese et d’autres langues ; la variant en <filename>u</filename> prend en charge l’Unicode. Voir +<ulink url="https://ctan.org/pkg/ptex">https://ctan.org/pkg/ptex</ulink> et <ulink url="https://ctan.org/pkg/uptex">https://ctan.org/pkg/uptex</ulink>. +</para></listitem></varlistentry></variablelist> +<para>Depuis 2019, il y a une commande companion en <literal>-dev</literal> et un format +pour tous les moteur cités plus hauts : +</para> +<variablelist><varlistentry><term><indexterm role="fn"><primary>dvilualatex-dev</primary></indexterm><literal>dvilualatex-dev</literal> +</term><term><indexterm role="fn"><primary>latex-dev</primary></indexterm><literal>latex-dev</literal> +</term><term><indexterm role="fn"><primary>lualatex-dev</primary></indexterm><literal>lualatex-dev</literal> +</term><term><indexterm role="fn"><primary>pdflatex-dev</primary></indexterm><literal>pdflatex-dev</literal> +</term><term><indexterm role="fn"><primary>platex-dev</primary></indexterm><literal>platex-dev</literal> +</term><term><indexterm role="fn"><primary>uplatex-dev</primary></indexterm><literal>uplatex-dev</literal> +</term><term><indexterm role="fn"><primary>xelatex-dev</primary></indexterm><literal>xelatex-dev</literal> +</term><listitem><indexterm role="cp"><primary>parution, candidats</primary></indexterm> +<indexterm role="cp"><primary>avant parution, essais</primary></indexterm> +<para>Ce sont les candidats pour une parution de &latex; à venir. L’usage +principal est de découvrir et traiter les problèmes de compatibilité +avant la parution officielle. +</para> +<para>Ces format en <literal>-dev</literal> rendent facile pour quiconque d’aider à +l’essai des documents et du code : vous pouvez exécutez, dison, +<literal>pdflatex-dev</literal> au lieu de <literal>pdflatex</literal>, sans changer quoi que ce +soit d’autre dans votre environnement. En réalité, le plus facile et +utile est de toujours exécuter les versions en <literal>-dev</literal> au lieu de +s’embêter à basculer entre les deux. Pendant les périodes calmes après une +parution, ces commandes seront équivalentes. +</para> +<para>Ce ne sont pas des échantillons quotidiens de code de développement non +testé. L’équipe &latex; fait subir à ces commandes les mêmes essais +étendus de non régression avant leur parution. +</para> +<para>Pour plus ample information, voir “The &latex; release workflow and the +&latex; <literal>dev</literal> formats” par Frank Mittelbach, <citetitle>TUGboat</citetitle> 40:2, +<ulink url="https://tug.org/TUGboat/tb40-2/tb125mitt-dev.pdf">https://tug.org/TUGboat/tb40-2/tb125mitt-dev.pdf</ulink>. </para> - +</listitem></varlistentry></variablelist> </sect1> <sect1 label="2.4" id="LaTeX-command-syntax"> <title>Syntaxe des commandes &latex;</title> @@ -513,15 +573,15 @@ chaîne de lettres ou (b) un unique caractère, qui dans ce cas n’est pas </para> <para>Les noms de commandes &latex; sont sensibles à la casse de sorte que <literal>\pagebreak</literal> diffère de <literal>\Pagebreak</literal> (ce dernier n’est pas une -commande standard). La plupart des noms de commandes sont en bas de -casse, mais elles sont sensibles à la casse : vous devez toujours saisir -les commandes en respectant la casse où elles ont été définies. +commande standarde). La plupart des noms de commandes sont en bas de +casse, mais quoi qu’il en soit vous devez saisir toute commande en +respectant la casse dans laquelle elle est définie. </para> <para>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, <literal>{...}</literal>. Les -arguments optionnels sont entre crochets, <literal>[...]</literal>. En général -(mais ce n’est pas universel), si la commande prend un argument optionnel, +arguments optionnels sont entre crochets, <literal>[...]</literal>. 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. </para> <para>Au sein d’un argument optionnel, pour utiliser le crochet @@ -540,28 +600,15 @@ comportement dépend de la commande. pour les commandes dont il traite (à l’exception des omissions involontaires ou bogues de ce manuel). </para> -<!-- xxx Revoir le menu --> - - - -<sect2 label="2.4.1" id="Declaration"> -<title>Les déclarations de commandes</title> - -<para>Certaines commandes changent la valeur ou la signification d’une -autre commande ou d’un paramètre. Par exemple, la commande <literal>\mainmatter</literal> -change le réglage de la numérotation des pages en passant de chiffres -romains à des chiffres arabes. -</para> -</sect2> </sect1> <sect1 label="2.5" id="Environment"> <title>Les environnements</title> <para>Synopsis : </para> -<screen>\begin{<replaceable>nom environnement</replaceable>} +<screen>\begin{<replaceable>nom-environnement</replaceable>} ... -\end{<replaceable>nom environnement</replaceable>} +\end{<replaceable>nom-environnement</replaceable>} </screen> <para>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 @@ -572,10 +619,13 @@ les lignes entre <literal>\begin{verse}</literal> et <literal>\end{verse}</liter ... \end{verse} </screen> -<para>Voir <link linkend="Environments">Environments</link> pour une liste des environnements. +<para>Voir <link linkend="Environments">Environments</link>, pour une liste d’environnements. En +particulier, il est à noter que tout document &latex; doit avoir un +environnement <literal>document</literal> : une paire <literal>\begin{document} +... \end{document}</literal>. </para> -<para>Le <replaceable>nom environnement</replaceable> du début doit s’accorder exactement avec -celui de la fin. Cela vaut aussi dans le cas où <replaceable>nom environnement</replaceable> se +<para>Le <replaceable>nom-environnement</replaceable> du début doit s’accorder exactement avec +celui de la fin. Cela vaut aussi dans le cas où <replaceable>nom-environnement</replaceable> se termine par une étoile (<literal>*</literal>) ; l’argument à la fois de <literal>\begin</literal> et <literal>\end</literal> doit comprendre l’étoile. </para> @@ -649,7 +699,7 @@ fichier source &latex;. <indexterm role="fn"><primary>classe slides</primary></indexterm> <para>Les noms de <replaceable>classe</replaceable> de document incorporés à &latex;. (Beaucoup de classes de document sont disponibles dans des paquetages séparés ; -see <link linkend="Overview">Overview</link>.) +voir <link linkend="Overview">Overview</link>.) </para> <variablelist><varlistentry><term><literal>article</literal> </term><listitem><anchor id="document-classes-article"/><para>Pour un article de journal, une présentation, et diverses utilisations @@ -659,11 +709,11 @@ générales. </term><listitem><anchor id="document-classes-book"/> <para>Des livres complets, y compris des chapitres et possiblement incluant des pièces préliminaires telles qu’une préface, et postliminaires telles -qu’un appendice (see <link linkend="Front_002fback-matter">Front/back matter</link>). +qu’un appendice (voir <link linkend="Front_002fback-matter">Front/back matter</link>). </para> </listitem></varlistentry><varlistentry><term><literal>letter</literal> </term><listitem><anchor id="document-classes-letter"/><para>Courrier, incluant optionnellement des étiquettes pour enveloppes -(see <link linkend="Letters">Letters</link>). +(voir <link linkend="Letters">Letters</link>). </para> </listitem></varlistentry><varlistentry><term><literal>report</literal> </term><listitem><anchor id="document-classes-report"/><para>Pour des documents de longueur entre celle d’un <literal>article</literal> et celle @@ -673,7 +723,7 @@ peuvent contenir plusieurs chapitres. </listitem></varlistentry><varlistentry><term><literal>slides</literal> </term><listitem><anchor id="document-classes-slides"/><para>Pour des présentations de diapositive — rarement utilisé de nos jours. À sa place la classe <literal>beamer</literal> est sans doute celle dont l’usage est -le plus répendu (<ulink url="https://ctan.org/pkg/beamer">https://ctan.org/pkg/beamer</ulink>). See <link linkend="beamer-template">beamer +le plus répendu (<ulink url="https://ctan.org/pkg/beamer">https://ctan.org/pkg/beamer</ulink>). Voir <link linkend="beamer-template">beamer template</link>, pour un petit partron de document beamer. </para> </listitem></varlistentry></variablelist> @@ -738,7 +788,7 @@ taille du papier (ci-après hauteur sur largeur) : <indexterm role="fn"><primary>paquetage <literal>geometry</literal></primary></indexterm> <indexterm role="fn"><primary><literal>geometry</literal>, paquetage</primary></indexterm> <para>Lorsque on utilise l’un des moteurs pdf&latex;, -Lua&latex;, ou Xe&latex; (see <link linkend="TeX-engines">&tex; engines</link>), les options autres +Lua&latex;, ou Xe&latex; (voir <link linkend="TeX-engines">&tex; engines</link>), les options autres que <literal>letterpaper</literal> règlent la zone d’impression mais vous devez également régler la taille du papier physique. Un méthode pour faire cela est de placer <literal>\pdfpagewidth=\paperwidth</literal> et @@ -794,16 +844,12 @@ dépend de la classe. </term><listitem><indexterm role="fn"><primary>\evensidemargin</primary></indexterm> <indexterm role="fn"><primary>\oddsidemargin</primary></indexterm> <para>Sélectionne la disposition en recto simple ou recto-verso ; le défaut -est <literal>oneside</literal> pour recto, sauf pour la classe <literal>book</literal>. +est <literal>oneside</literal> pour recto simple, sauf pour la classe <literal>book</literal>. </para> <para>Le paramètre <literal>\evensidemargin</literal> (<literal>\oddsidemargin</literal>) 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, <literal>\oddsidemargin</literal> vaut 40% de la -différence entre <literal>\paperWidth</literal> et <literal>\textwidth</literal>, -<literal>\evensidemargin</literal> valant le reste. +distance sur les pages de numéro pair (impair) entre le côté gauche +de la page et la marge gauche du texte. Voir <link linkend="page-layout-parameters-oddsidemargin">page layout +parameters oddsidemargin</link>. </para> </listitem></varlistentry><varlistentry><term><literal>openright</literal> </term><term><literal>openany</literal> @@ -863,7 +909,7 @@ une classe. <para>Au sein d’un fichier classe ou paquetage on peut utiliser l’arobe <literal>@</literal> comme un caractère dans les noms de commande sans avoir à entourer le code contenant la commande en question par -<literal>\makeatletter</literal> et <literal>\makeatother</literal>. See <link linkend="_005cmakeatletter-_0026-_005cmakeatother">\makeatletter & +<literal>\makeatletter</literal> et <literal>\makeatother</literal>. Voir <link linkend="_005cmakeatletter-_0026-_005cmakeatother">\makeatletter & \makeatother</link>. Ceci permet de créer des commandes que les utilisateurs ne risquent pas de redéfinir accidentellement. Une autre technique est de préfixer les commandes spécifiques à une classe ou paquetage avec une @@ -966,7 +1012,7 @@ d’appel. Voir aussi <link linkend="_005cAtBeginDocument">\AtBeginDocument </term><listitem><indexterm role="fn"><primary>\CheckCommand</primary></indexterm> <indexterm role="fn"><primary>\CheckCommand*</primary></indexterm> <indexterm role="cp"><primary>nouvelle commande, vérification</primary></indexterm> -<para>Similaire à <literal>\newcommand</literal> (see <link linkend="_005cnewcommand-_0026-_005crenewcommand">\newcommand & \renewcommand</link>) +<para>Similaire à <literal>\newcommand</literal> (voir <link linkend="_005cnewcommand-_0026-_005crenewcommand">\newcommand & \renewcommand</link>) mais ne définit pas <replaceable>cmd</replaceable> ; à la place vérifie que la définition actuelle de <replaceable>cmd</replaceable> est exactement celle donnée par <replaceable>définition</replaceable> et est ou n’est pas <firstterm>longue</firstterm> selon ce que l’on attend. @@ -1044,7 +1090,7 @@ contenir <literal>\DeclareOption{logo}{<replaceable>code</replaceable>}</literal produit une avertissement semblable à <literal>Unused global option(s): [badoption].</literal> Vous pouvez changer ce comportement avec la version étoilée <literal>\DeclareOption*{<replaceable>code</replaceable>}</literal>. Par exemple, beaucoup de -classeq étendent une classe existante en utilisant une déclaration du +classeq étendent une classe existante en utilisant une commande du genre <literal>\LoadClass{article}</literal>, et pour passer les options suppémentaires à la classe sous-jascente utilisent un code tel que celui-ci : @@ -1069,9 +1115,9 @@ l’option à la classe <literal>article</literal>. <indexterm role="fn"><primary>\DeclareRobustCommand*</primary></indexterm> <indexterm role="cp"><primary>nouvelle commande, définition</primary></indexterm> <para>Similaire à <literal>\newcommand</literal> et <literal>\newcommand*</literal> -(see <link linkend="_005cnewcommand-_0026-_005crenewcommand">\newcommand & \renewcommand</link>) mais déclare une commande robuste, +(voir <link linkend="_005cnewcommand-_0026-_005crenewcommand">\newcommand & \renewcommand</link>) mais déclare une commande robuste, même si <replaceable>définition</replaceable> comprend du code fragile. (Pour une discussion -sur les commandes robustes et fragiles see <link linkend="_005cprotect">\protect</link>). Utilisez ces +sur les commandes robustes et fragiles voir <link linkend="_005cprotect">\protect</link>). Utilisez ces commande pour définir de nouvelles commandes robustes, ou redéfinir des commandes existantes en les rendant robustes. Contrairement à <literal>\newcommand</literal> elle ne produisent pas d’ereru si la macro <replaceable>cmd</replaceable> @@ -1337,7 +1383,7 @@ essai.cls</literal>’. </term><listitem><indexterm role="fn"><primary>\RequirePackage</primary></indexterm> <indexterm role="fn"><primary>\RequirePackageWithOptions</primary></indexterm> <para>Charge un paquetage, comme la commande <literal>\usepackage</literal> pour les -auteurs de documents. See <link linkend="Additional-packages">Additional packages</link>. Voici un exemple : +auteurs de documents. Voir <link linkend="Additional-packages">Additional packages</link>. Voici un exemple : <literal>\RequirePackage[landscape,margin=1in]{geometry}</literal>. Notez que l’équipe de développement de &latex; recommande fortement l’utilisation de ces commandes de préférence à l’<literal>\input</literal> de &tex; de base ; @@ -1389,15 +1435,21 @@ pour ce faire sont décrites ci-après. <para>Les commandes de styles suivantes sont prises en charge par &latex;. </para> -<para>Ce premier groupe de commandes est généralement utilisé avec un -argument, comme dans <literal>\textit{texte en italique}</literal>. 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. -</para> -<para>Ces commandes, à la fois dans la forme à argument et dans la forme -déclarative, sont cumulatives ; par exemple, vous pouvez dire aussi bien +<indexterm role="cp"><primary>forme déclarative des commandes de style de police</primary></indexterm> +<indexterm role="cp"><primary>déclarative, forme des commandes de style de police</primary></indexterm> +<para>Dans le tableau ci-dessous listant des commandes, les commandes en +<literal>\text…</literal> sont utilisées avec un argument, comme dans +<literal>\textit{texte}</literal>. C’est la forme préférée. Mais affichée à sa +suite, entre parenthèses, est la <firstterm>forme déclarative</firstterm> correspondante, +qui est souvant utile. Cette forme ne prend pas arguments comme dans +<literal>{\itshape <replaceable>texte</replaceable>}</literal>. La portée la forme déclarative s’étend +jusqu’à la prochaine commande de type style ou jusqu’à la fin du groupe +actuel. De plus, chacun a une forme par environnement comme +<literal>\begin{itshape}…\end{itshape}</literal>, que l’ont décrit plus +amplement à la fin de cette rubrique. +</para> +<para>Ces commandes, dans n’importe laquelle des trois formes, sont +cumulatives ; par exemple, vous pouvez dire aussi bien <literal>\sffamily\bfseries</literal> que <literal>\bfseries\sffamily</literal> pour obtenir du gras sans serif. </para> @@ -1507,15 +1559,16 @@ formules. <literal>\mathversion{normal}</literal> restaure la valeur par défaut <para>Enfin, la commande <literal>\oldstylenums{<replaceable>chiffres</replaceable>}</literal> 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 <literal>\textbf</literal> (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 <literal>textcomp</literal> doit être chargé, et parfois des -options de paquet sont mises à disposition pour en faire le style par -défaut. Entrée de FAQ : -<ulink url="http://www.tex.ac.uk/cgi-bin/texfaq2html?label=osf">http://www.tex.ac.uk/cgi-bin/texfaq2html?label=osf</ulink>. +profondeurs (et parfois largeurs) distincts de l’alignement standard des +chiffres qui ont tous la même hauteur que les lettres capitales. +Les polices &latex; par défaut prennent en charge cela, et respecteront +<literal>\textbf</literal> (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 <literal>textcomp</literal> doit être chargé, et parfois des options de +paquet sont mises à disposition pour en faire le style par défaut. +Entrée de FAQ : +<ulink url="https://www.texfaq.org/FAQ-osf">https://www.texfaq.org/FAQ-osf</ulink>. </para> <para>&latex; fournit également les commandes suivantes, qui font passer inconditionnellement à un style donné, c.-à-d. <emphasis>ne</emphasis> sont @@ -1566,12 +1619,12 @@ l’une avec l’autre. </para> </listitem></varlistentry></variablelist> <para>Certaines personnes considèrent que les commandes commutation -inconditionnelles de polices, comme <literal>\tt</literal>, sont obsolète et que +inconditionnelles de polices, comme <literal>\tt</literal>, sont obsolètes et que <emphasis>seulement</emphasis> les commandes cumulatives (<literal>\texttt</literal>) 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 +raisonnables quand un commutateur inconditionnel de police est précisément ce dont vous avez besoin pour obtenir le résultat souhaité ; -pour un exemple, see <link linkend="description"><literal>description</literal></link>. Les deux +pour un exemple, voir <link linkend="description"><literal>description</literal></link>. Les deux ensembles de commandes ont leur place. </para> </sect1> @@ -1585,7 +1638,7 @@ ensembles de commandes ont leur place. 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 ‘<literal>10pt</literal>’, ‘<literal>11pt</literal>’, et ‘<literal>12pt</literal>’ de classe de document, -respectivement (see <link linkend="Document-class-options">Document class options</link>). +respectivement (voir <link linkend="Document-class-options">Document class options</link>). </para> <indexterm role="fn"><primary>\tiny</primary></indexterm> <indexterm role="fn"><primary>\scriptsize</primary></indexterm> @@ -1623,8 +1676,9 @@ respectivement (see <link linkend="Document-class-options">Document class option </para></entry></row></tbody></tgroup></informaltable> <indexterm role="cp"><primary>déclarative, forme des commandes de contrôle de la taille de police</primary></indexterm> <indexterm role="cp"><primary>forme déclarative des commandes de contrôle de la taille de police</primary></indexterm> -<para>Les commandes énumérées ici sont des <firstterm>formes déclaratives</firstterm>. On est -utilise en les déclarant comme dans l’exemple qui suit : +<para>Les commandes énumérées ici sont des formes déclaratives (non des formes +par environnement), vu que c’est ainsi qu’on les utilise +typiquement. Comme dans l’exemple qui suit : </para> <screen>\begin{quotation} \small Le Tao que l'on peut nommer n'est pas le Tao. @@ -1636,7 +1690,7 @@ prochaine commande de style ou à la fin du groupe courant, de sorte qu’on aurait pu la mettre entre accolades <literal>{\small Ce texte est en petits caractères.}</literal>. </para> -<indexterm role="cp"><primary>forme par environnement des commandes</primary></indexterm> +<indexterm role="cp"><primary>forme par environnement des commandes de contrôle de la taille de police</primary></indexterm> <para>Une <firstterm>forme par environnement</firstterm> de chacune de ces commandes est également définie ; par exemple, <literal>\begin{tiny}...\end{tiny}</literal>. Toutefois, en pratique cette forme peut aisément mener à des espaces indésirables au @@ -1648,9 +1702,9 @@ forme déclarative. <literal>\begin</literal> et <literal>\end</literal>, presque toutes les commandes qui ne prennent pas d’argument on une forme par environnement. Mais dans presque tous les cas ce serait juste une source de confusion de -l’utiliser. La raison pour mentionner en particulier la forme par -environnement des déclarations de taille de police est que leur -utilisation s’avère assez courante, en dépit des problèmes qu’il pose). +l’utiliser. La raison pour mentionner spécifiquement la forme par +environnement des déclarations de taille de police est que cet usage +particulier n’est pas rare). </para> </sect1> <sect1 label="4.3" id="Low_002dlevel-font-commands"> @@ -1664,7 +1718,7 @@ de celles disponibles. <!-- xx but it should be complete --> <!-- xx something about ultimately reading ENCFAM.fd? --> </para> -<variablelist><varlistentry><term><literal>\fontencoding{codage}</literal> +<variablelist><anchor id="low-level-font-commands-fontencoding"/><varlistentry><term><literal>\fontencoding{codage}</literal> </term><listitem><indexterm role="fn"><primary>\fontencoding</primary></indexterm> <para>Sélectionne le codage de police, le codage de la police utilisée en sortie. Il y a un grand nombre de codages valides. Les plus usuels sont @@ -1677,7 +1731,7 @@ des mots contenant des lettres accentuées. Pour plus d’information, voir <ulink url="https://ctan.org/pkg/encguide">https://ctan.org/pkg/encguide</ulink>. </para> </listitem></varlistentry><varlistentry><term><literal>\fontfamily{<replaceable>famille</replaceable>}</literal> -</term><listitem><indexterm role="fn"><primary>\fontfamily</primary></indexterm> +</term><listitem><anchor id="low-level-font-commands-fontfamily"/><indexterm role="fn"><primary>\fontfamily</primary></indexterm> <indexterm role="cp"><primary>famille de polices</primary></indexterm> <indexterm role="cp"><primary>polices, catalogue</primary></indexterm> <para>Sélectionne la famille de polices. La page web @@ -1728,7 +1782,7 @@ usuelles : </para></entry><entry><para>Zapf Chancery </para></entry></row></tbody></tgroup></informaltable> </listitem></varlistentry><varlistentry><term><literal>\fontseries{<replaceable>série</replaceable>}</literal> -</term><listitem><indexterm role="fn"><primary>\fontseries</primary></indexterm> +</term><listitem><anchor id="low-level-font-commands-fontseries"/><indexterm role="fn"><primary>\fontseries</primary></indexterm> <indexterm role="cp"><primary>séries de polices</primary></indexterm> <para>Sélectionne une série de police. Une <firstterm>série</firstterm> combine une <firstterm>graisse</firstterm> et une <firstterm>largeur</firstterm>. Typiquement, une police prend en @@ -1800,7 +1854,7 @@ juste un (‘<literal><literal>m</literal></literal>’). </listitem></varlistentry><varlistentry><term><literal>\fontshape{<replaceable>allure</replaceable>}</literal> </term><listitem><indexterm role="fn"><primary>\fontshape</primary></indexterm> <indexterm role="cp"><primary>allure de police</primary></indexterm> -<para>Sélectionne l’allure de police. Les allures valides sont : +<anchor id="low-level-font-commands-fontshape"/><para>Sélectionne l’allure de police. Les allures valides sont : </para> <informaltable><tgroup cols="2"><colspec colwidth="2*"></colspec><colspec colwidth="19*"></colspec><tbody><row><entry><para><literal>n</literal> </para></entry><entry><para>Droit (normal) @@ -1821,7 +1875,7 @@ absentes. </para> </listitem></varlistentry><varlistentry><term><literal>\fontsize{<replaceable>taille</replaceable>}{<replaceable>interligne</replaceable>}</literal> -</term><listitem><indexterm role="fn"><primary>\fontsize</primary></indexterm> +</term><listitem><anchor id="low-level-font-commands-fontsize"/><indexterm role="fn"><primary>\fontsize</primary></indexterm> <indexterm role="fn"><primary>\baselineskip</primary></indexterm> <para>Réglage de la taille de police et de l’espacement d’interligne. L’unité des deux paramètres est par défaut le point (<literal>pt</literal>). L’espaceement @@ -1834,7 +1888,7 @@ valeur est réinitialisée à chaque fois qu’un changement de taille se produit ; voir ensuite <literal>\baselinestretch</literal>. </para> </listitem></varlistentry><varlistentry><term><literal>\baselinestretch</literal> -</term><listitem><indexterm role="fn"><primary>\baselinestretch</primary></indexterm> +</term><listitem><anchor id="low-level-font-commands-baselinestretch"/><indexterm role="fn"><primary>\baselinestretch</primary></indexterm> <para>L’espacement des lignes est également multiplié par la valeur du paramètre <literal>\baselinestretch</literal> ; la valeur par défaut est 1. Tout changement prend effet losque <literal>\selectfont</literal> (voir plus bas) est @@ -1854,7 +1908,7 @@ notes de bas de page et dans les légendes de figure. Voir la documentation du paquetage. </para> </listitem></varlistentry><varlistentry><term><literal>\linespread{<replaceable>facteur</replaceable>}</literal> -</term><listitem><indexterm role="fn"><primary>\linespread</primary></indexterm> +</term><listitem><anchor id="low-level-font-commands-linespread"/><indexterm role="fn"><primary>\linespread</primary></indexterm> <para>Est équivalent à <literal>\renewcommand{\baselinestretch}{<replaceable>facteur</replaceable>}</literal>, et doit donc être suivie par <literal>\selectfont</literal> pour avoir un effet. Il vaut mieux @@ -1862,7 +1916,7 @@ que ce soit dans le préambule, ou utiliser le paquetage <literal>setspace</lite comme on vient de le décrire. </para> </listitem></varlistentry><varlistentry><term><literal>\selectfont</literal> -</term><listitem><indexterm role="fn"><primary>\selectfont</primary></indexterm> +</term><listitem><anchor id="low-level-font-commands-selectfont"/><indexterm role="fn"><primary>\selectfont</primary></indexterm> <para>Les modifications apportées en appelant les commandes de polices décrites ci-dessus n’entrent en vigueur qu’après que <literal>\selectfont</literal> est appelé, comme dans @@ -1870,11 +1924,11 @@ est appelé, comme dans il est plus pratique de mettre cela dans une macro : <literal>\newcommand*{\mapolice}{\fontfamily{<replaceable>nomfamille</replaceable>}\selectfont}</literal> -(see <link linkend="_005cnewcommand-_0026-_005crenewcommand">\newcommand & \renewcommand</link>). +(voir <link linkend="_005cnewcommand-_0026-_005crenewcommand">\newcommand & \renewcommand</link>). </para> </listitem></varlistentry><varlistentry><term><literal>\usefont{<replaceable>codage</replaceable>}{<replaceable>famille</replaceable>}{<replaceable>série</replaceable>}{<replaceable>allure</replaceable>}</literal> -</term><listitem><indexterm role="fn"><primary>\usefont</primary></indexterm> +</term><listitem><anchor id="low-level-font-commands-usefont"/><indexterm role="fn"><primary>\usefont</primary></indexterm> <para>Revient à la même chose que d’invoquer <literal>\fontencoding</literal>, <literal>\fontfamily</literal>, <literal>\fontseries</literal> et <literal>\fontshape</literal> avec les paramètres donnés, suivi par <literal>\selectfont</literal>. Par exemple : @@ -1910,54 +1964,119 @@ une sortie à colonne unique. C’est la valeur par défaut. <para>Synopsis : </para> -<screen>\twocolumn [<replaceable>texte1col</replaceable>] +<screen>\twocolumn [<replaceable>texte1col préliminaire</replaceable>] </screen> -<para>La déclaration <literal>\twocolumn</literal> commence une nouvelle page et produit -sortie à deux colonnes. Si l’argument optionnel <replaceable>texte1col</replaceable> est -présent, il est composée dans le mode à une colonne avant que la -composition à deux colonnes ne commence. +<para>Commence une nouvelle page et produit une sortie en deux colonnes. Si on +a passé l’option de classe <literal>twocolumn</literal> au document alors c’est le +comportement par défaut (voir <link linkend="Document-class-options">Document class options</link>). Cette commande +est fragile (voir <link linkend="_005cprotect">\protect</link>). </para> -<para>Les paramètres ci-après contrôlent la composition de la production de deux +<para>Si l’argument optionnel <replaceable>texte1col préliminaire</replaceable> est présent, il est +composé dans le mode à une colonne avant que la composition à deux +colonnes ne commence. +</para> +<para>Les paramètres ci-après contrôlent la composition de la sortie en deux colonnes : </para> <variablelist><varlistentry><term><indexterm role="fn"><primary>\columnsep</primary></indexterm><literal>\columnsep</literal> -</term><listitem><para>La distance entre les colonnes (35pt par défaut). +</term><listitem><anchor id="twocolumn-columnsep"/><para>La distance entre les colonnes. Vaut 35pt par défaut. Changer la valeur +avec une commande telle que +<literal>\setlength{\columnsep}{40pt}</literal>. Vous devez faire le changement +avant que le mode en deux colonnes ne commence ; le préambule est +une bonne place pour le faire. </para> </listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\columnseprule</primary></indexterm><literal>\columnseprule</literal> -</term><listitem><para>La largeur du filet entre les colonnes ; la valeur par défaut est 0pt, -de sorte qu’il n’y a pas de filet. +</term><listitem><anchor id="twocolumn-columnseprule"/><para>La largeur du filet entre les colonnes. La valeur par défaut est 0pt, de +sorte qu’il n’y a pas de filet. Autrement, le filet apparaît à mi-chemin +entre les deux colonnes. Changez la valeur avec une commande telle que +<literal>\setlength{\columnseprule}{0.4pt}</literal>, avant que le mode en deux +colonnes ne commence. </para> </listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\columnwidth</primary></indexterm><literal>\columnwidth</literal> -</term><listitem><para>La largeur de la colonne en cours ; il est égal à <literal>\textwidth</literal> dans -le cas d’un texte composé en une seule colonne. +</term><listitem><anchor id="twocolumn-columnwidth"/><para>La largeur d’une colonnne. En mode à une colonne ceci vaut +<literal>\textwidth</literal>. En mode à deux colonnes par défaut &latex; règle la +largeur de chacune des deux colonnes, <literal>\columnwidth</literal>, à la moitié +de <literal>\textwidth</literal> moins <literal>\columnsep</literal>. </para> </listitem></varlistentry></variablelist> -<para>Les paramètres ci-après contrôlent le comportement des flottants en cas de production -à deux colonnes : +<para>Dans un document en deux colonnes, les environnements étoilés +<literal>table*</literal> et <literal>figure*</literal> s’étendent en largeur sur deux colonnes, +alors que les environnements non étoilés <literal>table</literal> et <literal>figure</literal> +n’occupe qu’une colonne (voir <link linkend="figure">figure</link> et voir <link linkend="table">table</link>). &latex; +place les flottants étoilés au somme d’une page. +Les paramètres ci-après contrôlent le comportement des flottants en cas +de sortie à deux colonnes : </para> <variablelist><varlistentry><term><indexterm role="fn"><primary>\dbltopfraction</primary></indexterm><literal>\dbltopfraction</literal> -</term><listitem><para>Fraction maximale au sommet d’une page sur deux colonnes qui peut être -occupée par des flottants. Par défaut vaut ‘<literal>0,7</literal>’, peut être -utilement redéfini en (par exemple) ‘<literal>0,9</literal>’ pour aller moins tôt sur -des pages de flottants. +</term><listitem><anchor id="twocolumn-dbltopfraction"/><para>Fraction maximale au sommet d’une page sur deux colonnes qui peut être +occupée par des flottants s’étendant sur deux colonnes en largeur. Par +défaut vaut 0,7, ce qui signifie que la hauteur d’un environnement +<literal>table*</literal> ou <literal>figure*</literal> ne doit pas excéder +<literal>0.7\textheight</literal>. Si la hauteur de vos environnement flottant +excède cela alors vous pouvez prendre l’une des actions suivante pour +l’empêcher de flotter jusqu’à la fin du document : +</para> +<itemizedlist><listitem><para>– Utiliser le spécificateur de localisation <literal>[tp]</literal> pour dire à +&latex; d’essayer de placer le flottant volumineux sur une page dédiée, +ou de même au sommet d’une page. +</para> +</listitem><listitem><para>– Utiliser le spécificateur de localisation <literal>[t!]</literal> pour l’emporter +sur l’effet de <literal>\dbltopfraction</literal> pour ce flottant en particulier. +</para> +</listitem><listitem><para>– Augmenter la valeur de <literal>\dbltopfraction</literal> à un nombre de grandeur +adéquate, pour éviter de faire flotter les pages si tôt. +</para></listitem></itemizedlist> + +<para>Vous pouvez le redéfinir, comme dans +<literal>\renewcommand{\dbltopfraction}{0.9}</literal>. </para> </listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\dblfloatpagefraction</primary></indexterm><literal>\dblfloatpagefraction</literal> -</term><listitem><para>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 -‘<literal>0,5</literal>’. +</term><listitem><anchor id="twocolumn-dblfloatpagefraction"/><para>Pour une page de flottants s’étendant sur deux colonnes en largeur, +c’est la fraction minimum de la page qui doit être occupée par les +flottants. La valeur par défaut de &latex; est ‘<literal>0.5</literal>’. Se change +avec <literal>\renewcommand</literal>. </para> </listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\dblfloatsep</primary></indexterm><literal>\dblfloatsep</literal> -</term><listitem><para>Distance entre les flottants en haut ou en bas d’une page de flottants à -deux colonnes. Par défaut vaut ‘<literal>12pt plus2pt minus2pt</literal>’ pour des +</term><listitem><anchor id="twocolumn-dblfloatsep"/><para>Sur une page de flottants s’étendant sur deux colonnes en largeur, cette +longueur est la distance entre les flottants à la fois en haut et en bas +de la page. Par défaut vaut ‘<literal>12pt plus2pt minus2pt</literal>’ pour des documents en ‘<literal>10pt</literal>’ ou ‘<literal>11pt</literal>’, et ‘<literal>14pt plus2pt minus4pt</literal>’ pour ‘<literal>12pt</literal>’. </para> </listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\dbltextfloatsep</primary></indexterm><literal>\dbltextfloatsep</literal> -</term><listitem><para>Distance entre un flottant multi-colonnes en haut ou en bas d’une page -et le texte principal. Par défaut vaut ‘<literal>20pt plus2pt minus4pt</literal>’ . +</term><listitem><anchor id="twocolumn-dbltextfloatsep"/><para>Cette longueur est la distance entre un flottant multi-colonnes en haut +ou en bas d’une page et le texte principal. Par défaut vaut ‘<literal>20pt +plus2pt minus4pt</literal>’. +</para> +</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\dbltopnumber</primary></indexterm><literal>\dbltopnumber</literal> +</term><listitem><anchor id="twocolumn-dbltopnumber"/><para>Sur une page de flottant avec des flottants large de deux colonnes, ce +compteur donne le nombre maximal de flottants autorisé au sommet de la +page. La valeur par défaut de &latex; est <literal>2</literal>. +</para></listitem></varlistentry></variablelist> +<!-- From egreg at http://tex.stackexchange.com/a/142232/339 --> +<para>L’exemple suivant utilise l’argument optionnel de <literal>\twocolumn</literal> pour +crée un titre s’étendant sur les deux colonnes du document article : </para> -</listitem></varlistentry></variablelist> +<screen>\documentclass[twocolumn]{article} +\newcommand{\authormark}[1]{\textsuperscript{#1}} +\begin{document} +\twocolumn[{% au sein de cet argument optionnel, du texte en une colonne + \centering + \LARGE Le titre \\[1.5em] + \large Auteur Un\authormark{1}, + Auteur Deux\authormark{2}, + Auteur Trois\authormark{1} \\[1em] + \normalsize + \begin{tabular}{p{.2\textwidth}@{\hspace{2em}}p{.2\textwidth}} + \authormark{1}Departement Un &\authormark{2}Department Deux \\ + École Un &École Deux + \end{tabular}\\[3em] % espace sous la partie titre + }] + +Le texte en deux colonnes est ici. +</screen> + </sect1> <sect1 label="5.3" id="_005cflushbottom"> <title><literal>\flushbottom</literal></title> @@ -1969,7 +2088,8 @@ même hauteur, en ajoutant de k’espace vertical supplémentaire si nécessaire pour remplir le page. </para> <para>C’est la valeur par défaut si le mode <literal>twocolumn</literal> est sélectionné -(see <link linkend="Document-class-options">Document class options</link>). +(voir <link linkend="Document-class-options">Document class options</link>). Cette command est fragile +(voir <link linkend="_005cprotect">\protect</link>). </para> </sect1> <sect1 label="5.4" id="_005craggedbottom"> @@ -1991,91 +2111,219 @@ ne seront étirée. <indexterm role="cp"><primary>mise en page, les paramètres de</primary></indexterm> <indexterm role="cp"><primary>en-tête, des paramètres pour</primary></indexterm> <indexterm role="cp"><primary>bas de page, des paramètres pour</primary></indexterm> -<indexterm role="cp"><primary>en-tête et pied de page en cours de traitement</primary></indexterm> +<indexterm role="cp"><primary>en-tête et pied de page en cours</primary></indexterm> -<variablelist><varlistentry><term><indexterm role="fn"><primary>\headheight</primary></indexterm><literal>\headheight</literal> -</term><listitem><para>Hauteur de la boîte qui contient la tête en cours de traitement. La -valeur par défaut est ‘<literal>30pt</literal>’, sauf dans la classe <literal>book</literal>, où -elle varie en fonction de la taille de la police. +<variablelist><varlistentry><term><indexterm role="fn"><primary>\columnsep</primary></indexterm><literal>\columnsep</literal> +</term><term><indexterm role="fn"><primary>\columnseprule</primary></indexterm><literal>\columnseprule</literal> +</term><term><indexterm role="fn"><primary>\columnwidth</primary></indexterm><literal>\columnwidth</literal> +</term><listitem><indexterm role="fn"><primary>\columnsep</primary></indexterm> +<indexterm role="fn"><primary>\columnseprule</primary></indexterm> +<indexterm role="fn"><primary>\columnwidth</primary></indexterm> +<anchor id="page-layout-parameters-columnsep"/><anchor id="page-layout-parameters-columnseprule"/><anchor id="page-layout-parameters-columnwidth"/><para>La distance entre les deux colonnes, la largeur d’un filet entre les +colonnes, et la largeur des colonnes, lorsque l’option de classe de +document <literal>twocolumn</literal> est en vigueur (voir <link linkend="Document-class-options">Document class +options</link>). Voir <link linkend="_005ctwocolumn">\twocolumn</link>. +</para> +</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\headheight</primary></indexterm><literal>\headheight</literal> +</term><listitem><indexterm role="fn"><primary>\headheight</primary></indexterm> +<anchor id="page-layout-parameters-headheight"/><para>Hauteur de la boîte qui contient l’en-tête de page en cours. La valeur +par défaut pour les classes <literal>article</literal>, <literal>report</literal>, et +<literal>book</literal> est ‘<literal>12pt</literal>’ quelle que soit la taille de la police. </para> </listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\headsep</primary></indexterm><literal>\headsep</literal> -</term><listitem><para>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 ‘<literal>25pt</literal>’, -sauf dans la classe <literal>book</literal>, où elle varie avec la taille de -la police. +</term><listitem><indexterm role="fn"><primary>\headsep</primary></indexterm> +<anchor id="page-layout-parameters-headsep"/><para>La distance verticale entre le bas de la ligne d’en-tête et le haut du +texte principal. La valeur par défaut est ‘<literal>25pt</literal>’. Dans la classe +<literal>book</literal> la valeur par défaut est ‘<literal>0.25in</literal>’ pour un document +réglé en 10pt, et ‘<literal>0.275in</literal>’ pour un document en 11pt ou 12pt. </para> </listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\footskip</primary></indexterm><literal>\footskip</literal> -</term><listitem><para>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 ‘<literal>30pt</literal>’, sauf dans la -classe <literal>book</literal> où elle varie avec la taille de la police. +</term><listitem><indexterm role="fn"><primary>\footskip</primary></indexterm> +<anchor id="page-layout-parameters-footskip"/><para>Distance de la ligne de base de la dernière ligne de texte à la ligne de +base du pied de page. La valeur par défaut dans les classe +<literal>article</literal> et <literal>report</literal> est ‘<literal>30pt</literal>’. Dans la classe +<literal>book</literal> la valeur par défaut est ‘<literal>0.35in</literal>’ pour les documents +réglés en 10pt, ‘<literal>0.38in</literal>’ en 11pt, et ‘<literal>30pt</literal>’ en 12pt. </para> </listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\linewidth</primary></indexterm><literal>\linewidth</literal> -</term><listitem><para>Largeur de la ligne actuelle, diminuée pour chaque <literal>list</literal> imbriquée -(see <link linkend="list">list</link>). Plus précisément, elle est inférieure à -<literal>\textwidth</literal> par la somme de <literal>\leftmargin</literal> et -<literal>\rightmargin</literal> (see <link linkend="itemize">itemize</link>). La valeur par défaut varie en -fonction de la taille de la police, la largeur du papier, le mode à deux -colonnes, etc. Pour un document de classe <literal>article</literal> en taille de -police ‘<literal>10pt</literal>’, elle vaut ‘<literal>345pt</literal>’ ; dans le mode à deux -colonnes, elle passe à ‘<literal>229.5pt</literal>’. -</para> -</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\textheight</primary></indexterm><literal>\textheight</literal> -</term><listitem><para>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 <literal>article</literal> ou <literal>report</literal> en -taille de police ‘<literal>10pt</literal>’, elle vaut ‘<literal>43\baselineskip</literal>’ ; pour -une classe <literal>book</literal>, elle vaut ‘<literal>41\baselineskip</literal>’. Pour -‘<literal>11pt</literal>’, c’est ‘<literal>38\baselineskip</literal>’ et pour ‘<literal>12pt</literal>’ c’est -‘<literal>36\baselineskip</literal>’. -</para> +</term><listitem><indexterm role="fn"><primary>\linewidth</primary></indexterm> +<anchor id="page-layout-parameters-linewidth"/><para>Largeur de la ligne actuelle, diminuée pour chaque <literal>list</literal> imbriquée +(voir <link linkend="list">list</link>). C-à-d. que la valeur nominale <literal>\linewidth</literal> vaut +<literal>\textwidth</literal> mais que pour chaque liste imbriquée la largeur +<literal>\linewidth</literal> est diminuée de la somme de <literal>\leftmargin</literal> et +<literal>\rightmargin</literal> pour cette liste (voir <link linkend="itemize">itemize</link>). +<!-- La valeur par défaut varie en fonction de la taille de la police, la --> +<!-- largeur du papier, le mode à deux colonnes, etc. Pour un document de --> +<!-- classe @code{article} en taille de police @samp{10pt}, elle vaut --> +<!-- @samp{345pt} ; dans le mode à deux colonnes, elle passe à --> +<!-- @samp{229.5pt}. --> +</para> +</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\marginparpush</primary></indexterm><literal>\marginparpush</literal> +</term><term><indexterm role="fn"><primary>\marginsep</primary></indexterm><literal>\marginsep</literal> +</term><term><indexterm role="fn"><primary>\marginparwidth</primary></indexterm><literal>\marginparwidth</literal> +</term><listitem><indexterm role="fn"><primary>\marginparpush</primary></indexterm> +<indexterm role="fn"><primary>\marginsep</primary></indexterm> +<indexterm role="fn"><primary>\marginparwidth</primary></indexterm> +<anchor id="page-layout-parameters-marginparpush"/><anchor id="page-layout-parameters-marginsep"/><anchor id="page-layout-parameters-marginparwidth"/><para>L’espace vertical miniminal entre deux notes marginales, l’espace +horizontal entre le corps du texte et les notes marginales, et la largeur +horizontale des notes. +</para> +<para>Normalement les notes en marginales apparaissent à l’extérieur de la +page, mais la déclaration <literal>\reversemarginpar</literal> change cela (et +<literal>\normalmarginpar</literal> le rétablit). +</para> +<para>La valeur par défaut pour <literal>\marginparpush</literal> à la fois dans un +document de classe <literal>book</literal> ou <literal>article</literal> est : ‘<literal>7pt</literal>’ si le +document est réglé à 12pt, et ‘<literal>5pt</literal>’ s’il l’est à 11pt ou 10pt. +</para> +<para>Pour <literal>\marginsep</literal>, dans la classe <literal>article</literal> la valeur par +défaut est ‘<literal>10pt</literal>’ sauf si le document est réglé à 10pt et en mode en +deux colonne où la valeur par défaut est ‘<literal>11pt</literal>’. +</para> +<para>Pour <literal>\marginsep</literal> dans la classe <literal>book</literal> la valeur par défaut +est ‘<literal>10pt</literal>’ en mode deux colonnes, et ‘<literal>7pt</literal>’ en mode +mono-colonne. +</para> +<para>Pour <literal>\marginparwidth</literal> aussi bien dans les classes <literal>book</literal> que +<literal>article</literal>, en mode à deux colonnes la valeur par défaut est 60% ou +<literal>\paperwidth − \textwidth</literal>, alors qu’en mode monocolonne +c’est 50% de cette distance. +</para> +</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\oddsidemargin</primary></indexterm><literal>\oddsidemargin</literal> +</term><term><indexterm role="fn"><primary>\evensidemargin</primary></indexterm><literal>\evensidemargin</literal> +</term><listitem><indexterm role="fn"><primary>\oddsidemargin</primary></indexterm> +<indexterm role="fn"><primary>\evensidemargin</primary></indexterm> +<anchor id="page-layout-parameters-oddsidemargin"/><anchor id="page-layout-parameters-evensidemargin"/><indexterm role="cp"><primary>marge gauche</primary></indexterm> +<para>La <firstterm>marge gauche</firstterm> est la bande entre le bord gauche de la page et le +corps du texte. +</para> +<indexterm role="cp"><primary>marge gauche nominale</primary></indexterm> +<para>La <firstterm>marge gauche nominale</firstterm> est la marge gauche lorsque les +paramètres <literal>\oddsidemargin</literal> et <literal>\eventsidemargin</literal> sont à +‘<literal>0pt</literal>’. Sa frontière est une ligne verticale imaginaire située +à une distance de <literal>1in + \hoffset</literal> du bord gauche de la page en +allant vers le côté droit. La longueur <literal>\hoffset</literal> vaut <literal>0pt</literal>, +ce paramètre est obsolète il servait dans les années 1980, quand le +système &tex; a été conçu, à rattraper les défauts des imprimantes de +l’époque dont le placement horizontal de la page par rapport à la +feuille de papier pouvait se dérégler. +</para> +<para>La longueur <literal>\oddsidemargin</literal> est la distance entre le bord gauche +du texte et la frontière de la marge gauche nominale pour les pages de +numéro impair dans les documents en recto-verso, et pour toutes les +pages sinon pour les document en recto simple. La longueur +<literal>\evensidemargin</literal> est la distance entre le bord gauche du texte et +la frontière de la marge gauche nominale pour les pages de numéro pair +dans les documents en recto-verso. +</para> +<para>En d’autres termes <literal>\oddsidemargin</literal> ou <literal>\evensidemargin</literal> +donnent la différence entre la largeur de la marge gauche réel et la +marge gauche nominale. Ces distances <literal>\oddsidemargin</literal> et +<literal>\evensidemargin</literal> sont donc signées vers le coté droit, c’est à +dire qu’une valeur positive indique que la marge gauche réelle est plus +large que la marge gauche nominale, alors qu’une valeur négative indique +qu’au contraire elle est plus étroite. +</para> +<para>Dans une document en recto-verso le <firstterm>côté intérieur</firstterm> de la page est +le côté gauche pour les pages de numéro impair, et le côté droit pour +les page de numéro pair. Le <firstterm>côté extérieur</firstterm> est le côté opposé au +côté intérieur : la longueur <literal>\oddsidemargin</literal> règle donc la +position de la marge intérieure des pages de numéro impair, alors que +<literal>\evensidemargin</literal> règle la position la marge extérieur des pages de +numéro pair. +</para> +<para>Pour une marge intérieure de 4cm dans un document en recto-verso, mettre +le code suivant dans le préambule : +</para> +<screen>\evensidemargin\dimexpr\paperwidth-\textwidth-1in-4cm +\oddsidemargin\dimexpr4cm-1in +</screen> +<para>Vice-versa, pour une marge extérieure de 5cm dans un document en +recto-verso, mettre le code suivant dans le préambule : +</para> +<screen>\evensidemargin\dimexpr5cm-1in +\oddsidemargin\dimexpr\paperwidth-\textwidth-1in-5cm +</screen> </listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\paperheight</primary></indexterm><literal>\paperheight</literal> -</term><listitem><para>La hauteur du papier, à ne pas confondre avec la hauteur de la zone +</term><listitem><anchor id="page-layout-parameters-paperheight"/><para>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 <literal>\documentclass[a4paper]{article}</literal> -(see <link linkend="Document-class-options">Options de classe de document</link>). +(voir <link linkend="Document-class-options">Options de classe de document</link>). </para> </listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\paperwidth</primary></indexterm><literal>\paperwidth</literal> -</term><listitem><para>La largeur du papier, à ne pas confondre avec la largeur de la zone +</term><listitem><anchor id="page-layout-parameters-paperwidth"/><para>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 <literal>\documentclass[a4paper]{article}</literal> -(see <link linkend="Document-class-options">Options de classe de document</link>). +(voir <link linkend="Document-class-options">Options de classe de document</link>). +</para> +</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\textheight</primary></indexterm><literal>\textheight</literal> +</term><listitem><anchor id="page-layout-parameters-textheight"/><para>La hauteur verticale normale du corps de la page. Si le document réglé à +une taille de police nominale de 10pt, alors pour un document de classe +<literal>article</literal> ou <literal>report</literal>, elle vaut ‘<literal>43\baselineskip</literal>’ ; pour +une classe <literal>book</literal>, elle vaut ‘<literal>41\baselineskip</literal>’. Pour 11pt, +c’est ‘<literal>38\baselineskip</literal>’ pour toutes les classes de document. Pour +‘<literal>12pt</literal>’ c’est ‘<literal>36\baselineskip</literal>’ pour toutes les classes aussi. </para> </listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\textwidth</primary></indexterm><literal>\textwidth</literal> -</term><listitem><para>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 -<literal>article</literal> ou <literal>report</literal>, elle vaut ‘<literal>345pt</literal>’ à ‘<literal>10pt</literal>’ de -taille de police, ‘<literal>360pt</literal>’ à ‘<literal>11pt</literal>’, et ‘<literal>390pt</literal>’ à -‘<literal>12pt</literal>’. Pour un document <literal>book</literal>, elle veut ‘<literal>4.5in</literal>’ à -‘<literal>10pt</literal>’ et ‘<literal>5in</literal>’ à ‘<literal>11pt</literal>’ ou ‘<literal>12pt</literal>’. +</term><listitem><anchor id="page-layout-parameters-textwidth"/><para>La largeur horizontale totale de l’ensemble du corps de la page. Pour un +document de classe <literal>article</literal> ou <literal>report</literal>, elle vaut +‘<literal>345pt</literal>’ à 10pt de taille de police, ‘<literal>360pt</literal>’ à +11pt, et ‘<literal>390pt</literal>’ à 12pt. Pour un document +<literal>book</literal>, elle veut ‘<literal>4.5in</literal>’ à 10pt et ‘<literal>5in</literal>’ à +11pt ou 12pt. </para> <para>En sortie multi-colonne, <literal>\textwidth</literal> reste de la largeur de tout le corps de la page, tandis que <literal>\columnwidth</literal> est la largeur d’une -colonne (see <link linkend="_005ctwocolumn">\twocolumn</link>). +colonne (voir <link linkend="_005ctwocolumn">\twocolumn</link>). </para> -<para>Dans les listes (see <link linkend="list">list</link>), <literal>\textwidth</literal> est le reste la -largeur du corps corps de la page entière (et <literal>\columnwidth</literal> est la -largeur d’une colonne entière), alors que <literal>\linewidth</literal> peut -diminuer au sein de listes imbriquées. +<para>Dans les listes (voir <link linkend="list">list</link>), <literal>\textwidth</literal> demeure la largeur du +corps de la page entière (et <literal>\columnwidth</literal> est la largeur d’une +colonne entière), alors que <literal>\linewidth</literal> peut diminuer au sein de +listes imbriquées. </para> -<para>À l’intérieur d’une minipage (see <link linkend="minipage">minipage</link> ) ou <literal>\parbox</literal> -(see <link linkend="_005cparbox">\parbox</link>), tous les paramètres liés à la largeur sont mis à la +<para>À l’intérieur d’une minipage (voir <link linkend="minipage">minipage</link> ) ou <literal>\parbox</literal> +(voir <link linkend="_005cparbox">\parbox</link>), tous les paramètres liés à la largeur sont mis à la largeur spécifiée, et de reviennent à leurs valeurs normales à la fin du <literal>minipage</literal> ou <literal>\parbox</literal>. </para> -<indexterm role="fn"><primary>\hsize</primary></indexterm> -<para>Par souci d’exhaustivité : <literal>\hsize</literal> est le paramètre &tex; +</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\hsize</primary></indexterm><literal>\hsize</literal> +</term><listitem><indexterm role="fn"><primary>\hsize</primary></indexterm> +<anchor id="page-layout-parameters-hsize"/><para>Par souci d’exhaustivité : <literal>\hsize</literal> 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. </para> </listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\topmargin</primary></indexterm><literal>\topmargin</literal> -</term><listitem><para>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 : -<literal>\paperheight − 2in − \headheight − \headsep -− \textheight − \footskip</literal>, et ensuite divisé par deux. +</term><listitem><indexterm role="fn"><primary>topmargin</primary></indexterm> +<anchor id="page-layout-parameters-topmargin"/><indexterm role="cp"><primary>marge supérieure</primary></indexterm> +<para>La <firstterm>marge supérieure</firstterm> est la bande entre le bord supérieur de la page et le +bord supérieure de l’en-tête de page. +</para> +<indexterm role="cp"><primary>marge supérieure nominale</primary></indexterm> +<para>La <firstterm>marge supérieure nominale</firstterm> est la marge supérieur lorsque +<literal>\topmargin</literal> vaut ‘<literal>0pt</literal>’. Sa frontière est une ligne +horizontale imaginaire située à une distance de <literal>1in + \voffset</literal> du +bord supérieur de la page en allant vers le bas. La longueur +<literal>\voffset</literal> vaut <literal>0pt</literal>, ce paramètre est obsolète il servait +dans les années 1980, quand le système &tex; a été conçu, à rattraper +les défauts des imprimantes de l’époque dont le placement vertical de la +page par rapport à la feuille de papier pouvait se dérégler. +</para> +<para>La distance <literal>\topmargin</literal> sépare le haut de l’en-tête de page de la +frontière de la marge supérieure nominale. Elle est signée vers le bas, +c’est à dire que quand <literal>\topmargin</literal> est positif la marge supérieure +est plus large que la marge supérieure nominale, et que s’il est négatif +elle est au contraire plus étroite. En d’autres termes <literal>\topmargin</literal> +est la différence entre la largeur de la marge supérieure réelle et la +marge supérieure nominale. +</para> +<para>L’espace le haut de la page &tex; et le haut du corps de texte est +<literal>1in + \voffset + \topmargin + \headheight + \headsep</literal>. La marge +inférieure vaut donc <literal>\paperheight -\textheight -\footskip - 1in - +\voffset - \topmargin - \headheight - \headsep</literal>. </para> </listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\topskip</primary></indexterm><literal>\topskip</literal> -</term><listitem><para>La distance minimale entre le sommet du corps de la page et la ligne de base de +</term><listitem><indexterm role="fn"><primary>\topskip</primary></indexterm> +<anchor id="page-layout-parameters-topskip"/><para>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, ‘<literal>10pt</literal>’ à ‘<literal>10pt</literal>’. </para> @@ -2090,8 +2338,8 @@ composés en dehors du flux normal du texte, par exemple flottant au sommet d’une page ultérieure </para> <para>&latex; sait gérer plusieurs classes de matériel flottant. Il y a deux -classes définies par défaut, <literal>figure</literal> (see <link linkend="figure">figure</link>) et -<literal>table</literal> (see <link linkend="table">table</link>), mais vous pouvez créer une nouvelle +classes définies par défaut, <literal>figure</literal> (voir <link linkend="figure">figure</link>) et +<literal>table</literal> (voir <link linkend="table">table</link>), mais vous pouvez créer une nouvelle classes avec le paquetage <filename>float</filename>. </para> <para>Au sein d’une même classe flottante &latex; respecte l’ordre, de sorte @@ -2333,7 +2581,7 @@ qui imprime <replaceable>titre</replaceable> comme d’habitude mais sans le fabriquer une entrée dans la table des matières. Un exemple d’utilisation est pour un appendice dans un <literal>article</literal>. Entrer le code <literal>\appendix\section{Appendice}</literal> donne en sortie ‘<literal>A -Appendix</literal>’ (see <link linkend="_005cappendix">\appendix</link>). Vous pouvez ôter le numéro ‘<literal>A</literal>’ en +Appendix</literal>’ (voir <link linkend="_005cappendix">\appendix</link>). Vous pouvez ôter le numéro ‘<literal>A</literal>’ en entrant à la place <literal>\section*{Appendice}</literal> (les articles omettent couramment d’avoir une table des matières et ont des en-têtes de pages simples alors les autres différences de la commande <literal>\section</literal> @@ -2341,7 +2589,7 @@ peuvent être négligées). </para> <para>Le titre <replaceable>titre</replaceable> fournit la rubrique en tant que titre dans le texte principal, mais il peut également apparaître dans la table des matières -et le haut et le bas de bage (see <link linkend="Page-styles">Page styles</link>). Vous pourriez +et le haut et le bas de bage (voir <link linkend="Page-styles">Page styles</link>). Vous pourriez désirer un texte différent à ces endroits que dans le texte principal. Toute ces commandes ont un argument optionnel <replaceable>tdm-titre</replaceable> destiné à ces autres endroits. @@ -2351,10 +2599,10 @@ table ci-dessus détermine quelles rubriques sont numérotées, et lesquelles apparaissent dans la table des matières. Si le <replaceable>niveau</replaceable> de la commande de rubricage est inférieur ou égal à la valeur du compteur <literal>secnumdepth</literal> alors les rubriques correspondant à ces -commandes de rubricage sont numérotées (see <link linkend="Sectioning_002fsecnumdepth">Sectioning/secnumdepth</link>). +commandes de rubricage sont numérotées (voir <link linkend="Sectioning_002fsecnumdepth">Sectioning/secnumdepth</link>). Et, si <replaceable>niveau</replaceable> est inférieur ou égal à la valeur du compteur <literal>tocdepth</literal> alors la table des matières comprend une entrée pour -cette rubrique (see <link linkend="Sectioning_002ftocdepth">Sectioning/tocdepth</link>). +cette rubrique (voir <link linkend="Sectioning_002ftocdepth">Sectioning/tocdepth</link>). </para> <para>&latex; s’attend que avant d’avoir une <literal>\subsection</literal> vous ayez une <literal>\section</literal> et, dans un document de classe <literal>book</literal>, qu’avant @@ -2369,7 +2617,7 @@ cette rubrique (see <link linkend="Sectioning_002ftocdepth">Sectioning/tocdepth< simple de ceci est que vous pouvez mettre le numéro de rubrique de type section en lettres majuscules avec <literal>\renewcommand\thesection{\Alph{section}}</literal> dans le préambule -(see <link linkend="_005calph-_005cAlph-_005carabic-_005croman-_005cRoman-_005cfnsymbol">\alph \Alph \arabic \roman \Roman \fnsymbol</link>). Le CTAN a +(voir <link linkend="_005calph-_005cAlph-_005carabic-_005croman-_005cRoman-_005cfnsymbol">\alph \Alph \arabic \roman \Roman \fnsymbol</link>). Le CTAN a beaucoup de paquetages rendant ce genre d’ajustement plus facile, notamment <filename>titlesec</filename>. </para> @@ -2383,7 +2631,7 @@ par les commandes de rubricage. numérotés. Régler le compteur avec <literal>\setcounter{secnumdepth}{<replaceable>niveau</replaceable>}</literal> supprime la numérotation des rubriques à toute profondeur supérieure à <replaceable>niveau</replaceable> -(See <link linkend="_005csetcounter">\setcounter</link>). Voir la table plus haut pour la valeur des +(voir <link linkend="_005csetcounter">\setcounter</link>). Voir la table plus haut pour la valeur des niveaux. Par exemple, si le <literal>secnumdepth</literal> vaut 1 dans un <literal>article</literal> alors la commande <literal>\section{Introduction}</literal> produit en sortie quelque-chose comme ‘<literal>1 Introduction</literal>’ alors que @@ -2398,7 +2646,7 @@ classes <filename>book</filename> et <filename>report</filename>. <anchor id="sectioning-tocdepth"/><anchor id="Sectioning_002ftocdepth"/><para>Contrôle quelles rubriques sont listées dans la table des matières. Régler <literal>\setcounter{tocdepth}{<replaceable>niveau</replaceable>}</literal> a pour effet que les rubriques au niveau <replaceable>niveau</replaceable> sont celles de plus petit niveau à -être listées (see <link linkend="_005csetcounter">\setcounter</link>). Voir la table ci-dessus pour les +être listées (voir <link linkend="_005csetcounter">\setcounter</link>). Voir la table ci-dessus pour les numéros de niveau. Par exemple, if <literal>tocdepth</literal> vaut 1 alors la table des matières contiendra les rubriques issues de <literal>\section</literal>, mais pas celles de <literal>\subsection</literal>. La valeur par défaut de &latex; pour @@ -2454,8 +2702,8 @@ partie, et n’incrémente pas le compteur <literal>part</literal>, et ne pr aucune entrée dans la table des matières. </para> <para>L’argument optionnel <replaceable>tdm-titre</replaceable> apparaît comme le titre de la -partie dans la table des matières (see <link linkend="Table-of-contents-etc_002e">Table of contents etc.</link>) et -dans les hauts de pages (see <link linkend="Page-styles">Page styles</link>). S’il n’est pas présent +partie dans la table des matières (voir <link linkend="Table-of-contents-etc_002e">Table of contents etc.</link>) et +dans les hauts de pages (voir <link linkend="Page-styles">Page styles</link>). S’il n’est pas présent alors <replaceable>titre</replaceable> est utilisé à sa place. Dans l’exemple suivante on met un saut de ligne dans <replaceable>titre</replaceable> mais on l’enlève dans la table des matière. @@ -2464,8 +2712,8 @@ matière. </screen> <para>Pour déterminer quelles rubrique sont numéroté et lesquelles apparaissent dans la table des matières, le numéro de niveau d’une -partie vaut -1 (see <link linkend="Sectioning_002fsecnumdepth">Sectioning/secnumdepth</link> et -see <link linkend="Sectioning_002ftocdepth">Sectioning/tocdepth</link>). +partie vaut -1 (voir <link linkend="Sectioning_002fsecnumdepth">Sectioning/secnumdepth</link> et +voir <link linkend="Sectioning_002ftocdepth">Sectioning/tocdepth</link>). </para> <indexterm role="fn"><primary>paquetage <literal>indentfirst</literal></primary></indexterm> <indexterm role="fn"><primary><literal>indentfirst</literal>, paquetage</primary></indexterm> @@ -2512,8 +2760,8 @@ recto-verso. Il produit un numéro de chapitre tel que ‘<literal>Chapitre en gros caractère gras (la taille est <literal>\huge</literal>). Ensuite il place le <replaceable>titre</replaceable> sur une nouvelle ligne, en caractère gras encore plus gros (taille <literal>\Huge</literal>). Il incrémente également le compteur -<literal>chapter</literal>, ajoute une entrée à la table des matières (see <link linkend="Table-of-contents-etc_002e">Table -of contents etc.</link>), et règle l’information de haut de page (see <link linkend="Page-styles">Page +<literal>chapter</literal>, ajoute une entrée à la table des matières (voir <link linkend="Table-of-contents-etc_002e">Table +of contents etc.</link>), et règle l’information de haut de page (voir <link linkend="Page-styles">Page styles</link>). </para> <para>La forme étoilée, ou forme en <literal>*</literal>, affiche <replaceable>titre</replaceable> sur une @@ -2527,8 +2775,8 @@ précédent). Voici un exemple illustrant cela : <screen>\chapter*{Préambule} </screen> <para>L’argument optionnel <replaceable>tdm-titre</replaceable> apparaît comme titre de chapitre -dans la tabvle des matières (see <link linkend="Table-of-contents-etc_002e">Table of contents etc.</link>) et dans les -hauts de page (see <link linkend="Page-styles">Page styles</link>). Si il n’est pas présent alors +dans la tabvle des matières (voir <link linkend="Table-of-contents-etc_002e">Table of contents etc.</link>) et dans les +hauts de page (voir <link linkend="Page-styles">Page styles</link>). Si il n’est pas présent alors <replaceable>titre</replaceable> sera à la place. L’exemple suivant montre le nom complet dans le titre de chapitre, </para> @@ -2543,8 +2791,8 @@ matières </screen> <para>Pour déterminer quelles rubriques sont numérotées et lesquelles apparaissent dans la table des matières, le numéro de niveau d’un -chapitre est 0 (see <link linkend="Sectioning_002fsecnumdepth">Sectioning/secnumdepth</link> et -see <link linkend="Sectioning_002ftocdepth">Sectioning/tocdepth</link>). +chapitre est 0 (voir <link linkend="Sectioning_002fsecnumdepth">Sectioning/secnumdepth</link> et +voir <link linkend="Sectioning_002ftocdepth">Sectioning/tocdepth</link>). </para> <indexterm role="fn"><primary>paquetage <literal>indentfirst</literal></primary></indexterm> <indexterm role="fn"><primary><literal>indentfirst</literal>, paquetage</primary></indexterm> @@ -2570,7 +2818,7 @@ utilisez le paquetage <filename>indentfirst</filename>. <para>Vous pouvez changer ce qui est affiché pour le numéro de chapitre. Pour le changer en quelque-chose du genre de ‘<literal>Cours 1</literal>’, placez dans le préambule soit <literal>\renewcommand{\chaptername}{Cours}</literal>, soit -cela (see <link linkend="_005cmakeatletter-_0026-_005cmakeatother">\makeatletter & \makeatother</link>) : +cela (voir <link linkend="_005cmakeatletter-_0026-_005cmakeatother">\makeatletter & \makeatother</link>) : </para> <screen>\makeatletter \renewcommand{\@chapapp}{Cours} @@ -2652,8 +2900,8 @@ un document recto-verso, alors le titre de haut de page sera celui de la rubrique précédente). </para> <para>L’argument optionnel <replaceable>tdm-titre</replaceable> apparaît comme titre de section -dans la table des matières (see <link linkend="Table-of-contents-etc_002e">Table of contents etc.</link>) et dans les -titres de haut de page (see <link linkend="Page-styles">Page styles</link>). S’il n’est pas présent +dans la table des matières (voir <link linkend="Table-of-contents-etc_002e">Table of contents etc.</link>) et dans les +titres de haut de page (voir <link linkend="Page-styles">Page styles</link>). S’il n’est pas présent alors <replaceable>titre</replaceable> est à la place. L’exemple suivant montre le nom complet dans le titre de la section, </para> @@ -2672,8 +2920,8 @@ c'est que j'ai menti\\ histoire de ma vie} </screen> <para>Pour déterminer quelles rubriques sont numérotées et lesquelles apparaissent dans la table des matières, le numéro de niveau d’une -section est 1 (see <link linkend="Sectioning_002fsecnumdepth">Sectioning/secnumdepth</link> et -see <link linkend="Sectioning_002ftocdepth">Sectioning/tocdepth</link>). +section est 1 (voir <link linkend="Sectioning_002fsecnumdepth">Sectioning/secnumdepth</link> et +voir <link linkend="Sectioning_002ftocdepth">Sectioning/tocdepth</link>). </para> <indexterm role="fn"><primary>paquetage <literal>indentfirst</literal></primary></indexterm> <indexterm role="fn"><primary><literal>indentfirst</literal>, paquetage</primary></indexterm> @@ -2701,7 +2949,7 @@ utilisez le paquetage <filename>indentfirst</filename>. <para>En général, pour changer le comportement de la commande <literal>\section</literal>, il y a diverses options. L’une d’elles et la commande -<literal>\@startsection</literal> (see <link linkend="_005c_0040startsection">\@startsection</link>). Il y a aussi un grand +<literal>\@startsection</literal> (voir <link linkend="_005c_0040startsection">\@startsection</link>). Il y a aussi un grand nombre de paquetages sur le CTAN traitant de cela, dont <filename>titlesec</filename>. Voir sa documentation, mais l’exemple ci-dessous donne un aperçu de ce qu’il @@ -2759,7 +3007,7 @@ et ne produit aucune entrée dans la table des matières. </para> <!-- continuer la trad. --> <para>L’argument optionnel <replaceable>tdm-titre</replaceable> apparaît comme le titre de -sous-section dans la table des matières (see <link linkend="Table-of-contents-etc_002e">Table of contents +sous-section dans la table des matières (voir <link linkend="Table-of-contents-etc_002e">Table of contents etc.</link>). S’il n’est pas présent alors <replaceable>titre</replaceable> est à la place. L’exemple suivant montre le texte complet dans le titre de sous-section, </para> @@ -2771,8 +3019,8 @@ paper</literal>’ dans la table des matières. </para> <para>Pour déterminer quelles rubriques sont numérotées et lesquelles apparaissent dans la table des matières, le numéro de niveau d’une -sous-section est 2 (see <link linkend="Sectioning_002fsecnumdepth">Sectioning/secnumdepth</link> et -see <link linkend="Sectioning_002ftocdepth">Sectioning/tocdepth</link>). +sous-section est 2 (voir <link linkend="Sectioning_002fsecnumdepth">Sectioning/secnumdepth</link> et +voir <link linkend="Sectioning_002ftocdepth">Sectioning/tocdepth</link>). </para> <indexterm role="fn"><primary>paquetage <literal>indentfirst</literal></primary></indexterm> <indexterm role="fn"><primary><literal>indentfirst</literal>, paquetage</primary></indexterm> @@ -2801,7 +3049,7 @@ utilisez le paquetage <filename>indentfirst</filename>. <!-- --> <para>Il y a diverses façon de changer le comportement de la commande <literal>\subsection</literal>. L’une d’elles et la commande <literal>\@startsection</literal> -(see <link linkend="_005c_0040startsection">\@startsection</link>). Il y a aussi divers paquetages sur le CTAN +(voir <link linkend="_005c_0040startsection">\@startsection</link>). Il y a aussi divers paquetages sur le CTAN traitant de cela, dont <filename>titlesec</filename>. Voir sa documentation, mais l’exemple ci-dessous donne un aperçu de ce qu’il peut faire. </para> @@ -2877,14 +3125,14 @@ compteur associé et ne produit pas d’entrée dans la table des matières (et le titre produit pas <literal>\subsubsection</literal> n’a pas de numéro). </para> <para>L’argument optionnel <replaceable>titre-tdm</replaceable> apparaît comme le titre de la -rubrique dans la table des matières (see <link linkend="Table-of-contents-etc_002e">Table of contents etc.</link>). +rubrique dans la table des matières (voir <link linkend="Table-of-contents-etc_002e">Table of contents etc.</link>). S’il est omis, alors <replaceable>titre</replaceable> est utilisé à la place. </para> <para>Pour déterminer quelles rubriques sont numérotées et lesquelles apparaissent dans la table des matières, le numéro de nuveau d’une sous-sous-section est 3, celui d’un paragraphe est 4, et celui d’un -sous-paragraphe est 5 (see <link linkend="Sectioning_002fsecnumdepth">Sectioning/secnumdepth</link> et -see <link linkend="Sectioning_002ftocdepth">Sectioning/tocdepth</link>). +sous-paragraphe est 5 (voir <link linkend="Sectioning_002fsecnumdepth">Sectioning/secnumdepth</link> et +voir <link linkend="Sectioning_002ftocdepth">Sectioning/tocdepth</link>). </para> <indexterm role="fn"><primary>paquetage <literal>indentfirst</literal></primary></indexterm> <indexterm role="fn"><primary><literal>indentfirst</literal>, paquetage</primary></indexterm> @@ -2912,7 +3160,7 @@ est d’utiliser le paquetage <filename>indentfirst</filename>. <para>Il y a de nombreuses manières de changer le comportement de ces commandes. L’une est la commande <literal>\@startsection</literal> -(see <link linkend="_005c_0040startsection">\@startsection</link>). Il y a aussi un grand nombre de paquetages +(voir <link linkend="_005c_0040startsection">\@startsection</link>). Il y a aussi un grand nombre de paquetages sur le CTAN traitant de cela, dont <filename>titlesec</filename>. Voir sa documentation sur le CTAN. </para> @@ -2948,7 +3196,7 @@ document <literal>book</literal> ou <literal>report</literal> cela déclare que </screen> <para>les deux premières commandes produisent en sortie ‘<literal>Chapitre 1</literal>’ and ‘<literal>Chapitre 2</literal>’. Après la commande <literal>\appendix</literal> la numérotation devient -‘<literal>Annexe A</literal>’ et ‘<literal>Annexe B</literal>’. See <link linkend="Larger-book-template">Larger book template</link> +‘<literal>Annexe A</literal>’ et ‘<literal>Annexe B</literal>’. Voir <link linkend="Larger-book-template">Larger book template</link> pour un autre exemple. </para> <indexterm role="fn"><primary>paquetage <literal>appendix</literal></primary></indexterm> @@ -2969,20 +3217,27 @@ a plusieurs autres fonctions. Voir la documentation sur le CTAN. <indexterm role="fn"><primary>\frontmatter</primary></indexterm> <indexterm role="cp"><primary>book, pièces préliminaires</primary></indexterm> <indexterm role="cp"><primary>livre, pièces préliminaires</primary></indexterm> +<indexterm role="cp"><primary>pièces préliminaires d’un livre</primary></indexterm> <indexterm role="fn"><primary>\mainmatter</primary></indexterm> <indexterm role="cp"><primary>book, pièces principales</primary></indexterm> <indexterm role="cp"><primary>livre, pièces principales</primary></indexterm> +<indexterm role="cp"><primary>pièces principales d’un livre</primary></indexterm> <indexterm role="fn"><primary>\backmatter</primary></indexterm> <indexterm role="cp"><primary>book, pièces postliminaires</primary></indexterm> <indexterm role="cp"><primary>book, annexes</primary></indexterm> <indexterm role="cp"><primary>livre, pièces postliminaires</primary></indexterm> <indexterm role="cp"><primary>livre, annexes</primary></indexterm> +<indexterm role="cp"><primary>pièces postliminaires d’un livre</primary></indexterm> +<indexterm role="cp"><primary>annexes d’un livre</primary></indexterm> -<para>Synopsis, l’un parmi : +<para>Synopsis, l’un ou plus parmi : </para> <screen>\frontmatter +… \mainmatter +… \backmatter +… </screen> <para>Formate un document de classe <literal>book</literal> différemment selon la partie du document en cours de production. Les trois commandes sont toutes @@ -2997,16 +3252,20 @@ pas numérotée). Les pièces postliminaires (<literal>\backmatter</literal>) pe contenir des choses telles qu’un glossaire, une bibliographie, et un index. </para> -<para>La déclaration <literal>\frontmatter</literal> rend les numéros de page en chiffres +<para>La commande <literal>\frontmatter</literal> rend les numéros de page en chiffres romains bas de casse, et rend les chapitres non numérotés, bien que les titres de chaque chapitre apparaissent dans la table des matières ; si vous utilisez là aussi d’autres commandes de rubricage, alors utilisez -la version en <literal>*</literal> (see <link linkend="Sectioning">Sectioning</link>). La commande -<literal>\mainmatter</literal> permet de revenir au comportement attendu, et -réinitialise le numéro de page. La commande <literal>\backmatter</literal> -n’affecte pas la numérotation des pages, mais commute de nouveau les -chapitres en mode sans numéros. See <link linkend="Larger-book-template">Larger book template</link> pour un -exemple d’usage des trois commandes. +la version en <literal>*</literal> (voir <link linkend="Sectioning">Sectioning</link>). +</para> +<para>La commande <literal>\mainmatter</literal> permet de revenir au comportement +attendu, et réinitialise le numéro de page. +</para> +<para>La commande <literal>\backmatter</literal> n’affecte pas la numérotation des pages, +mais commute de nouveau les chapitres en mode sans numéros. +</para> +<para>Voir <link linkend="Larger-book-template">Larger book template</link>, pour un exemple d’usage de ces trois +commandes. </para> </sect1> @@ -3050,7 +3309,7 @@ d’utiliser la commande <literal>\secdef</literal>. </screen><para>redéfinit <literal>\section</literal> en gardant sa forme standarde d’appel <literal>\section*[<replaceable>titretdm</replaceable>]{<replaceable>titre</replaceable>}</literal> (dans laquelle on rappelle que l’étoile <literal>*</literal> est optionnelle). -See <link linkend="Sectioning">Sectioning</link>. Ceci implique que quand vous écrivez une commande +Voir <link linkend="Sectioning">Sectioning</link>. Ceci implique que quand vous écrivez une commande comme <literal>\renewcommand{\section}{...}</literal>, le <literal>\@startsection{...}</literal> doit venir en dernier dans la définition. Voir les exemples ci-dessous. @@ -3070,12 +3329,12 @@ troisième exemple plus bas. </para> </listitem></varlistentry><varlistentry><term><replaceable>niveau</replaceable> </term><listitem><anchor id="startsection-level"/><anchor id="_005c_0040startsection_002flevel"/><para>Entier donnant la profondeur de la commande de -rubricage. See <link linkend="Sectioning">Sectioning</link> pour une liste des numéros standards de +rubricage. Voir <link linkend="Sectioning">Sectioning</link> pour une liste des numéros standards de niveaux. </para> <para>Si <replaceable>niveau</replaceable> est inférieur ou égal à la valeur du compteur <literal>secnumdepth</literal>, alors les titres pour cette commande de rubricage -sont numérotés (see <link linkend="Sectioning_002fsecnumdepth">Sectioning/secnumdepth</link>). Par exemple : dans un +sont numérotés (voir <link linkend="Sectioning_002fsecnumdepth">Sectioning/secnumdepth</link>). Par exemple : dans un <literal>article</literal>, si <literal>secnumdepth</literal> vaut 1, alors une commande <literal>\section{Introduction}</literal> produira en sortie une chaîne du type « <literal>1 Introduction</literal> », alors que <literal>\subsection{Historique}</literal> @@ -3112,7 +3371,7 @@ fois la hauteur d’une lettre x en espace vertical, et le premier paragraphe de la rubrique n’est pas renfoncé. Utiliser une longueur élastique, c.-à-d. comprenant <literal>plus</literal> et <literal>minus</literal>, est une bonne pratique ici car cela donne à &latex; plus de latitude lors de la -fabrication de la page (see <link linkend="Lengths">Lengths</link>). +fabrication de la page (voir <link linkend="Lengths">Lengths</link>). </para> <para>La quantité totale d’espace vertical entre la ligne de base de la ligne précédant cette rubrique et la ligne de base du titre de la rubrique est @@ -3162,27 +3421,30 @@ des titres gras et en capitales. <para>Voici les réglages par défaut de &latex; pour les trois premiers niveaux de rubricage qui sont définis par <literal>\@startsection</literal>, pour les classes <filename>article</filename>, <filename>book</filename>, et <filename>report</filename>. -</para><itemizedlist><listitem><para>Pour section, le <replaceable>niveau</replaceable> vaut 1, le <replaceable>retrait</replaceable> vaut 0pt, +</para> +<itemizedlist><listitem><para>Pour <literal>section</literal> : le <replaceable>niveau</replaceable> vaut 1, le <replaceable>retrait</replaceable> vaut 0pt, le <replaceable>avant</replaceable> vaut <literal>-3.5ex plus -1ex minus -0.2ex</literal>, le <replaceable>après</replaceable> vaut <literal>2.3ex plus 0.2ex</literal>, et le <replaceable>style</replaceable> vaut <literal>\normalfont\Large\bfseries</literal>. -</para></listitem><listitem><para>Pour subsection, le <replaceable>niveau</replaceable> +</para> +</listitem><listitem><para>Pour <literal>subsection</literal> : le <replaceable>niveau</replaceable> vaut 2, le <replaceable>retrait</replaceable> vaut 0pt, le <replaceable>avant</replaceable> vaut <literal>-3.25ex plus -1ex minus -0.2ex</literal>, le <replaceable>après</replaceable> vaut <literal>1.5ex plus 0.2ex</literal>, et le <replaceable>style</replaceable> vaut <literal>\normalfont\large\bfseries</literal>. -</para></listitem><listitem><para>Pour subsubsection, le <replaceable>niveau</replaceable> vaut 3, le <replaceable>retrait</replaceable> vaut +</para> +</listitem><listitem><para>Pour <literal>subsubsection</literal> : le <replaceable>niveau</replaceable> vaut 3, le <replaceable>retrait</replaceable> vaut 0pt, le <replaceable>avant</replaceable> vaut <literal>-3.25ex plus -1ex minus -0.2ex</literal>, le <replaceable>après</replaceable> vaut <literal>1.5ex plus 0.2ex</literal>, et le <replaceable>style</replaceable> vaut <literal>\normalfont\normalsize\bfseries</literal>. </para></listitem></itemizedlist> -<para>Voici des exemples. Pour les utiliser, mettez-les soit au sein d’un -fichier de paquetage ou de classe, soit dans le préambule d’un document +<para>Quelques exemples suivent. Ils vont soit au sein d’un fichier de +paquetage ou de classe, soit dans le préambule d’un document &latex;. Si vous les mettez dans le préambule, elle doivent être entre une commande <literal>\makeatletter</literal> et une commande <literal>\makeatother</literal>. (Le message d’erreur <literal>You can't use `\spacefactor' in vertical mode.</literal> est le plus probable lorsque on oublie de faire -cela). See <link linkend="_005cmakeatletter-_0026-_005cmakeatother">\makeatletter & \makeatother</link>. +cela). Voir <link linkend="_005cmakeatletter-_0026-_005cmakeatother">\makeatletter & \makeatother</link>. </para> <para>L’exemple ci-dessous centre les titres de section et les met en gros caractères gras. Il le fait avec <literal>\renewcommand</literal> parce que les @@ -3313,7 +3575,7 @@ de la rubrique courante. Au sein d’un environnement numéroté, tel que l’environnement <literal>table</literal> ou <literal>theorem</literal>, <literal>\label{<replaceable>clef</replaceable>}</literal> attribue le numéro de cet environnement à <replaceable>clef</replaceable>. On retire le numéro attribué avec la commande -<literal>\ref{<replaceable>clef</replaceable>}</literal> (see <link linkend="_005cref">\ref</link>). +<literal>\ref{<replaceable>clef</replaceable>}</literal> (voir <link linkend="_005cref">\ref</link>). </para> <para>Le nom <replaceable>clef</replaceable> peut se composer de n’importe quelle séquence de lettres, chiffres, ou caractères de ponctuation ordinaires. Il est @@ -3395,7 +3657,7 @@ page~\pageref{eq:principale}. <screen>\ref{<replaceable>clef</replaceable>} </screen> <para>Produit le numéro de la rubrique, équation, note en bas de page, figure, -…, de la commande correspondante <literal>\label</literal> (see <link linkend="_005clabel">\label</link>). +…, de la commande correspondante <literal>\label</literal> (voir <link linkend="_005clabel">\label</link>). Elle ne produit aucun texte, tel que le mot ‘<literal>Section</literal>’ ou ‘<literal>Figure</literal>’, juste le numéro lui-même sans plus. </para> @@ -3403,7 +3665,7 @@ Elle ne produit aucun texte, tel que le mot ‘<literal>Section</literal> que ceci est une référence déclarée en aval puisque elle est faite avant <literal>\label{populaire}</literal>. </para> -<screen>Le format utilisé le plus largement est à l'item item numéro~\ref{populaire}. +<screen>Le format utilisé le plus largement est à l'item numéro~\ref{populaire}. \begin{enumerate} \item Plain \TeX \item \label{populaire} \LaTeX @@ -3444,12 +3706,12 @@ Chaque environnement commence et se termine de la même manière : </screen> <para>Produit un résumé, potentiellement contenant plusieurs paragraphes. Cet environnement n’est défini que dans les classes de document -<literal>article</literal> et <literal>report</literal> (see <link linkend="Document-classes">Document classes</link>). +<literal>article</literal> et <literal>report</literal> (voir <link linkend="Document-classes">Document classes</link>). </para> <para>Utiliser l’exemple ci-dessous au sein de la classe <literal>article</literal> produit un paragraphe détaché. L’option <literal>titlepage</literal> de la classe de document a pour effet que le résumé soit sur une page séparée -(see <link linkend="Document-class-options">Document class options</link>) ; ceci est le comportement par défaut +(voir <link linkend="Document-class-options">Document class options</link>) ; ceci est le comportement par défaut selement dans la classe <literal>report</literal>. </para> <screen>\begin{abstract} @@ -3509,15 +3771,31 @@ en deux-colonne (pour plus solution plus flexible, utilisez le paquetage </screen> <para>Les tableaux mathématiques sont produits avec l’environnement <literal>array</literal>, normalement au sein d’un environnement <literal>equation</literal> -(see <link linkend="equation">equation</link>). Les entrées dans chaque colonne sont séparées avec +(voir <link linkend="equation">equation</link>). Les entrées dans chaque colonne sont séparées avec une esperluette (<literal>&</literal>). Les lignes sont terminées par une double -contr’oblique (see <link linkend="_005c_005c">\\</link>). +contr’oblique (voir <link linkend="_005c_005c">\\</link>). </para> +<para>L’exemple suivant affiche un tableau trois par trois. +</para> +<screen>\begin{equation*} + \chi(x) = + \left| % barre verticale en bordure + \begin{array}{ccc} + x-a &-b &-c \\ + -d &x-e &-f \\ + -g &-h &x-i + \end{array} + \right| +\end{equation*} +</screen> <para>L’argument obligatoire <replaceable>patron</replaceable> décrit le nombre de colonnes, l’alignement en leur sein, et le formatage des régions -inter-colonne. Voir <link linkend="tabular">tabular</link> pour une description complete de +inter-colonne. Par exemple, +<literal>\begin{array}{rcl}...\end{array}</literal> produit trois colonnes : +la première fer à droite, la deuxième centrée, et la troisière fer à +gauche. Voir <link linkend="tabular">tabular</link> pour une description complète de <replaceable>patron</replaceable>, et des autres caractéristiques communes aux deux -environnement, y compris l’argument optionnel <literal>pos</literal>. +environnements, y compris l’argument optionnel <literal>pos</literal>. </para> <para>L’environnement <literal>array</literal> diverge de <literal>tabular</literal> par deux aspect. Le premier est que les entrée de <literal>array</literal> sont composées en @@ -3621,17 +3899,52 @@ preambule : <replaceable>line2</replaceable> \\ \end{center} </screen> -<indexterm role="fn"><primary>\\ (pour <literal>center</literal>)</primary></indexterm> <para>L’environnement <literal>center</literal> 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 -<literal>\\</literal>. +consistant de lignes qui sont centrées entre les marges de gauche et de +droite de la page courante. On utilise une double contr’oblique, +<literal>\\</literal>, pour obtenir un saut de ligne (voir <link linkend="_005c_005c">\\</link>). +<indexterm role="fn"><primary>\\ (pour <literal>center</literal>)</primary></indexterm> +Si du texte est trop long pour entrer dans une ligne, alors &latex; +insère des sauts de ligne en évitant de faire des césures ou de dilater +ou contracter tout espace inter-mot. +</para> +<para>Cet environnement insert de l’espace au-dessus et en-dessou le corps du +texte. Voir <link linkend="_005ccentering">\centering</link> pour ne pas avoir cet espace, par exemple +au sein d’un environnement <literal>figure</literal>. +</para> +<para>L’exemple suivant produit trois ligne centrées. Il y a un espace +vertical supplementaire entre les deux dernière lignes. +</para> +<screen>\begin{center} + Une thèse soumise en remplissant partiellement \\ + les exigences de \\[0.5ex] + l'École pour l'Ingénierie Environnementale +\end{center} +</screen> +<para>Dans l’exemple suivant, selon la largeur de la ligne de la page, +&latex; pourrait faire un saut de ligne pour la partie avant la double +contr’oblique. SIf so, it will center each of the two lines and if not +it will center the single line. Then &latex; will break at the double +backslash, and will center the ending. +</para> +<screen>\begin{center} + Mon père considérait comme intolérable quiconque fréquentait l'église mais ne buvait pas d'alcool.\\ + J'ai grandi dans cette croyance. --- Richard Burton +\end{center} +</screen> +<para>Ajouter une double contr’oblique à la fin de la ligne finale est +optionnel. Lorsque elle est présente, cela n’ajoute pas d’espace +vertical. +</para> +<para>Dans un document en double-colonne le texte est centré dans une colonne, +et non sur la page entière. </para> <sect2 label="8.3.1" id="_005ccentering"> <title><literal>\centering</literal></title> +<!-- xx Revoir la trad. --> <indexterm role="fn"><primary>\centering</primary></indexterm> <indexterm role="cp"><primary>centrer du texte, déclaration pour</primary></indexterm> @@ -3666,7 +3979,7 @@ second line \\ <indexterm role="fn"><primary>environnement <literal>description</literal></primary></indexterm> <indexterm role="fn"><primary><literal>description</literal>, environnement</primary></indexterm> -<indexterm role="cp"><primary>lists étiquetée, créer</primary></indexterm> +<indexterm role="cp"><primary>listes étiquetées, créer</primary></indexterm> <indexterm role="cp"><primary>listes de description, créer</primary></indexterm> <para>Synopsis : @@ -3681,21 +3994,23 @@ second line \\ <para>L’environnement <literal>description</literal> est utilisé pour fabriquer des listes d’articles étiquetés. Chaque <replaceable>étiquette</replaceable> d’article est composée en gras, alignée à gauche de sorte que les étiquettes longues continuent -sur la première lgne du texte de l’article. Il doit y avoir au moins un -article ; sans cela provoque l’erreur &latex; ‘<literal>Something's +sur la première ligne du texte de l’article. Il doit y avoir au moins un +article ; sans cela on provoque l’erreur &latex; ‘<literal>Something's wrong--perhaps a missing \item</literal>’. </para> <para>Cet exemple montre l’environnement utilisé pour une séquence de -définitions. Les étiquettes ‘<literal>lama</literal>’ et ‘<literal>llama</literal>’ ressortent en -gras avec leur bords gauches alignés sur la marge de gauche. +définitions. </para> <screen>\begin{definition} \item[lama] Un prêtre. \item[lame] Une pièce coupante. </screen> +<para>Les étiquettes ‘<literal>lama</literal>’ et ‘<literal>llama</literal>’ ressortent en gras avec leur +bords gauches alignés sur la marge de gauche. +</para> <indexterm role="fn"><primary>\item</primary></indexterm> <para>Faites démarrer la liste d’articles avec la commande <literal>\item</literal> -(see <link linkend="_005citem">\item</link>). Utilisez l’étiquette optionnelle, comme dans +(voir <link linkend="_005citem">\item</link>). Utilisez l’étiquette optionnelle, comme dans <literal>\item[Point principal]</literal>, en effet il n’y a pas de valeur par défaut sensée. Après le <literal>\item</literal> se trouve du texte optionnel pouvant contenir plusieurs paragraphes. @@ -3753,7 +4068,7 @@ justifie les équations à gauche ; voir <link linkend="Document-class-options" </para> <para>Aucun numéro d’équation n’est ajouté au texte de texte <literal>displaymath</literal> ; pour obtenir un numéro d’équation, vous pouvez -utiliser l’environnement <literal>equation</literal> (see <link linkend="equation">equation</link>). +utiliser l’environnement <literal>equation</literal> (voir <link linkend="equation">equation</link>). </para> <para>&latex; ne fait pas de saut de ligne au sein de <replaceable>des maths</replaceable>. </para> @@ -3779,7 +4094,7 @@ est plus probable que le mot <literal>displaymath</literal> soit unique. language &tex; de base est souvent utilisée à tort comme un synonyme de <literal>displaymath</literal>. Elle n’en est pas un, et n’est pas du tout officiellement prise en charge par &latex; ; <literal>$$</literal> ne prend pas en -charge <literal>fleqn</literal> (see <link linkend="Document-class-options">Document class options</link>), gère l’espacement +charge <literal>fleqn</literal> (voir <link linkend="Document-class-options">Document class options</link>), gère l’espacement verticial environment différemment, et n’effectue pas de vérification de cohérence). </para> @@ -3799,7 +4114,7 @@ ligne <literal>\( \int_1^2 x^2\,dx=7/3 \)</literal> produit. <para>L’environnement <literal>document</literal> entoure le corps entier d’un document. -Il est obligatoire dans tout document &latex;. See <link linkend="Starting-and-ending">Starting and +Il est obligatoire dans tout document &latex;. Voir <link linkend="Starting-and-ending">Starting and ending</link>. </para> @@ -3879,8 +4194,8 @@ marathon olympique de 1908 : <para>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 <literal>itemize</literal> (see <link linkend="itemize">itemize</link>) et <literal>description</literal> -(see <link linkend="description">description</link>). +tels que <literal>itemize</literal> (voir <link linkend="itemize">itemize</link>) et <literal>description</literal> +(voir <link linkend="description">description</link>). 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) : @@ -3896,9 +4211,9 @@ niveau d’imbrication (où 1 est le niveau le plus externe) : <indexterm role="fn"><primary>\enumiii</primary></indexterm> <indexterm role="fn"><primary>\enumiv</primary></indexterm> <para>L’environnement <literal>enumerate</literal> utilise les compteurs <literal>\enumi</literal>, -…, <literal>\enumiv</literal> (see <link linkend="Counters">Counters</link>). Si vous utilisez l’argument +…, <literal>\enumiv</literal> (voir <link linkend="Counters">Counters</link>). Si vous utilisez l’argument optionnel d’<literal>\item</literal> alors le compteur n’est pas incrementé pour cet -article (see <link linkend="_005citem">\item</link>). +article (voir <link linkend="_005citem">\item</link>). </para> <indexterm role="fn"><primary>\labelenumi</primary></indexterm> <indexterm role="fn"><primary>\labelenumii</primary></indexterm> @@ -3907,7 +4222,7 @@ article (see <link linkend="_005citem">\item</link>). <para>L’environnement <literal>enumerate</literal> utilise les commandes de <literal>\labelenumi</literal> jusqu’à <literal>\labelenumiv</literal> pour produire l’étiquette par défaut. Ainsi, vous pouvez utiliser <literal>\renewcommand</literal> pour -chancher le format des étiquettes (see <link linkend="_005cnewcommand-_0026-_005crenewcommand">\newcommand & +chancher le format des étiquettes (voir <link linkend="_005cnewcommand-_0026-_005crenewcommand">\newcommand & \renewcommand</link>). Par exemple, cette liste de premier niveau va être étiquettée avec des lettres capitales, en gras, non suivies point : </para> @@ -3942,14 +4257,16 @@ cela. <indexterm role="cp"><primary>align environnement, d’<literal>amsmath</literal></primary></indexterm> <indexterm role="cp"><primary>amsmath paquetage, remplaçant <literal>eqnarray</literal></primary></indexterm> <indexterm role="cp"><primary>Madsen, Lars</primary></indexterm> -<para>Tout d’abord une mise en garde : l’environnement <literal>eqnarray</literal> a -quelques maladresse que l’on ne peut pas surmonter ; l’artice « Évitez -eqnarray ! » de Lars Madsen les décrit en détail -(<ulink url="http://tug.org/TUGboat/tb33-1/tb103madsen.pdf">http://tug.org/TUGboat/tb33-1/tb103madsen.pdf</ulink>). Ce qu’il faut -retenir c’est qu’il vaut mieux utiliser l’environnement <literal>align</literal> (et -d’autres) du paquetage <literal>amsmath</literal>. +<para>L’environnement <literal>eqnarray</literal> est obsolète. Il a des maladresses parmi +lesquelles l’espacement qui est incohérent avec d’autres éléments +mathématiques. (Voir l’artice « Évitez eqnarray ! » de Lars Madsen +(<ulink url="http://tug.org/TUGboat/tb33-1/tb103madsen.pdf">http://tug.org/TUGboat/tb33-1/tb103madsen.pdf</ulink>). Les nouveaux +documents devraient inclure le paquetage <filename>amsmath</filename> et utiliser les +environnements d’affichage mathématique que celui-ci fournit, tels que +<literal>align</literal>. On inclut une description uniquement pour être complet et +pour pouvoir travailler avec d’anciens documents. </para> -<para>Néanmoins, voici une description d’<literal>eqnarray</literal> : +<para>Synopsis : </para> <screen>\begin{eqnarray} (ou <literal>eqnarray*</literal>) <replaceable>formula1</replaceable> \\ @@ -3994,69 +4311,85 @@ et le justifie à gauche dans une boîte de largeur nulle. <para>Synopsis : </para> <screen>\begin{equation} -<replaceable>math</replaceable> +<replaceable>texte mathématique</replaceable> \end{equation} </screen> -<para>L’environnement <literal>equation</literal> commence un environnement en -<literal>displaymath</literal> (see <link linkend="displaymath">displaymath</link>), par ex. en centrant le texte -<replaceable>math</replaceable> sur la page, et aussi en plaçant un numéro d’équation dans la -marge de droite. +<para>Même chose que l’environnement <literal>displaymath</literal> (voir <link linkend="displaymath">displaymath</link>) +à ceci près que &latex; place un numéro d’équation aligné sur la marge +de droite. Le numéro d’équation est généré en utilisant le compteur +<literal>equation</literal>. </para> +<para>Il ne faut aucune ligne vide entre <literal>\begin{equation}</literal> et +<literal>\begin{equation}</literal>, sinon &latex; dit qu’il manque une signe +dollar. +</para> +<indexterm role="fn"><primary>paquetage <literal>amsmath</literal></primary></indexterm> +<indexterm role="fn"><primary><literal>amsmath</literal>, paquetage</primary></indexterm> +<para>Le paquetage <filename>amsmath</filename> comprend des moyens étendus pour l’affichage +d’équations. Les nouveau documents devrait inclure ce paquetage. +</para> </sect1> <sect1 label="8.10" id="figure"> <title><literal>figure</literal></title> <indexterm role="fn"><primary>environnement <literal>figure</literal></primary></indexterm> <indexterm role="fn"><primary><literal>figure</literal>, environnement</primary></indexterm> -<indexterm role="cp"><primary>inserer des figures</primary></indexterm> +<indexterm role="cp"><primary>insérer des figures</primary></indexterm> <indexterm role="cp"><primary>figures, insertion</primary></indexterm> <para>Synopsis : </para> <screen>\begin{figure}[<replaceable>placement</replaceable>] <replaceable>corpsfigure</replaceable> -\caption[<replaceable>titreldf</replaceable>]{<replaceable>texte</replaceable>} -\label{<replaceable>étiquette}</replaceable> + \caption[<replaceable>titreldf</replaceable>]{<replaceable>texte</replaceable>} % optionnel + \label{<replaceable>étiquette}</replaceable> % optionnel \end{figure} </screen> -<para>ou +<para>ou : </para> <screen>\begin{figure*}[<replaceable>placement</replaceable>] -<replaceable>corpsfigure</replaceable> -\caption[<replaceable>titreldf</replaceable>]{<replaceable>texte</replaceable>} -\label{<replaceable>étiquette}</replaceable> + <replaceable>corpsfigure</replaceable> + \caption[<replaceable>titreldf</replaceable>]{<replaceable>texte</replaceable>} % optionnel + \label{<replaceable>étiquette}</replaceable> % optionnel \end{figure*} </screen> -<para>Une classe de flottant (see <link linkend="Floats">Floats</link>). 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. +<para>Les figures sont du matériel qui ne fait pas partie du texte normal. Un +exemple est du matériel qu’on ne peut pas avoir segmenté entre deux +pages, comme un graphique. À cause de cela, &latex; ne compose pas les +figures en séquence avec le texte normal, mais au lieu de cela les fait +« flotter » jusqu’à un endroit convenable, tel que le haut de la page +suivante (voir <link linkend="Floats">Floats</link>). </para> -<para>Pour les valeurs possibles de <replaceable>placement</replaceable> et leur effet sur -l’algorithme de placement des flottants, voir <link linkend="Floats">Floats</link>. + +<para>Le <replaceable>corpsfigure</replaceable> peut consister de graphiques importés +(voir <link linkend="Graphics">Graphics</link>), de texte, de commandes &latex;, etc. Il est composé +une <literal>parbox</literal> de largueur <literal>\textwidth</literal>. +</para> + +<para>Pour les valeurs possibles de <replaceable>placement</replaceable> sont <literal>h</literal> pour « ici » +(‘<literal>here</literal>’ en anglais), <literal>t</literal> pour « en haut » (‘<literal>top</literal>’), +<literal>b</literal> pour « en bas », et <literal>p</literal> pour sur un page séparée de +flottants. Pour l’effet de ces options sur l’algorithme de placement des +flottants, voir <link linkend="Floats">Floats</link>. </para> <para>La version étoilée <literal>figure*</literal> est utilisée quand un document est en -mode double-colonne (see <link linkend="_005ctwocolumn">\twocolumn</link>). elle produit une figure qui +mode double-colonne (voir <link linkend="_005ctwocolumn">\twocolumn</link>). 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 <replaceable>placement</replaceable> <literal>b</literal> dans <link linkend="Floats">Floats</link>. </para> -<para>Le corps de la figure est composé dans une <literal>parbox</literal> de largueur -<literal>\textwidth</literal> and ainsi il peut contenir du texte, des commandes, -etc. -</para> -<para>L’étiquette est optionnelle ; elle est utilisée pour les double renvois -(see <link linkend="Cross-references">Cross references</link>). +<para>L’étiquette est optionnelle ; elle est utilisée pour les renvois +(voir <link linkend="Cross-references">Cross references</link>). <indexterm role="fn"><primary>\caption</primary></indexterm> La commande <literal>\caption</literal> spécifie la légende <replaceable>texte</replaceable> pour la figure. La légende est numérotée par défaut. Si <replaceable>titreldf</replaceable> est présent, il est utilisé dans la liste des figures au lieu de <replaceable>texte</replaceable> -(see <link linkend="Table-of-contents-etc_002e">Table of contents etc.</link>). +(voir <link linkend="Table-of-contents-etc_002e">Table of contents etc.</link>). </para> <para>Cet exemple fabrique une figure à partir d’un graphique. Il nécessite -l’un des paquetage <filename>graphics</filename> ou <filename>graphicx</filename>. Le graphique, -avec sa légende, est palcé au sommet d’une page ou, s’il est rejet à la +l’un des paquetages <filename>graphics</filename> ou <filename>graphicx</filename>. Le graphique, +avec sa légende, est placé au sommet d’une page ou, s’il est rejeté à la fin du document, sur une page de flottants. </para> <screen>\begin{figure}[t] @@ -4091,7 +4424,7 @@ fin du document, sur une page de flottants. \end{filecontents*} </screen> <para>Crée un fichier nommé <replaceable>nomfichier</replaceable> dans le répertoire courant (ou -dans le répertoire de sortie s’il a été spécifié ; see <link linkend="output-directory">output +dans le répertoire de sortie s’il a été spécifié ; voir <link linkend="output-directory">output directory</link>) et y écrit <replaceable>texte</replaceable>. Par défaut un fichier déjà existant n’est pas écrasé. </para> @@ -4164,6 +4497,8 @@ Un article de \monnom. <indexterm role="cp"><primary>texte ferré à gauche, environnement pour</primary></indexterm> <indexterm role="cp"><primary>texte drapeau droit, environnement pour</primary></indexterm> +<para>Synopsis : +</para> <screen>\begin{flushleft} <replaceable>ligne1</replaceable> \\ <replaceable>ligne2</replaceable> \\ @@ -4174,10 +4509,23 @@ Un article de \monnom. <para>L’environnement <literal>flushleft</literal> 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 -<literal>\\</literal>. -</para> +hampe (fer du composeur) serait à gauche et les franges à droite. Si +vous avez des lignes qui sont trop longues alors &latex; insère des +sauts de ligne sans faire de césure ni dilater ou contracter les espaces +inter-mot. Pour forcer un saut de ligne on utilise une double +contr’oblique, <literal>\\</literal>. Pour la forme déclarative, +voir <link linkend="_005craggedright">\raggedright</link>. +</para> +<para>L’exemple suivant crée une boîte de texte qui fait au plus 7,5cm de +large, et dont le texte est fer à gauche et drapeau à droite. +</para> +<screen>\noindent\begin{minipage}{7.5cm} +\begin{flushleft} + Une longue phrase que \LaTeX{} coupe à l'endroit approprié. \\ + Et, une nouvelle ligne forcée par la double contr'oblique. +\end{flushleft} +\end{minipage} +</screen> <sect2 label="8.12.1" id="_005craggedright"> @@ -4189,18 +4537,43 @@ droite. Chaque ligne doit être terminée par la séquence de contrôle <indexterm role="cp"><primary>justifié à gauche du texte</primary></indexterm> <indexterm role="cp"><primary>justification, drapeau droit</primary></indexterm> -<para>La déclaration <literal>\raggedright</literal> correspond à l’environnement -<literal>flushleft</literal>. Cette déclaration peut être utilisée au sein d’un -environnement tel que <literal>quote</literal> ou d’une <literal>parbox</literal>. +<para>Synopsis : +</para> +<screen>{\raggedright ... } +</screen> +<para>ou : +</para> +<screen>\begin{<replaceable>environnement</replaceable>} \raggedright + ... +\end{<replaceable>environnement</replaceable>} +</screen> +<para>Une déclaration qui a pour effet que les lignes sont ferrées sur la +marge de gauche et drapeau sur la droite, c-à-d. que les mots sont +alignés sur la gauche comme sur le fer du composeur, et en dentelure +comme les frange d’un drapeau à droite. Elle peut être utilisée au sein +d’un <replaceable>environnement</replaceable> tel que <literal>quote</literal> ou d’une +<literal>parbox</literal>. Pour la forme par environnement voir <link linkend="flushleft">flushleft</link>. </para> <para>Contrairement à l’environnement <literal>flushleft</literal>, la commande <literal>\raggedright</literal> 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 <literal>\end</literal> qui termine +affecter le format d’une unité de paragraphe, la portée de la déclaration +doit contenir la ligne à blanc ou la commande <literal>\end</literal> qui termine l’unité de paragraphe. </para> +<para>Dans l’exemple ci-après <literal>\raggedright</literal> dans la deuxième colonne +empèche &latex; de faire une composition très maladroite pour faire +rentrer le texte dans une colonne étroite. Notez que +<literal>\raggedright</literal> est au sein d’accolades <literal>{...}</literal> pour borner +son effet. +</para> +<screen>\begin{tabular}{rp{5cm}} + Équipe alpha &{\raggedright Cette équipe fait le travail réel.} \\ + Équipe beta &{\raggedright Cette équipe assure que le système de refroidissement + ne manque jamais d'eau.} \\ +\end{tabular} +</screen> </sect2> </sect1> <sect1 label="8.13" id="flushright"> @@ -4212,20 +4585,29 @@ l’unité de paragraphe. <indexterm role="cp"><primary>justifier à droite, environnement pour</primary></indexterm> <screen>\begin{flushright} -<replaceable>ligne1</replaceable> \\ -<replaceable>ligne2</replaceable> \\ + <replaceable>ligne1</replaceable> \\ + <replaceable>ligne2</replaceable> \\ ... \end{flushright} </screen> <indexterm role="fn"><primary>\\ (pour <literal>flushright</literal>)</primary></indexterm> <para>L’environnement <literal>flushright</literal> 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 <literal>\\</literal>. +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. Si vous avez des lignes qui sont trop +longues pour entrer entre les marges, alors &latex; insère des sauts de +ligne sans faire de césure ni dilater ou contracter les espaces +inter-mot. Pour forcer un saut de ligne on utilise une double +contr’oblique, <literal>\\</literal>. Pour la forme déclarative, +voir <link linkend="_005craggedleft">\raggedleft</link>. +</para> +<para>Pour un exemple en relation avec cet environnement, +voir <link linkend="flushleft">flushleft</link>, où il suffit mutatis mutandis de changer +<literal>flushright</literal> en <literal>flushleft</literal>. </para> + <sect2 label="8.13.1" id="_005craggedleft"> <title><literal>\raggedleft</literal></title> <indexterm role="fn"><primary>\raggedleft</primary></indexterm> @@ -4233,18 +4615,34 @@ séquence de contrôle <literal>\\</literal>. <indexterm role="cp"><primary>justification, drapeau gauche</primary></indexterm> <indexterm role="cp"><primary>justifier le texte à droite</primary></indexterm> -<para>La déclaration <literal>\raggedleft</literal> correspond à l’environnement -<literal>flushright</literal>. Cette déclaration peut être utilisée au sein d’un -environnement tel que as <literal>quote</literal> ou d’une <literal>parbox</literal>. +<para>Synopsis : +</para> +<screen>{\raggedleft ... } +</screen> +<para>ou +</para> +<screen>\begin{<replaceable>environnement</replaceable>} \raggedleft + ... +\end{<replaceable>environnement</replaceable>} +</screen> +<para>Une déclaration qui a pour effet que les lignes sont ferrées sur la +marge de droite et drapeau sur la gauche, c-à-d. que les mots sont +alignés sur la droite comme sur le fer du composeur, et en dentelure +comme les frange d’un drapeau à gauche. Elle peut être utilisée au sein +d’un <replaceable>environnement</replaceable> tel que <literal>quote</literal> ou d’une +<literal>parbox</literal>. Pour la forme par environnement voir <link linkend="flushleft">flushleft</link>. </para> <para>Contrairement à l’environnement <literal>flushright</literal>, la commande -<literal>\raggedleft</literal> ne commence pas un nouveau paragraphe ; elle change +<literal>\raggedleft</literal> 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 une unité de paragraphe, la portée de la -déclaration doit contenir la ligne à blanc ou la commande <literal>\end</literal> qui -termine l’unité de paragraphe. +affecter le format d’une unité de paragraphe, la portée de la déclaration +doit contenir une ligne à blanc ou la commande <literal>\end</literal> qui termine +l’unité de paragraphe. +</para> +<para>Pour un exemple en relation avec cet environnement, +voir <link linkend="_005craggedright">\raggedright</link>, où il suffit mutatis mutandis de changer +<literal>\raggedright</literal> en <literal>\raggedleft</literal>. </para> - </sect2> </sect1> <sect1 label="8.14" id="itemize"> @@ -4260,43 +4658,69 @@ termine l’unité de paragraphe. <para>Synopsis : </para> <screen>\begin{itemize} -\item <replaceable>item1</replaceable> -\item <replaceable>item2</replaceable> -... + \item[<replaceable>étiquette optionnelle du 1er article</replaceable>] <replaceable>texte du 1er article</replaceable> + \item[<replaceable>étiquette optionnelle du 2e article</replaceable>] <replaceable>texte du 2e article</replaceable> + ... \end{itemize} </screen> -<para>L’environnement <literal>itemize</literal> produit une liste « non ordonnée », « à -puces ». Les environnement <literal>itemize</literal> 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 <literal>enumerate</literal> (see <link linkend="enumerate">enumerate</link>). +<para>L’environnement <literal>itemize</literal> produit une <firstterm>liste non ordonnée</firstterm>, qu’on +appelle parfois liste à puces. Il doit y avoir au moins une commande +<literal>\item</literal> au sein de l’environnement ; sans quoi &latex; produit +l’erreur ‘<literal>Something's wrong--perhaps a missing \item</literal>’. </para> -<para>Chaque article d’une liste <literal>itemize</literal> commence avec une commande -<literal>\item</literal>. Il doit y avoir au moins une commande <literal>\item</literal> au -sein de l’environnement. +<para>L’exemple suivant donne une liste à deux articles. </para> -<para>Par défaut, les marques de chaque niveau ressemblent à cela : +<screen>\begin{itemize} + \item Esquisse au crayon et aquarelle par Cassandra + \item Portrait Rice +\end{itemize} +</screen> +<para>Par défaut — sans charger par ex. le paquetage <filename>babel</filename> avec une +autre langue que USenglish — dans une liste au premier niveau +d’imbrication l’étiquette est rendue par une puce, •. Le format +des étiquettes dépend du niveau d’imbrication ; voir plus bas. </para> -<orderedlist numeration="arabic"><listitem><para>• (puce) -</para></listitem><listitem><para><emphasis role="bold">--<!-- /@w --></emphasis> (tiret demi-cadratin gras) -</para></listitem><listitem><para>* (asterisque) -</para></listitem><listitem><para>. (point centré verticalement, rendu ici comme un point final) -</para></listitem></orderedlist> -<!-- vincentb1 cette information n'est pas dans l'original, vérifiez avec Karl : --> -<para>Si vous utilisez l’environnement <literal>babel</literal> avec la langue -<literal>french</literal>, alors il y a des tirets pour tous les niveaux comme c’est -l’habitude des Français. +<indexterm role="fn"><primary>\item</primary></indexterm> +<para>On démarre les article de liste avec la commande <literal>\item</literal> +(voir <link linkend="_005citem">\item</link>). Si vous passez à <literal>\item</literal> un argument optionnel en +le faisant suivre de crochets, comme dans <literal>\item[<replaceable>étiquette +optionnelle</replaceable>]</literal>, alors par défaut <replaceable>étiquette optionnelle</replaceable> apparaît en +gras et aligné à droite, de sorte qu’elle peut s’étendre dans la marge +de gauche. Pour des étiquettes alignées à gauche voir l’environnement +<link linkend="description">description</link>. À la suite <literal>\item</literal> se trouve le texte que +l’article qui peut être vide ou contenir plusieurs paragraphes. +</para> +<para>Les listes non ordonnées peuvent être imbriquées l’une dans l’autre, sur +jusqu’à quatre niveaux de profondeur. Elles peuvent aussi être imbriquées +avec d’autre environnements fabriquant des paragraphes, comme +<literal>enumerate</literal> (voir <link linkend="enumerate">enumerate</link>). </para> <indexterm role="fn"><primary>\labelitemi</primary></indexterm> <indexterm role="fn"><primary>\labelitemii</primary></indexterm> <indexterm role="fn"><primary>\labelitemiii</primary></indexterm> <indexterm role="fn"><primary>\labelitemiv</primary></indexterm> -<para>L’environnement <literal>itemize</literal> utilise les commandes de +<anchor id="itemize-labelitemi"/><anchor id="itemize-labelitemii"/><anchor id="itemize-labelitemiii"/><anchor id="itemize-labelitemiv"/><para>L’environnement <literal>itemize</literal> utilise les commandes de <literal>\labelitemi</literal> jusqu’à <literal>\labelitemiv</literal> pour produire les -étiquettes par défaut. Ainsi, vous pouvez utiliser <literal>\renewcommand</literal> -pour changer les étiquettes. Par exemple, pour que le premier niveau -utilise des losanges : +étiquettes par défaut (notez la convention que le nombre romain en bas +de casse à la fin du nom de la commande indique le niveau +d’imbrication). Voici les marques de chaque niveau : +</para> +<orderedlist numeration="arabic"><listitem><para>• (puce, issue de <literal>\textbullet</literal>) +</para></listitem><listitem><para><emphasis role="bold">--<!-- /@w --></emphasis> (tiret demi-cadratin gras, issu du <literal>\normalfont\bfseries\textendash</literal>) +</para></listitem><listitem><para>* (asterisque, issu de <literal>\textasteriskcentered</literal>) +</para></listitem><listitem><para>. (point centré verticalement, rendu ici comme un point final, issu de <literal>\textperiodcentered</literal>) +</para></listitem></orderedlist> +<!-- vincentb1 cette information n'est pas dans l'original, vérifiez avec Karl : --> + +<para>Si vous utilisez le paquetage <filename>babel</filename> avec la langue +<literal>french</literal>, alors il y a des tirets pour tous les niveaux comme c’est +l’habitude des Français. +</para> + + +<para>Utilisez <literal>\renewcommand</literal> pour changer les étiquettes. Par exemple, +pour que le premier niveau utilise des losanges : </para> <screen>\renewcommand{\labelitemi}{$\diamond$} </screen> @@ -4309,7 +4733,7 @@ utilise des losanges : <indexterm role="fn"><primary>\leftmarginvi</primary></indexterm> <anchor id="itemize-leftmargin"/><anchor id="itemize-leftmargini"/><anchor id="itemize-leftmarginii"/><anchor id="itemize-leftmarginiii"/><anchor id="itemize-leftmarginiv"/><anchor id="itemize-leftmarginv"/><anchor id="itemize-leftmarginvi"/><para>Les paramètres de <literal>\leftmargini</literal> jusqu’à <literal>\leftmarginvi</literal> définissent la distance entre la marge de gauche de l’environnement -surjacent et la marge de gauche de la liste. (Notez la convention de +surjacent et la marge de gauche de la liste. (On utilise aussi la convention de nommage de la commande avec un nombre romain en bas de casse à la fin pour désigner le niveau d’imbrication). Les valeurs par défaut sont : <literal>2.5em</literal> pour le niveau 1 (<literal>2em</literal> en mode deux-colonnes), @@ -4321,80 +4745,28 @@ niveaux plus profondément imbriqués. <indexterm role="fn"><primary><literal>enumitem</literal>, paquetage</primary></indexterm> <para>Pour les autres environnements majeurs de listes à étiquettes de -&latex;, voir <link linkend="description">description</link> et <link linkend="enumerate">enumerate</link>. Pour des -informations concernant les paramètres de contrôle de la disposition des -listes, y compris les valeurs par défaut, ainsi que la personalisaton de -la disposition, voir <link linkend="list">list</link>. La paquetage <filename>enumitem</filename> est utile -pour personaliser les listes. +&latex;, voir <link linkend="description">description</link> et <link linkend="enumerate">enumerate</link>. Les environnements +<literal>itemize</literal>, <literal>enumerate</literal> et <literal>description</literal> utilisent les +mêmes paramètres de contrôle de la disposition des listes. Pour leur +description, y compris les valeurs par défaut, ainsi que la +personalisaton de la disposition, voir <link linkend="list">list</link>. Le paquetage +<filename>enumitem</filename> est utile pour personaliser les listes. </para> <para>Dans cet exemple on réduit grandement l’espace de marge pour la liste à -puces la plus externe~: +puces la plus externe : </para> <screen>\setlength{\leftmargini}{1.25em} % valeur par défaut 2.5em </screen> -<!-- xx should be in its own generic section --> -<para>Quelques paramètres qui affectent le formatage des listes : -</para> -<variablelist><varlistentry><term><indexterm role="fn"><primary>\itemindent</primary></indexterm><literal>\itemindent</literal> -</term><listitem><para>Renfoncement supplementaire avant chaque articles dans une liste ; la -valeur par défaut est zéro. -</para> -</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\labelsep</primary></indexterm><literal>\labelsep</literal> -</term><listitem><para>Espace entre l’étiquette et le texte d’un article ; la valeur par défaut -est ‘<literal>.5em</literal>’. -</para> -</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\labelwidth</primary></indexterm><literal>\labelwidth</literal> -</term><listitem><para>Largeur de l’étiquette ; la valeur par défaut est ‘<literal>2em</literal>’, ou -‘<literal>1.5em</literal>’ en mode deux-colonnes. -</para> -</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\listparindent</primary></indexterm><literal>\listparindent</literal> -</term><listitem><para>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 -‘<literal>0pt</literal>’. -</para> -</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\rightmargin</primary></indexterm><literal>\rightmargin</literal> -</term><listitem><para>Distance horizontale entre la marge de droite de la liste et -l’environnement surjacent ; la valeur par défaut est ‘<literal>0pt</literal>’, sauf à -l’intérieur des environnement <literal>quote</literal>, <literal>quotation</literal>, et -<literal>verse</literal>, où elle est réglée pour être égale à <literal>\leftmargin</literal>. -</para> -</listitem></varlistentry></variablelist> -<para>Paramètres affectant l’espacement vertical entre les articles de liste -(plutôt relâché, par défaut). -</para> -<variablelist><varlistentry><term><indexterm role="fn"><primary>\itemsep</primary></indexterm><literal>\itemsep</literal> -</term><listitem><para>Espace vertical entre les articles. La valeur par défaut est <literal>2pt -plus1pt minus1pt</literal> pour les documents en <literal>10pt</literal>, <literal>3pt plus2pt -minus1pt</literal> pour ceux en <literal>11pt</literal>, et <literal>4.5pt plus2pt minus1pt</literal> -pour ceux en <literal>12pt</literal>. -</para> -</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\parsep</primary></indexterm><literal>\parsep</literal> -</term><listitem><para>Espace vertical supplémentaire entre les paragraphes au sein d’un -article de liste. Par défaut vaut la même chose que <literal>\itemsep</literal>. -</para> -</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\topsep</primary></indexterm><literal>\topsep</literal> -</term><listitem><para>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 -<literal>8pt plus2pt minus4pt</literal> pour les documents en <literal>10pt</literal>, <literal>9pt -plus3pt minus5pt</literal> pour ceux en <literal>11pt</literal>, et <literal>10pt plus4pt -minus6pt</literal> pour ceux en <literal>12pt</literal>. Ces valeurs sont réduites pour les -listes avec au moins un niveau d’imbrication. -</para> -</listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\partopsep</primary></indexterm><literal>\partopsep</literal> -</term><listitem><para>Espace supplémentaire ajouté à <literal>\topsep</literal> quand l’environnement de -liste démarre un paragraphe. La valeur par défaut est <literal>2pt plus1pt -minus1pt</literal> pour les documents en <literal>10pt</literal>, <literal>3pt plus1pt minus1pt</literal> -pour ceux en <literal>11pt</literal>, et <literal>3pt plus2pt minus2pt</literal> pour ceux en -<literal>12pt</literal>. -</para> -</listitem></varlistentry></variablelist> +<!-- xx TODO vérifier que tout cela se retouve bien dans node list. --> + + <indexterm role="fn"><primary>\parskip exemple</primary></indexterm> <para>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 <literal>itemize*</literal> sans espacement supplémentaire entre les articles, ni entre les paragraphes au sein d’un seul article (<literal>\parskip</literal> n’est pas spécifique aux listes, -see <link linkend="_005cparindent-_0026-_005cparskip">\parindent & \parskip</link>): +voir <link linkend="_005cparindent-_0026-_005cparskip">\parindent & \parskip</link>): </para> <screen>\newenvironment{itemize*}% {\begin{itemize}% @@ -4411,7 +4783,7 @@ see <link linkend="_005cparindent-_0026-_005cparskip">\parindent & \parskip< <indexterm role="fn"><primary><literal>letter</literal>, environnement</primary></indexterm> -<para>Cet environnement est utilisé pour créer des lettres. See <link linkend="Letters">Letters</link>. +<para>Cet environnement est utilisé pour créer des lettres. Voir <link linkend="Letters">Letters</link>. </para> </sect1> @@ -4434,12 +4806,12 @@ see <link linkend="_005cparindent-_0026-_005cparskip">\parindent & \parskip< utilisé pour construire des listes plus spécialisées. On l’utilise la plupart du temps pour créer des listes via les environnements <literal>description</literal>, <literal>enumerate</literal>, et <literal>itemize</literal> -(see <link linkend="description">description</link>, <link linkend="enumerate">enumerate</link>, et <link linkend="itemize">itemize</link>). Par ailleurs, +(voir <link linkend="description">description</link>, <link linkend="enumerate">enumerate</link>, et <link linkend="itemize">itemize</link>). Par ailleurs, beaucoup d’environnements standards de &latex; qui visuellement ne sont pas des listes sont construits en utilisant <literal>list</literal>, ceci comprend <literal>quotation</literal>, <literal>quote</literal>, <literal>center</literal>, <literal>verbatim</literal>, et bien -d’autres (see <link linkend="quotation-_0026-quote">quotation & quote</link>, see <link linkend="center">center</link>, -see <link linkend="flushright">flushright</link>). +d’autres (voir <link linkend="quotation-_0026-quote">quotation & quote</link>, voir <link linkend="center">center</link>, +voir <link linkend="flushright">flushright</link>). </para> <para>Ici, on décrit l’environnement <literal>list</literal> en définissant un nouvel environnement personnalisé. @@ -4470,11 +4842,11 @@ supplémentaire s’étend sur la droite. Lorsque vous fabriquez une instance de <literal>list</literal> vous pouvez l’emporter sur l’étiquetage par défaut en donnant à <literal>\item</literal> un argument optionnel avec des crochets et le texte, comme dans l’exemple précédent <literal>\item[Étiquette -spéciale.]</literal> ; see <link linkend="_005citem">\item</link>. +spéciale.]</literal> ; voir <link linkend="_005citem">\item</link>. </para> <para>Le second argument obligatoire <replaceable>espacement</replaceable> prend une liste de commandes. L’une de celle qu’on y retrouve est -<literal>\usecounter{<replaceable>nomcompteur</replaceable>}</literal> (see <link linkend="_005cusecounter">\usecounter</link>). Utilisez +<literal>\usecounter{<replaceable>nomcompteur</replaceable>}</literal> (voir <link linkend="_005cusecounter">\usecounter</link>). Utilisez la pour dire à &latex; de numéroter les article en utilisant le compteur fourni. Ce compteur est remis à zéro chaque fois que &latex; entre dans l’environnement, et le compteiur est incrémenté par un chaque @@ -4501,7 +4873,7 @@ redéfinir l’espacement de la liste. Ci dessous on listes les paramètres d’espacement et leur valeurs par défaut. (Il se peut que les valeurs par défaut pour les environnements dérivés tels que <literal>itemize</literal> soient différentes des valeurs exposées ici). Voir aussi la figure qui suit la -liste. Chaque paramètre est une longueur (see <link linkend="Lengths">Lengths</link>). Les espaces +liste. Chaque paramètre est une longueur (voir <link linkend="Lengths">Lengths</link>). Les espaces verticaux sont d’ordinaire des longueurs élastiques, avec une composante en <literal>plus</literal> ou en <literal>minus</literal>, pour donner à &tex; de la flexibilité dans le réglage de la page. On change chaque paramètre avec @@ -4510,12 +4882,12 @@ minus1pt}</literal>. Pour obtenir certains effets, ces longueurs doivent être mise à zéro, ou à une valeur négative. </para> <variablelist><varlistentry><term><indexterm role="fn"><primary>\itemindent</primary></indexterm><literal>\itemindent</literal> -</term><listitem><para>Espace supplémentaire horizontal de renfoncement, ajouté à de +</term><listitem><anchor id="list-itemindent"/><para>Espace supplémentaire horizontal de renfoncement, ajouté à de <literal>leftmargin</literal>, de la première ligne de chaque article. Sa valeur par défaut est <literal>0pt</literal>. </para> </listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\itemsep</primary></indexterm><literal>\itemsep</literal> -</term><listitem><para>Espace vertical entre les articles, ajouté à <literal>\parsep</literal>. Les +</term><listitem><anchor id="list-itemsep"/><para>Espace vertical entre les articles, ajouté à <literal>\parsep</literal>. Les valeurs par défaut pour les trois premiers niveaux dans les classes de &latex; ‘<literal>article</literal>’, ‘<literal>book</literal>’, et ‘<literal>report</literal>’ à la taille de 10 point sont : <literal>4pt plus2pt minus1pt</literal>, <literal>\parsep</literal> (c-à-d. @@ -4528,12 +4900,12 @@ plus2.5pt minus1pt</literal>, <literal>\parsep</literal> (c-à-d. <literal>2.5pt minus1pt</literal>), et <literal>\topsep</literal> (c-à-d. <literal>2.5pt plus1pt minus1pt</literal>). </para> </listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\labelsep</primary></indexterm><literal>\labelsep</literal> -</term><listitem><para>Espace horizontal entre l’étiquette et le texte d’un article. La valeur +</term><listitem><anchor id="list-labelsep"/><para>Espace horizontal entre l’étiquette et le texte d’un article. La valeur par défaut pour les classes &latex; ‘<literal>article</literal>’, ‘<literal>book</literal>’, et ‘<literal>report</literal>’ est de <literal>0.5em</literal>. </para> </listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\labelwidth</primary></indexterm><literal>\labelwidth</literal> -</term><listitem><para>Largueur horizontale. La boîte contenant l’étiquette est nominalement de +</term><listitem><anchor id="list-labelwidth"/><para>Largueur horizontale. La boîte contenant l’étiquette est nominalement de cette largeur. Si <literal>\makelabel</literal> renvoie un texte qui est plus larget que cela, alors le renfoncement de la première ligne de l’article sera augmenté pour créer l’espace nécessaire à ce matériel supplémentaire. @@ -4545,17 +4917,17 @@ l’étiquette est composé fer à droite dans une boîte de cette largeur. <literal>\leftmargin</literal>+<literal>\itemindent</literal>-<literal>\labelsep</literal>-<literal>\labelwidth</literal> de la marge de gauche de l’environnement enveloppant. </para> -<para>La valeur par défaut pour les classe &latex; ‘<literal>article</literal>’, -‘<literal>book</literal>’, et ‘<literal>report</literal>’ pour les liste de premier niveau vaut +<para>La valeur par défaut pour les classes &latex; ‘<literal>article</literal>’, +‘<literal>book</literal>’, et ‘<literal>report</literal>’ pour les listes de premier niveau vaut <literal>\leftmargini</literal>-<literal>\labelsep</literal>, (c-à-d. <literal>2em</literal> en mode à une colonne et <literal>1.5em</literal> en mode à deux colonnes). Au deuxième niveau, c’est <literal>\leftmarginii</literal>-<literal>\labelsep</literal>, et au troisième niveau <literal>\leftmarginiii</literal>-<literal>\labelsep</literal>. Ces définitions ont pour effet -que le bord de gauche de l’étiquette coïncide avec la marge dee gauche +que le bord de gauche de l’étiquette coïncide avec la marge de gauche de l’environnement enveloppant. </para> <para>r</para></listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\leftmargin</primary></indexterm><literal>\leftmargin</literal> -</term><listitem><para>Espace horizontal entre la marge de gauche de l’environnement envelopant +</term><listitem><anchor id="list-leftmargin"/><para>Espace horizontal entre la marge de gauche de l’environnement envelopant (ou la marge de gauche de la page pour une liste de premier niveau), et la marge de gauche de cette liste. Doit être positif ou nul. </para> @@ -4588,7 +4960,7 @@ point sont : <literal>4pt plus2pt minus1pt</literal>, <literal>2pt plus1pt minu and <literal>0pt</literal>. La valeurs par défaut à la taille de 11 point sont : <literal>4.5pt plus2pt minus1pt</literal>, <literal>2pt plus1pt minus1pt</literal>, et <literal>0pt</literal>. La valeurs par défaut à la taille de 12 point sont : -<literal>5pt plus2.5pt minus1pt</literal>, <literal>2.5pt plus1pt minus1pt</literal>, and +<literal>5pt plus2.5pt minus1pt</literal>, <literal>2.5pt plus1pt minus1pt</literal>, et <literal>0pt</literal>. </para> </listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\partopsep</primary></indexterm><literal>\partopsep</literal> @@ -4617,7 +4989,7 @@ and the right margin of the enclosing environment. Its default value is </para> </listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\topsep</primary></indexterm><literal>\topsep</literal> </term><listitem><anchor id="list-topsep"/><para>Espace vertical ajouté aussi bien au haut qu’au bas -de la lise, en plus de <literal>\parskip</literal> (see <link linkend="_005cparindent-_0026-_005cparskip">\parindent & \parskip</link>). +de la lise, en plus de <literal>\parskip</literal> (voir <link linkend="_005cparindent-_0026-_005cparskip">\parindent & \parskip</link>). Les valeurs par défaut pour les trois premiers niveaux dans les classes &latex; ‘<literal>book</literal>’, anet ‘<literal>report</literal>’ à la taille de 10 point sont : <literal>8pt plus2pt minus4pt</literal>, <literal>4pt plus2pt minus1pt</literal>, and <literal>2pt @@ -4690,30 +5062,35 @@ d’une ligne à blanc au dessous de l’environnement est sans effet.) </term><listitem><para><literal>\rightmargin</literal> </para> </listitem></varlistentry></variablelist> -<para>The list’s left and right margins, shown above as <replaceable>h3</replaceable> and <replaceable>h5</replaceable>, -are with respect to the ones provided by the surrounding environment, or -with respect to the page margins for a top-level list. The line width -used for typesetting the list items is <literal>\linewidth</literal> (see <link linkend="Page-layout-parameters">Page -layout parameters</link>). For instance, set the list’s left margin to be one -quarter of the distance between the left and right margins of the -enclosing environment with +<para>Les marges de gauche et de droite de la liste, affichées ci-dessus comme +<replaceable>h3</replaceable> et <replaceable>h5</replaceable>, sont exprimées relativement à celles fournies par +l’environnement englobant, ou par rapport aux marges de la page pour une +liste au niveau le plus externe. La largeur de ligne utilisée pour la +composition des articles de la liste est <literal>\linewidth</literal> (voir <link linkend="Page-layout-parameters">Page +layout parameters</link>). Par exemple, réglez la marge de gauche de la liste +à un quart de la distance entre les marges de gauche et de droite de +l’environnement englobant avec <literal>\setlength{\leftmargin}{0.25\linewidth}</literal>. </para> -<para>Page breaking in a list structure is controlled by the three -parameters below. For each, the &latex; default is -<literal>-\@lowpenalty</literal>, that is, <literal>-51</literal>. Because it is negative, -it somewhat encourages a page break at each spot. Change it with, -e.g., <literal>\@beginparpenalty=9999</literal>; a value of 10000 prohibits a -page break. +<para>Les sauts de page au sein d’une structure de liste sont contrôlés par +les paramètres ci-dessous. Pour chacun d’eu, la valeur par défaut de +&latex; est <literal>-\@lowpenalty</literal>, c-à-d. <literal>-51</literal>. Comme c’est +négatif, cela encourage d’une certaine façon un saut de page à tout +endroit. On peut changer cela avec un réglage de, par ex., +<literal>\@beginparpenalty=9999</literal> ; une valeur de 10000 interdit une saut +de page. </para> <variablelist><varlistentry><term><indexterm role="fn"><primary>\@beginparpenalty</primary></indexterm><literal>\@beginparpenalty</literal> -</term><listitem><para>The page breaking penalty for breaking before the list (default <literal>-51</literal>). +</term><listitem><para>La pénalité de saut de page pour un saut avanrt la liste (par défaut +<literal>-51</literal>). </para> </listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\@itempenalty</primary></indexterm><literal>\@itempenalty</literal> -</term><listitem><para>The page breaking penalty for breaking before a list item (default <literal>-51</literal>). +</term><listitem><para>La pénalité pour un saut de page avant un article de liste (par défaut +<literal>-51</literal>). </para> </listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\@endparpenalty</primary></indexterm><literal>\@endparpenalty</literal> -</term><listitem><para>The page breaking penalty for breaking after a list (default <literal>-51</literal>). +</term><listitem><para>La pénalité pour un saut de page après une liste (par défaut +<literal>-51</literal>). </para> </listitem></varlistentry></variablelist> <indexterm role="fn"><primary>paquetage <literal>enumitem</literal></primary></indexterm> @@ -4723,8 +5100,8 @@ page break. listes. </para> <para>Dans l’exemple suivant les étiquettes sont en rouge. Elles sont -numérotées, et le bord gauche des étiquettes est aligné avalt le bord -gauche du texte des articles. See <link linkend="_005cusecounter">\usecounter</link>. +numérotées, et le bord gauche des étiquettes est aligné avec le bord +gauche du texte des articles. Voir <link linkend="_005cusecounter">\usecounter</link>. </para> <screen>\usepackage{color} \newcounter{cnt} @@ -4736,11 +5113,11 @@ gauche du texte des articles. See <link linkend="_005cusecounter">\usecounter</ \setlength{\labelwidth}{0em} \setlength{\labelsep}{0.5em} \setlength{\leftmargin}{1.5em} - \setlength{\itemindent}{0.5em} % equals \labelwidth+\labelsep + \setlength{\itemindent}{0.5em} % vaut \labelwidth+\labelsep \let\makelabel=\makeredlabel } } -{\end{list} } +{\end{list}} </screen> @@ -4762,7 +5139,7 @@ de crochets (<literal>[</literal> et <literal>]</literal>), pour utiliser des c sein de l’argument optionnel vous devez les cacher entre accolades, comme dans <literal>\item[Crochet fermant, {]}]</literal>. De même, pour utiliser un crochet ouvrant comme premier caractère du texte d’un article, cachez le -aussi au sein d’accolade. See <link linkend="LaTeX-command-syntax">&latex; command syntax</link>. +aussi au sein d’accolade. Voir <link linkend="LaTeX-command-syntax">&latex; command syntax</link>. </para> <para>Dans cet exemple la liste <literal>enumerate</literal> a deux articles qui utilise l’étiquette par défaut et une qui utilise l’étiquette optionnelle. @@ -4807,7 +5184,7 @@ précédent ; ajuster les marges de gauche et de droit pour d’éventuels environnements de liste imbriqués. </para> <para>En particulier, <literal>trivlist</literal> utilise les valeurs courantes des -paramètres de liste (see <link linkend="list">list</link>), à ceci près que <literal>\parsep</literal> est +paramètres de liste (voir <link linkend="list">list</link>), à ceci près que <literal>\parsep</literal> est réglé à la valeur de <literal>\parskip</literal>, et que <literal>\leftmargin</literal>, <literal>\labelwidth</literal>, et <literal>\itemindent</literal> sont réglés à zéro. </para> @@ -4839,7 +5216,7 @@ verticalement. <indexterm role="fn"><primary>\(...\) en ligne, math</primary></indexterm> <para>L’environnement <literal>math</literal> insert les <replaceable>maths</replaceable> donnés au sein du texte en cours. <literal>\(...\))</literal> et <literal>$...$</literal> sont des synonymes. -See <link linkend="Math-formulas">Math formulas</link>. +Voir <link linkend="Math-formulas">Math formulas</link>. </para> </sect1> <sect1 label="8.18" id="minipage"> @@ -4865,13 +5242,14 @@ See <link linkend="Math-formulas">Math formulas</link>. comme une version réduite d’une page ; elle peut contenir ses propres notes en bas de page, listes à puces, etc. (Il y a quelques restrictions, notamment qu’elle ne peut pas avoir de flottants). Cette -boîte ne peut pas être coupé sur plusieurs pages. Ainsi <literal>minipage</literal> -est similaire à la commande <literal>\parbox</literal> (see <link linkend="_005cparbox">\parbox</link>), mais +boîte ne peut pas être coupée sur plusieurs pages. Ainsi <literal>minipage</literal> +est similaire à la commande <literal>\parbox</literal> (voir <link linkend="_005cparbox">\parbox</link>), mais contrairement à <literal>\parbox</literal>, d’autres environnements de production de -paragraphe peuvent être utilisés au sein d’une minipage. This example -will be 3 inches wide, and has two paragraphs. +paragraphe peuvent être utilisés au sein d’une minipage. </para> -<screen>\begin{minipage}{3in} +<para>Cet exemple fait 7,5cm de large, et comprend deux paragraphes. +</para> +<screen>\begin{minipage}{7.5cm} Stephen Kleene fut un fondateur de la théorie de la récursivité. Il fut l'élève de Church, l'auteur de trois textes qui firent autorité, @@ -4882,7 +5260,7 @@ will be 3 inches wide, and has two paragraphs. <para>Voir plus bas pour une discussion sur le renfoncement de paragraphe au sein d’une <literal>minipage</literal>. </para> -<para>L’argument obligatoire <replaceable>largeur</replaceable> est une longueur rigide (see <link linkend="Lengths">Lengths</link>). +<para>L’argument obligatoire <replaceable>largeur</replaceable> est une longueur rigide (voir <link linkend="Lengths">Lengths</link>). Il donne la largeur de la boîte dans laquelle <replaceable>matière</replaceable> est composée. </para> <para>Il y a trois arguments optionnels, <replaceable>position</replaceable>, <replaceable>hauteur</replaceable>, et @@ -4921,7 +5299,7 @@ l’entourant (comme <literal>\vbox</literal> en &tex; de base). <para>avec ce qui se passe en remplaçant <literal>c</literal> par <literal>b</literal> ou <literal>t</literal>. </para> <para>L’argument optionnel <replaceable>hauteur</replaceable> est une longueur rigide -(see <link linkend="Lengths">Lengths</link>). Il règle la hauteur de la <literal>minipage</literal>. Vous +(voir <link linkend="Lengths">Lengths</link>). Il règle la hauteur de la <literal>minipage</literal>. Vous pouvez donner n’importe quelle valeur supérieure, égale ou inférieure à la hauteur naturelle de la <literal>minipage</literal> sans que &latex; ne produise une erreur ou un avertissement. Vous pouvez aussi la régler à une @@ -4974,7 +5352,7 @@ en bas de page dans des figures ou des tableaux. Une commande <literal>\footnote</literal> ou <literal>\footnotetext</literal> met la note en bas de page au bas de la minipage au lieu de la mettre au bas de la page, et elle utilise le compteur <literal>\mpfootnote</literal> au lieu du compteur ordinaire -<literal>footnote</literal> (see <link linkend="Counters">Counters</link>). +<literal>footnote</literal> (voir <link linkend="Counters">Counters</link>). </para> <para>L’exemple ci-dessous place la note argument de <literal>\footnote</literal> en bas de la table, et non en bas de la page. @@ -4993,7 +5371,7 @@ de la table, et non en bas de la page. \end{center} </screen> <para>Si vous imbriquez des minipages, alors il y a une bizarrerie dans -l’utilisation des note <literal>\footnote</literal>. Les notes apparaissement au bas +l’utilisation des notes <literal>\footnote</literal>. Les notes apparaissement au bas du texte terminé par la prochaine <literal>\end{minipage}</literal> ce qui n’est peut-être pas leur place logique. </para> @@ -5004,7 +5382,7 @@ graphique. Ils sont verticalement centrés. <indexterm role="fn"><primary><literal>siunitx</literal>, paquetage</primary></indexterm> <screen>% siunitx permet d'avoir le type de colonne S dans les tableaux, pour l'alignement -% et le séparateur décimal +% sur le séparateur décimal, réglé comme virgule. \usepackage[output-decimal-marker={,}]{siunitx} \newcommand*{\vcenteredhbox}[1]{\begin{tabular}{@{}c@{}}#1\end{tabular}} ... @@ -5013,7 +5391,10 @@ graphique. Ils sont verticalement centrés. \hspace{0.1\textwidth} \begin{minipage}{0.5\textwidth} \begin{tabular}{r|S} - \multicolumn{1}{r}{Quartier} &Pop. (million) \\ \hline + % \multicolumn pour supprimer la barre verticale entre les titres de colonnes + \multicolumn{1}{r}{Quartier} & + % les accolades empèchent siunitx de voir le point comme un séparateur décimal + {Pop. (million)} \\ \hline The Bronx &1.5 \\ Brooklyn &2.6 \\ Manhattan &1.6 \\ @@ -5035,208 +5416,269 @@ graphique. Ils sont verticalement centrés. <para>Synopsis : </para> <screen>\begin{picture}(<replaceable>largeur</replaceable>,<replaceable>hauteur</replaceable>) -… <replaceable>commandes picture</replaceable> … + <replaceable>commande picture</replaceable> \end{picture} </screen> <para>ou </para> <screen>\begin{picture}(<replaceable>largeur</replaceable>,<replaceable>hauteur</replaceable>)(<replaceable>décalagex</replaceable>,<replaceable>décalagey</replaceable>) -… <replaceable>commandes picture</replaceable> … + <replaceable>commande picture</replaceable> \end{picture} </screen> - -<indexterm role="fn"><primary>\unitlength</primary></indexterm> +<para>où on a autant de <replaceable>commande picture</replaceable>(s) qu’on le désire. +</para> <para>L’environnement <literal>picture</literal> vous permet de créer des dessins simples contenant des lignes, des flèches, des boîtes, des cercles, et du texte. Cet environnement n’est pas obsolète, mais les nouveaux documents -utilisent typiquelent des systèmes de création de graphiques bien plus -puissants tels que TikZ, PStricks, MetaPost, ou Asymptote. Ceux-ci ne -sont pas couverts dans ce documents ; voir le CTAN. +utilisent typiquement des systèmes de création de graphiques bien plus +puissants tels que TikZ, PStricks, MetaPost, ou Asymptote. Aucun de +ceux-ci n’est couvert dans ce document ; voir le CTAN. </para> -<!-- xxx Revoir la trad. --> -<para>Vous dîtes à &latex; où mettre les chose dans le dessin en spécifiant -leur coordonnées. Une coordonnée est un nombre qui peut avoir une -séparateur décimal (point et non virgule) et un signe moins — un -nombre comme <literal>5</literal>, <literal>0.3</literal> ou <literal>-3.1416</literal>. Une coordonnées -spécifie une longueur en multiples de l’unité de longueur -<literal>\unitlength</literal>, ainsi si <literal>\unitlength</literal> a été réglée à -<literal>1cm</literal>, alors la coordonnée 2.54 spécifie une longueur de 2,54 -centimètres. -</para> -<para>Vous devriez changer la valeur de <literal>\unitlength</literal>, en utilisant la -commande <literal>\setlength</literal>, en dehors d’un environnement -<literal>picture</literal>. La valeur par défaut est <literal>1pt</literal>. -</para> -<indexterm role="fn"><primary>paquetage <literal>picture</literal></primary></indexterm> -<indexterm role="fn"><primary><literal>picture</literal>, paquetage</primary></indexterm> - -<para>Le paquetage <literal>picture</literal> redéfinit l’environnement <literal>picture</literal> de -sorte qu’où que soit utilisé un nombre au sein de <replaceable>commandes picture</replaceable> -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 <literal>\unitlength</literal>. -</para> -<indexterm role="cp"><primary>position, dans un dessin <literal>picture</literal></primary></indexterm> -<para>Une <firstterm>position</firstterm> est une paire de coordonnées, telle que -<literal>(2.4,-5)</literal>, ce qui spécifie un point d’abscisse <literal>2.4</literal> et -d’ordonnée <literal>-5</literal>. 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. +<para>Pour commencer, voici un exemple illustant la méthode du parallélogramme +pour additionner deux vecteurs. </para> +<indexterm role="fn"><primary>\unitlength</primary></indexterm> +<screen>\setlength{\unitlength}{1cm} +\begin{picture}(6,6) % la boîte de l'image fera 6cm de large sur 6cm de haut + \put(0,0){\vector(2,1){4}} % la pente du vecteur est de 1/2 + \put(2,1){\makebox(0,0)[l]{\ premier terme}} + \put(4,2){\vector(1,2){2}} + \put(5,4){\makebox(0,0)[l]{\ second terme}} + \put(0,0){\vector(1,1){6}} + \put(3,3){\makebox(0,0)[r]{somme\ }} +\end{picture} +</screen> <para>L’environnement <literal>picture</literal> a un argument obligatoire qui est une -position (<replaceable>largeur</replaceable>,<replaceable>hauteur</replaceable>) qui spécifie la taille du dessin. -L’environnement produit une boîte rectangulaire dont les dimensions sont -cette <replaceable>largeur</replaceable> et cette <replaceable>hauteur</replaceable>. -</para> -<para>L’environnement <literal>picture</literal> a aussi un argument optionnel de position -(<replaceable>décalagex</replaceable>,<replaceable>décalagey</replaceable>), 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 -<literal>\unitlength</literal> a été réglée à <literal>1mm</literal>, la commande +pair de nombres réels positifs (<replaceable>largeur</replaceable>,<replaceable>hauteur</replaceable>). Le point +est utilisée comme séparateur décimal quand il ne sont pas entiers. En +les multipliant par <literal>\unitlength</literal> on obtient la taille nominale de +la sortie, c-à-d. l’espace que &latex; reserve sur la page en +sortie. Cette taille nominale n’est pas nécessairement la taille réelle +de l’image ; &latex; dessine aussi les parties de l’image en dehors de +la boîte de l’image. +</para> +<para>L’environnement <literal>picture</literal> a aussi un argument optionnel +(<replaceable>décalagex</replaceable>,<replaceable>décalagey</replaceable>). Il sert à décaler l’origine. +Contrairement aux arguments optionnels ordinaire, cet argument n’est pas +contenu entre crochets. Comme pour l’argument obligatoire, c’est une +paire de deux nombres. En les multipliant par <literal>\unitlength</literal> on +obtient les coordonnées du point dans le coin inférieur gauche de l’image. +</para> +<para>Par exemple, si <literal>\unitlength</literal> a été réglée à <literal>1mm</literal>, la +commande </para> <screen>\begin{picture}(100,200)(10,20) </screen> <para>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 +millimetres. Son origine est le point (10mm,20mm) et donc le coin +inférieur gauche est là, et le coin supérieur droit est à (110mm,220mm). +Lorsque vous tracez 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é. </para> -<para>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. +<indexterm role="cp"><primary>position dans picture</primary></indexterm> +<para>Chaque <replaceable>commande picture</replaceable> dit à &latex; où placer quelque chose en +donnant sa position. Une <firstterm>position</firstterm> est une paire telle que +<literal>(2.4,-5)</literal> donnant les coordonnées en x et en y. Une +<firstterm>coordonnée</firstterm> n’est pas une longueur, c’est un nombre réel (il +utilise le point ‘<literal>.</literal>’ comme séparateur décimal et peut avoir un +signe moins). Elle spécifie une longueur en terme de la longueur unité +<literal>\unitlength</literal>, de sorte que si <literal>\unitlength</literal> a été réglée à +<literal>1cm</literal>, alors la coordonnées ‘<literal>2.54</literal>’ spécifie une longueur de +2,54 centimètres. +</para> +<para>La valeur par défaut de &latex; pour <literal>\unitlength</literal> est +<literal>1pt</literal>. C’est une longueur rigide (voir <link linkend="Lengths">Lengths</link>). Utilisez la +commande <literal>\setlength</literal> pour la modifier +(voir <link linkend="_005csetlength">\setlength</link>). Effectuez ce changement uniquement en dehors de +l’environnement <literal>picture</literal>. +</para> +<para>L’environnement <literal>picture</literal> prend en charge les expressions +arithmétiques standardes en plus des nombres. +</para> +<para>Les coordonnées sont données relarivement à une origine, qui est par +défaut au coin en bas à gauche de l’image. Notez que lorsque une +position apparaît en tant qu’argument, comme dans +<literal>\put(1,2){...}</literal>, elle n’est pas entourées d’accolades puisque +les parenthèses servent à délimiter l’argument. De même, contrairement à +certain système de dessin par ordinateur, l’axe des ordonnées y est +orienté vers le haut de la page, c-à-d. que <inlineequation><mathphrase>y = 1</mathphrase></inlineequation> est +<emphasis>au-dessus</emphasis> de <inlineequation><mathphrase>y = 0</mathphrase></inlineequation>. </para> -<para>Tout ce qui apparaît dans un dessin <literal>picture</literal> est dessiné par la -commande <literal>\put</literal>. La commande +<para>Il y a quatre manières de placer des chose dans une image : <literal>\put</literal>, +<literal>\multiput</literal>, <literal>\qbezier</literal>, et <literal>\graphpaper</literal>. La plus +utilisée est <literal>\put</literal>. Le code suivant </para> + <screen>\put (11.3,-.3){...} </screen> -<para>met l’objet spécifié par <literal>...</literal> dans le dessin <literal>picture</literal>, avec sont +<para>met l’objet spécifié par <literal>...</literal> dans le dessin <literal>picture</literal>, avec son point de référence aux coordonnées <inlineequation><mathphrase>(11.3,-.3)</mathphrase></inlineequation>. Les points de référence des divers objets sont décrits plus bas. </para> <indexterm role="fn"><primary>lR box</primary></indexterm> <para>La commande <literal>\put</literal> crée une <firstterm>LR box</firstterm>. Vous pouvez mettre tout -ce qui peut aller dans une <literal>\mbox</literal> (see <link linkend="_005cmbox">\mbox</link>) dans l’argument +ce qui peut aller dans une <literal>\mbox</literal> (voir <link linkend="_005cmbox-_0026-_005cmakebox">\mbox & \makebox</link>) dans l’argument texte de la commande <literal>\put</literal>. Quand vous faites cela, le point de -référence devient le coin inférieur gauche de la boîte . +référence devient le coin inférieur gauche de la boîte. Dans cette image : +</para> +<screen>\setlength{\unitlength}{1cm} +...\begin{picture}(1,1) + \put(0,0){\line(1,0){1}} + \put(0,0){\line(1,1){1}} +\end{picture} +</screen> +<para>les trois sont juste légèrement à la gauche du point où forment un angle +les deux lignes. (À noter aussi que <literal>\line(1,1){1}</literal> ne demande +pas une ligne de longueur un, mais une ligne dont l’étendu selon la +coordonnée x est de 1). +</para> +<para>Les cmmandes <literal>\multiput</literal>, <literal>qbezier</literal>, et <literal>graphpaper</literal> sont +décrite plus bas. +</para> +<para>Vous pouvez également utiliser cet envionnement pour placer une matière +quelconque à un emplacement exact. Par exemple : </para> -<para>Les commandes <literal>picture</literal> sont décrites dans les rubriques suivantes. +<screen>\usepackage{color,graphicx} % dans le préambule + ... +\begin{center} +\setlength{\unitlength}{\textwidth} +\begin{picture}(1,1) % reserve un espace large et haut de \textwidth + \put(0,0){\includegraphics[width=\textwidth]{desertedisland.jpg}} + \put(0.25,0.35){\textcolor{red}{X Trésor ici}} +\end{picture} +\end{center} +</screen> +<para>Le X rouge sera précisément à un quart de <literal>\textwidth</literal> à droite de +la marge de gauche, et <literal>0.35\textwidth</literal> au dessus du bas de +l’image. Un autre exemple de cet utilisation est de placer un code +similaire dans l’en-tête de page pour obtenir une matière répétée sur +chaque page. </para> -<sect2 label="8.19.1" id="_005ccircle"> -<title><literal>\circle</literal></title> -<indexterm role="fn"><primary>\circle</primary></indexterm> +<sect2 label="8.19.1" id="_005cput"> +<title><literal>\put</literal></title> +<indexterm role="fn"><primary>\put</primary></indexterm> -<para>Synopsis : -</para><screen>\circle{<replaceable>diamètre</replaceable>} -\circle*{<replaceable>diamètre</replaceable>} -</screen> -<para>La commande <literal>\circle</literal> produit un cercle dont le diamètre est le -plus proche possible de celui spécifié. La forme étoilée (en <literal>*</literal>) -de la commande dessine un disque, c.-à-d. un cercle plein. +<para><literal>\put(<replaceable>xcoord</replaceable>,<replaceable>ycoord</replaceable>){ ... }</literal> </para> -<para>Des cercles jusqu’à 40pt peuvent être dessinés. +<para>La commande <literal>\put</literal> place l’article spécifié par l’argument +obligatoire aux coordonnées <replaceable>xcoord</replaceable> et <replaceable>ycoord</replaceable> fournies. </para> </sect2> -<sect2 label="8.19.2" id="_005cmakebox-_0028picture_0029"> -<title><literal>\makebox</literal></title> -<indexterm role="fn"><primary>\makebox (<literal>picture</literal>)</primary></indexterm> +<sect2 label="8.19.2" id="_005cmultiput"> +<title><literal>\multiput</literal></title> +<indexterm role="fn"><primary>\multiput</primary></indexterm> <para>Synopsis : -</para><screen>\makebox(<replaceable>largeur</replaceable>,<replaceable>hauteur</replaceable>)[<replaceable>position</replaceable>]{<replaceable>texte</replaceable>} +</para><screen>\multiput(<replaceable>x</replaceable>,<replaceable>y</replaceable>)(<replaceable>delta_x</replaceable>,<replaceable>delta_y</replaceable>){<replaceable>n</replaceable>}{<replaceable>obj</replaceable>} </screen> -<para>La commande <literal>\makebox</literal> pour l’environnement <literal>picture</literal> est -similaire à la commande normale <literal>\makebox</literal> à ceci près que vous -devez spécifier une <replaceable>largeur</replaceable> et une <replaceable>hauteur</replaceable> implicitement -multipliés par <literal>\unitlength</literal>. -</para> -<para>L’argument optionnel, <literal>[<replaceable>position</replaceable>]</literal>, spécifie le quadrant dans -lequel votre <replaceable>texte</replaceable> apparaît. Vous pouvez sélectionner jusqu’à deux -spécificateurs parmi les suivants : -</para> -<variablelist><varlistentry><term><literal>t</literal> -</term><listitem><para>Place l’article au sommet du rectangle. -</para> -</listitem></varlistentry><varlistentry><term><literal>b</literal> -</term><listitem><para>Place l’article en bas du rectangle. -</para> -</listitem></varlistentry><varlistentry><term><literal>l</literal> -</term><listitem><para>Place l’article sur la gauche. -</para> -</listitem></varlistentry><varlistentry><term><literal>r</literal> -</term><listitem><para>Place l’article sur la droite. -</para> -</listitem></varlistentry></variablelist> -<para>See <link linkend="_005cmakebox">\makebox</link>. +<para>La commande <literal>\multiput</literal> copie l’objet <replaceable>obj</replaceable> en un motif +régulier à travers la figure. <replaceable>obj</replaceable> est placé en premier à la +position <inlineequation><mathphrase>(x,y)</mathphrase></inlineequation>, puis à la position <inlineequation><mathphrase>(x+\delta x,y+\delta +y)</mathphrase></inlineequation>, et ainsi de suite, <replaceable>n</replaceable> fois. </para> - </sect2> -<sect2 label="8.19.3" id="_005cframebox-_0028picture_0029"> -<title><literal>\framebox</literal></title> -<indexterm role="fn"><primary>\framebox</primary></indexterm> +<sect2 label="8.19.3" id="_005cqbezier"> +<title><literal>\qbezier</literal></title> + +<indexterm role="fn"><primary>\qbezier</primary></indexterm> <para>Synopsis : </para> -<screen>\framebox(<replaceable>largeur</replaceable>,<replaceable>hauteur</replaceable>)[<replaceable>pos</replaceable>]{...} +<screen>\qbezier(<replaceable>x1</replaceable>,<replaceable>y1</replaceable>)(<replaceable>x2</replaceable>,<replaceable>y2</replaceable>)(<replaceable>x3</replaceable>,<replaceable>y3</replaceable>) +\qbezier[<replaceable>quant</replaceable>](<replaceable>x1</replaceable>,<replaceable>y1</replaceable>)(<replaceable>x2</replaceable>,<replaceable>y2</replaceable>)(<replaceable>x3</replaceable>,<replaceable>y3</replaceable>) +</screen> +<para>Dessing une courbe de Bézier quadratique dont les points de contrôle +sont donnés par les trois arguments obligatoire +<literal>(<replaceable>x1</replaceable>,<replaceable>y1</replaceable>)</literal>, <literal>(<replaceable>x2</replaceable>,<replaceable>y2</replaceable>)</literal>, et +<literal>(<replaceable>x3</replaceable>,<replaceable>y3</replaceable>)</literal>. C-à-d. que la courbe va de <replaceable>(x1,y1)</replaceable> +à <replaceable>(x3,y3)</replaceable>, est quadratique, et est telle que la tangente en +<replaceable>(x1,y1)</replaceable> passe par <replaceable>(x2,y2)</replaceable>, et de même pour la tangente en +<replaceable>(x3,y3)</replaceable>. +</para> +<para>L’exemple suivant dessine une courbre des coordonnées (1,1) à (1,0). +</para> +<screen>\qbezier(1,1)(1.25,0.75)(1,0) +</screen> +<para>La tangente de la coubre en (1,1) passe par (1.25,0.75), et la tangent +en (1,0) fait de même. +</para> +<para>L’argument optionnel <replaceable>quant</replaceable> donne le nombre de points +intermédiaires calculés. Par défaut une courbe liste est dessinée dont +le nombre maximum de points est <literal>\qbeziermax</literal> (on change cette +valeur avec <literal>\renewcommand</literal>). +</para> +<para>L’exempel suivante dessine un rectangle avec un haut ondulé, en +utilisant <literal>\qbezier</literal> pour cette courbe. +</para> +<screen>\begin{picture}(8,4) + \put(0,0){\vector(1,0){8}} % axe des x + \put(0,0){\vector(0,1){4}} % axe des y + \put(2,0){\line(0,1){3}} % côté gauche + \put(4,0){\line(0,1){3.5}} % côté droit + \qbezier(2,3)(2.5,2.9)(3,3.25) + \qbezier(3,3.25)(3.5,3.6)(4,3.5) + \thicklines % ci-dessous, les lignes sont deux fois plus épaisses + \put(2,3){\line(4,1){2}} + \put(4.5,2.5){\framebox{Trapezoidal Rule}} +\end{picture} </screen> -<para>La commande <literal>\framebox</literal> est similaire à <literal>\makebox</literal> (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. -</para> -<indexterm role="fn"><primary>\fboxrule</primary></indexterm> -<indexterm role="fn"><primary>\fboxsep</primary></indexterm> -<para>La commande <literal>\framebox</literal> produit un filet d’épaisseur -<literal>\fboxrule</literal>, et laisse un espace <literal>\fboxsep</literal> entre le filet et -le contenu de la boîte. -</para> - </sect2> -<sect2 label="8.19.4" id="_005cdashbox"> -<title><literal>\dashbox</literal></title> +<sect2 label="8.19.4" id="_005cgraphpaper"> +<title><literal>\graphpaper</literal></title> -<indexterm role="fn"><primary>\dashbox</primary></indexterm> - -<para>Dessine une boîte avec une ligne en tireté. Synopsis : +<indexterm role="fn"><primary>\graphpaper</primary></indexterm> +<para>Synopsis : </para> -<screen>\dashbox{<replaceable>tlong</replaceable>}(<replaceable>rlargeur</replaceable>,<replaceable>rhauteur</replaceable>)[<replaceable>pos</replaceable>]{<replaceable>texte</replaceable>} +<screen>\graphpaper(<replaceable>x_init</replaceable>,<replaceable>y_init</replaceable>)(<replaceable>x_dimen</replaceable>,<replaceable>y_dimen</replaceable>) +\graphpaper[<replaceable>espacement</replaceable>](<replaceable>x_init</replaceable>,<replaceable>y_init</replaceable>)(<replaceable>x_dimen</replaceable>,<replaceable>y_dimen</replaceable>) </screen> -<para><literal>\dashbox</literal> crée un rectangle en tireté autour de <replaceable>texte</replaceable> au -sein d’un environnement <literal>picture</literal>. Les tirets sont long de -<replaceable>tlong</replaceable> unités, et le rectangle a pour largeur totale <replaceable>rlargeur</replaceable> -et hauteur totale <replaceable>rhauteur</replaceable>. Le <replaceable>texte</replaceable> est positionné par l’argument -optionnel <replaceable>pos</replaceable>. <!-- xxref positions. --> +<indexterm role="fn"><primary>paquetage <literal>graphpap</literal></primary></indexterm> +<indexterm role="fn"><primary><literal>graphpap</literal>, paquetage</primary></indexterm> + +<para>Dessine un quadrillage. Le paquetage <filename>graphpap</filename> est nécessaire. +L’origine du quadrillage est <literal>(<replaceable>x_init</replaceable>,<replaceable>y_init</replaceable>)</literal>. +Les lignes de la grille sont espacées de <replaceable>espacement</replaceable> unités (par défaut 10). +Le quadrillage s’étend sur <replaceable>x_dimen</replaceable> unités vers la droite et <replaceable>y_dimen</replaceable> vers le haut. +Tous les arguments doivent être des entiers positifs. </para> -<para>Une boîte en tireté a meilleure allure quand les paramètres -<replaceable>rlargeur</replaceable> et <replaceable>rhauteur</replaceable> sont des multiple de <replaceable>tlong</replaceable>. +<para>L’exemple ci-dessous fait une grille avec sept lignes verticales et onze +horizontales. +</para> +<screen>\usepackage{graphpap} % dans le préambule + ... +\begin{picture}(6,20) % dans le corps du document + \graphpaper[2](0,0)(12,20) +\end{picture} +</screen> +<para>Les lignes sont numérotées toutes les dix unités. </para> </sect2> -<sect2 label="8.19.5" id="_005cframe"> -<title><literal>\frame</literal></title> -<indexterm role="fn"><primary>\frame</primary></indexterm> +<sect2 label="8.19.5" id="_005ccircle"> +<title><literal>\circle</literal></title> +<indexterm role="fn"><primary>\circle</primary></indexterm> <para>Synopsis : +</para><screen>\circle{<replaceable>diamètre</replaceable>} +\circle*{<replaceable>diamètre</replaceable>} +</screen> +<para>La commande <literal>\circle</literal> produit un cercle dont le diamètre est le +plus proche possible de celui spécifié. La forme étoilée (en <literal>*</literal>) +de la commande dessine un disque, c.-à-d. un cercle plein. </para> -<screen>\frame{<replaceable>texte</replaceable>} +<para>L’exemple suivant trace un cerrcle de rayon 6, centré en <literal>(5,7)</literal>. +</para> +<screen>\put(5,7){\circle{6}} </screen> -<para>La commande <literal>\frame</literal> met un cadre rectangulaire autour de -<replaceable>texte</replaceable>. 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 -<replaceable>texte</replaceable>. +<para>Les rayons disponible pour <literal>circle</literal> sont, en points, les nombres +pair de 2 à 20 inclus. Pour <literal>\circle*</literal> ce sont tous les entiers de +1 à 15. </para> - </sect2> <sect2 label="8.19.6" id="_005cline"> <title><literal>\line</literal></title> @@ -5249,8 +5691,8 @@ cadre. Aucun espace supplémentaire n’est mis entre le cadre et l’ob <para>Dessine une ligne. Sa pente est telle que la ligne monte de <replaceable>ypente</replaceable> verticalement pour toute avancée horizontale de <replaceable>xpente</replaceable>. L’<replaceable>excursion</replaceable> est le déplacement horizontal total — -ce n’est pas la longueur du vecteur, mais la variation en <inlineequation><mathphrase>x</mathphrase></inlineequation>. Da,s -me cas spécial des ligne vertical, où (<replaceable>xpente</replaceable>,<replaceable>ypente</replaceable>)=(0,1), +ce n’est pas la longueur du vecteur, mais la variation en <inlineequation><mathphrase>x</mathphrase></inlineequation>. Dans +le cas spécial des lignes verticales, où (<replaceable>xpente</replaceable>,<replaceable>ypente</replaceable>)=(0,1), l’<replaceable>excursion</replaceable> donne le déplacement en <inlineequation><mathphrase>y</mathphrase></inlineequation>. </para> <para>L’exemple suivant dessine une ligne commençant aux coordonnées (1,3). @@ -5308,6 +5750,7 @@ formes dans un système tel que <literal>picture</literal>, voir le paquetage est d’utiliser un système graphique complet tel que TikZ, PSTricks, MetaPost, ou Asymptote. </para> + </sect2> <sect2 label="8.19.7" id="_005clinethickness"> <title><literal>\linethickness</literal></title> @@ -5343,21 +5786,7 @@ cf. <link linkend="_005clinethickness">\linethickness</link> et <link linkend=" </para> </sect2> -<sect2 label="8.19.10" id="_005cmultiput"> -<title><literal>\multiput</literal></title> -<indexterm role="fn"><primary>\multiput</primary></indexterm> - -<para>Synopsis : -</para><screen>\multiput(<replaceable>x</replaceable>,<replaceable>y</replaceable>)(<replaceable>delta_x</replaceable>,<replaceable>delta_y</replaceable>){<replaceable>n</replaceable>}{<replaceable>obj</replaceable>} -</screen> -<para>La commande <literal>\multiput</literal> copie l’objet <replaceable>obj</replaceable> en un motif -régulier à travers la figure. <replaceable>obj</replaceable> est placé en premier à la -position <inlineequation><mathphrase>(x,y)</mathphrase></inlineequation>, puis à la position <inlineequation><mathphrase>(x+\delta x,y+\delta -y)</mathphrase></inlineequation>, et ainsi de suite, <replaceable>n</replaceable> fois. -</para> - -</sect2> -<sect2 label="8.19.11" id="_005coval"> +<sect2 label="8.19.10" id="_005coval"> <title><literal>\oval</literal></title> <indexterm role="fn"><primary>\oval</primary></indexterm> @@ -5387,17 +5816,7 @@ ressembleront plus à des boîtes aux coins arrondis. </para> </sect2> -<sect2 label="8.19.12" id="_005cput"> -<title><literal>\put</literal></title> -<indexterm role="fn"><primary>\put</primary></indexterm> - -<para><literal>\put(<replaceable>xcoord</replaceable>,<replaceable>ycoord</replaceable>){ ... }</literal> -</para> -<para>La commande <literal>\put</literal> place l’article spécifié par l’argument -obligatoire aux coordonnées <replaceable>xcoord</replaceable> et <replaceable>ycoord</replaceable> fournies. -</para> -</sect2> -<sect2 label="8.19.13" id="_005cshortstack"> +<sect2 label="8.19.11" id="_005cshortstack"> <title><literal>\shortstack</literal></title> <indexterm role="fn"><primary>\shortstack</primary></indexterm> @@ -5420,7 +5839,7 @@ sont : </para> </sect2> -<sect2 label="8.19.14" id="_005cvector"> +<sect2 label="8.19.12" id="_005cvector"> <title><literal>\vector</literal></title> <indexterm role="fn"><primary>\vector</primary></indexterm> @@ -5433,8 +5852,94 @@ sont : spécifiées. Les valeurs de <inlineequation><mathphrase><replaceable>xpente</replaceable></mathphrase></inlineequation> et <inlineequation><mathphrase><replaceable>ypente</replaceable></mathphrase></inlineequation> doivent être comprises entre −4 and +4 y compris. </para> +</sect2> +<sect2 label="8.19.13" id="_005cmakebox-_0028picture_0029"> +<title><literal>\makebox</literal></title> +<indexterm role="fn"><primary>\makebox (<literal>picture</literal>)</primary></indexterm> + +<para>Synopsis : +</para><screen>\makebox(<replaceable>largeur</replaceable>,<replaceable>hauteur</replaceable>)[<replaceable>position</replaceable>]{<replaceable>texte</replaceable>} +</screen> +<para>La commande <literal>\makebox</literal> pour l’environnement <literal>picture</literal> est +similaire à la commande normale <literal>\makebox</literal> à ceci près que vous +devez spécifier une <replaceable>largeur</replaceable> et une <replaceable>hauteur</replaceable> implicitement +multipliés par <literal>\unitlength</literal>. +</para> +<para>L’argument optionnel, <literal>[<replaceable>position</replaceable>]</literal>, spécifie le quadrant dans +lequel votre <replaceable>texte</replaceable> apparaît. Vous pouvez sélectionner jusqu’à deux +spécificateurs parmi les suivants : +</para> +<variablelist><varlistentry><term><literal>t</literal> +</term><listitem><para>Place l’article au sommet du rectangle. +</para> +</listitem></varlistentry><varlistentry><term><literal>b</literal> +</term><listitem><para>Place l’article en bas du rectangle. +</para> +</listitem></varlistentry><varlistentry><term><literal>l</literal> +</term><listitem><para>Place l’article sur la gauche. +</para> +</listitem></varlistentry><varlistentry><term><literal>r</literal> +</term><listitem><para>Place l’article sur la droite. +</para> +</listitem></varlistentry></variablelist> +<para>Voir <link linkend="_005cmbox-_0026-_005cmakebox">\mbox & \makebox</link>. +</para> + +</sect2> +<sect2 label="8.19.14" id="_005cframebox-_0028picture_0029"> +<title><literal>\framebox</literal></title> +<indexterm role="fn"><primary>\framebox</primary></indexterm> + +<para>Synopsis : +</para> +<screen>\framebox(<replaceable>largeur</replaceable>,<replaceable>hauteur</replaceable>)[<replaceable>pos</replaceable>]{...} +</screen> +<para>La commande <literal>\framebox</literal> est similaire à <literal>\makebox</literal> (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. +</para> +<indexterm role="fn"><primary>\fboxrule</primary></indexterm> +<indexterm role="fn"><primary>\fboxsep</primary></indexterm> +<para>La commande <literal>\framebox</literal> produit un filet d’épaisseur +<literal>\fboxrule</literal>, et laisse un espace <literal>\fboxsep</literal> entre le filet et +le contenu de la boîte. +</para> </sect2> +<sect2 label="8.19.15" id="_005cframe"> +<title><literal>\frame</literal></title> +<indexterm role="fn"><primary>\frame</primary></indexterm> + +<para>Synopsis : +</para> +<screen>\frame{<replaceable>texte</replaceable>} +</screen> +<para>La commande <literal>\frame</literal> met un cadre rectangulaire autour de +<replaceable>texte</replaceable>. 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 +<replaceable>texte</replaceable>. +</para> + +</sect2> +<sect2 label="8.19.16" id="_005cdashbox"> +<title><literal>\dashbox</literal></title> + +<indexterm role="fn"><primary>\dashbox</primary></indexterm> + +<para>Dessine une boîte avec une ligne en tireté. Synopsis : +</para> +<screen>\dashbox{<replaceable>tlong</replaceable>}(<replaceable>rlargeur</replaceable>,<replaceable>rhauteur</replaceable>)[<replaceable>pos</replaceable>]{<replaceable>texte</replaceable>} +</screen> +<para><literal>\dashbox</literal> crée un rectangle en tireté autour de <replaceable>texte</replaceable> au +sein d’un environnement <literal>picture</literal>. Les tirets sont long de +<replaceable>tlong</replaceable> unités, et le rectangle a pour largeur totale <replaceable>rlargeur</replaceable> +et hauteur totale <replaceable>rhauteur</replaceable>. Le <replaceable>texte</replaceable> est positionné par l’argument +optionnel <replaceable>pos</replaceable>. <!-- xxref positions. --> +</para> +<para>Une boîte en tireté a meilleure allure quand les paramètres +<replaceable>rlargeur</replaceable> et <replaceable>rhauteur</replaceable> sont des multiple de <replaceable>tlong</replaceable>. +</para> +</sect2> </sect1> <sect1 label="8.20" id="quotation-_0026-quote"> <title><literal>quotation</literal> et <literal>quote</literal></title> @@ -5455,13 +5960,13 @@ doivent être comprises entre −4 and +4 y compris. <para>Synopsis : </para> <screen>\begin{quotation} -<replaceable>texte</replaceable> + <replaceable>texte</replaceable> \end{quotation} </screen> <para>ou </para> <screen>\begin{quote} -<replaceable>texte</replaceable> + <replaceable>texte</replaceable> \end{quote} </screen> <para>Cite du texte. @@ -5482,10 +5987,10 @@ renfoncement plutôt que par une séparation verticale. De plus, <literal>quote</literal> convient mieux pour des citations courtes ou une suite de citations courtes. </para> -<screen>\begin{quotation} -\it Il y a quatre-vingt sept ans +<screen>\begin{quotation} \small\it + Il y a quatre-vingt sept ans ... ne disparaîtra jamais de la surface de la terre. -\hspace{1em plus 1fill}---Abraham Lincoln + \hspace{1em plus 1fill}--- Abraham Lincoln \end{quotation} </screen> </sect1> @@ -5502,37 +6007,108 @@ citations courtes. <para>Synopsis : </para> <screen>\begin{tabbing} -<replaceable>row1col1</replaceable> \= <replaceable>row1col2</replaceable> \= <replaceable>row1col3</replaceable> \= <replaceable>row1col4</replaceable> \\ -<replaceable>row2col1</replaceable> \> \> <replaceable>row2col3</replaceable> \\ +<replaceable>lgn1col1</replaceable> \= <replaceable>lgn1col2</replaceable> ... \\ +<replaceable>lgn2col1</replaceable> \> <replaceable>lgn2col2</replaceable> ... \\ ... \end{tabbing} </screen> <para>L’environnement <literal>tabbing</literal> fournit une technique pour aligner du texte en colonnes. Il fonctionne en réglant des taquets et en tabulant jusqu’à eux à la façon dont on le faisait avec une machine à écrire -ordinaire. Il convient le mieux pour les cas où la largeur de chaque -colonne est constante et connue d’avance. +ordinaire. </para> -<para>Cet environnement peut être rompu entre plusieurs pages, contrairement à -l’environnement <literal>tabular</literal>. +<indexterm role="fn"><primary>paquetage <literal>algorithm2e</literal></primary></indexterm> +<indexterm role="fn"><primary><literal>algorithm2e</literal>, paquetage</primary></indexterm> + +<indexterm role="fn"><primary>paquetage <literal>listings</literal></primary></indexterm> +<indexterm role="fn"><primary><literal>listings</literal>, paquetage</primary></indexterm> +<indexterm role="fn"><primary>paquetage <literal>minted</literal></primary></indexterm> +<indexterm role="fn"><primary><literal>minted</literal>, paquetage</primary></indexterm> +<indexterm role="fn"><primary>paquetage <literal>fancyvrb</literal></primary></indexterm> +<indexterm role="fn"><primary><literal>fancyvrb</literal>, paquetage</primary></indexterm> + +<indexterm role="fn"><primary>paquetage <literal>longtable</literal></primary></indexterm> +<indexterm role="fn"><primary><literal>longtable</literal>, paquetage</primary></indexterm> + +<para>L’environnement <literal>tabbing</literal> est peu utilisé, car en général, pour +formatter du code informatique on utilise un environnement verbatim +(voir <link linkend="verbatim">verbatim</link>). À noter également, pour mettre en vedette la +syntaxe, les paquetages <filename>algorithm2e</filename> pour du pseudo-code, et +<literal>fancyvrb</literal>, <literal>listings</literal> ou <literal>minted</literal> pour du vrai code. +Et pour faire un tableau, on préfère les environnements <literal>tabular</literal> +(voir <link linkend="tabular">tabular</link>) ou <literal>array</literal> (voir <link linkend="array">array</link>) pour un petit tableau +qu’on met dans un flottant <literal>table</literal> (voir <link linkend="table">table</link>) et +l’environnement <literal>longtable</literal> fourni par le paquetage +<filename>longtable</filename> pour un tableau pouvant être coupé sur plusieurs pages. +</para> +<para>La description suivante n’est donc fournie que être complet. +</para> +<para>Dans l’exemple suivant la première ligne sert à régler les taquets à des +largeurs explicites, elle se termine par une commande <literal>\kill</literal> +(décrite plus bas) : +</para> +<screen>\begin{tabbing} +\hspace{3cm}\=\hspace{2.5cm}\=\kill +Navire \>Armement \>Année \\ +\textit{Sophie} \>14 \>1800 \\ +\textit{Polychrest} \>24 \>1803 \\ +\textit{Lively} \>38 \>1804 \\ +\textit{Surprise} \>28 \>1805 \\ +\end{tabbing} +</screen> +<para>Le résultat ressemble à cela : +</para> +<blockquote><informaltable><tgroup cols="3"><colspec colwidth="20*"></colspec><colspec colwidth="17*"></colspec><colspec colwidth="17*"></colspec><tbody><row><entry><para>Navire </para></entry><entry><para>Armement </para></entry><entry><para>Année +</para></entry></row><row><entry><para><emphasis>Sophie</emphasis> </para></entry><entry><para>14 </para></entry><entry><para>1800 +</para></entry></row><row><entry><para><emphasis>Polychrest</emphasis> </para></entry><entry><para>24 </para></entry><entry><para>1803 +</para></entry></row><row><entry><para><emphasis>Lively</emphasis> </para></entry><entry><para>38 </para></entry><entry><para>1804 +</para></entry></row><row><entry><para><emphasis>Surprise</emphasis> </para></entry><entry><para>28 </para></entry><entry><para>1805 +</para></entry></row></tbody></tgroup></informaltable></blockquote> +<para>L’environnement <literal>tabbing</literal> se distingue de <literal>tabular</literal> notamment +parce qu’avec <literal>tabbing</literal> l’utilisateur est obligé de régler la +positions des taquets, et le contenu des colonnes est toujours composé +en mode LR et s’étend sur la colonne suivante s’il est plus large que la +colonne courante, alors qu’avec <literal>tabular</literal>, l’utilisateur peut selon +le spécificateur de colonne, soit composer le contenu des cellules en +mode LR et laisser &latex; déterminer la largeur de colonne +automatiquement pour que le contenu ne sorte jamais de la colonne, soit +fixer la largeur et composer le contenu des cellules dans une +<literal>parbox</literal>. Une autre différence est que <literal>tabular</literal> permet de +faire des filets, notamment de border les colonnes par des filets +verticaux, et d’avoir un espace <literal>\tabcolsep</literal> entre le contenu et la +bordure de colonne. Une autre distinction est que un <literal>tabbing</literal> peut +être coupé sur plusieurs pages, alors que <literal>tabular</literal> génère une +boîte, l’environnement <literal>longtable</literal> du paquetage <filename>longtable</filename> +étant préféré à <literal>tabbing</literal> pour les longs tableaux. +</para> +<para>Finalement, alors que <literal>tabular</literal> peut être utilisé dans n’importe +quel mode, <literal>tabbing</literal> ne peut être utilisé qu’en mode paragraphe, et +il démarre un nouveau paragraphe. +</para> +<para>De plus, comme l’illustre l’exemple donné plus haut, il n’est pas +nécessaire d’utiliser la forme étoilée de la commande <literal>\hspace</literal> au +début d’une ligne tabulée. La marge de droite de l’environnement +<literal>tabbing</literal> est la fin de ligne, de sorte que la largeur de +l’environnement est <literal>\linewidth</literal>. </para> <indexterm role="cp"><primary>ligne tabulée, tabbing</primary></indexterm> <para>L’environnement <literal>tabbing</literal> contient une suite de <firstterm>lignes tabulées</firstterm>, la première ligne tabulée commence immédiatement après <literal>\begin{tabbing}</literal> et chaque ligne se termine par <literal>\\</literal> ou -<literal>\kill</literal>. Il est possible de terminer la dernière ligne juste par -<literal>\end{tabbing}</literal>, ce qui est équivalent à -<literal>\\\end{tabbing}</literal>. +<literal>\kill</literal>. Il est possible d’omettre le <literal>\\</literal> pour la dernière +ligne et de terminer juste par <literal>\end{tabbing}</literal>. </para> <indexterm role="cp"><primary>motif courant de taquets de tabulation, tabbing</primary></indexterm> <para>L’environnement <literal>tabbing</literal> a un <firstterm>motif courant de taquets de -tabulation</firstterm> qui est une séquence de <replaceable>n</replaceable> taquets, avec <inlineequation><mathphrase><replaceable>n</replaceable> > -0</mathphrase></inlineequation>, ce qui crée <replaceable>n</replaceable> colonnes correspondantes. Immédiatement après -<literal>\begin{tabbing}</literal> on a <inlineequation><mathphrase><replaceable>n</replaceable>=1</mathphrase></inlineequation>, c.-à-d. le motif -courant de taquets contient une seul taquet, désigné comme le taquet -N°0, et dont la position est le début de ligne, c.-à-d. que la -première colonne commence au début de la ligne. +tabulation</firstterm> qui est une séquence de <replaceable>n</replaceable> taquets, avec <inlineequation><mathphrase><replaceable>n</replaceable> +> 0</mathphrase></inlineequation>, numérotés 0, 1, etc. Ceci crée <replaceable>n</replaceable> colonnes +correspondantes. Le taquet № 0 est toujours la marge de gauche +définie par l’environnement englobant. Le taquet numéro <replaceable>i</replaceable> est +réglé quand on lui assigne une position horizontale sur la page avec la +commande <literal>\=</literal>. Le taquet numéro <replaceable>i</replaceable> ne peut être réglé que si +les autres taquets 0, …, <inlineequation><mathphrase><replaceable>i</replaceable>-1</mathphrase></inlineequation> ont déjà été réglés. </para> + <indexterm role="cp"><primary>taquet courant, tabbing</primary></indexterm> <para>L’un des taquets du motif courant ayant été réglé comme le <firstterm>taquet courant</firstterm>, par défaut tout texte composé par la suite au sein de @@ -5543,9 +6119,16 @@ colonne courante. La composition est faite en mode LR. <indexterm role="cp"><primary>taquet de début de ligne courant, tabbing</primary></indexterm> <para>Par ailleurs l’environnement <literal>tabbing</literal> a un <firstterm>taquet de début de ligne courant</firstterm>. Par défaut, immédiatement après <literal>\begin{tabbing}</literal> -c’est le taquet N°0, mais cela peut être changé avec les commandes -<literal>\+</literal> et <literal>\-</literal>. Au début de chaque ligne tabulée, le taquet +c’est le taquet № 0, et on peut le changer pour les lignes suivantes +avec les commandes <literal>\+</literal> et <literal>\-</literal>. Au début de chaque ligne tabulée, le taquet courant est initalement égal au taquet de début de ligne courant. +Lorsque le motif de taquets est modifié par une commande <literal>\=</literal>, +alors le taquet de début de ligne redevient le taquet № 0 à partir de la +ligne suivante, à moins qu’une commande <literal>\+</literal> le change de nouveau +avant le changement de ligne par <literal>\\</literal> ou <literal>\kill</literal>. La commande +<literal>\pushtabs</literal> sauvegarde non seulement les positions de taquets, mais +aussi le taquet de début de ligne, et inversement <literal>\poptabs</literal> le +restaure. </para> <para>La marge de droite de l’environnement <literal>tabbing</literal> est la fin de ligne, c.-à-d. que la largeur de l’environnement est de longueur @@ -5553,7 +6136,7 @@ ligne, c.-à-d. que la largeur de l’environnement est de longueur marge de droite, même s’il serait possible avec un peu de calcul d’en définir un à cette position (voir exemples ci-après). </para> -<para>En ce qui concerne la marge de gauche, ou autrement dit le taquet N°0, +<para>En ce qui concerne la marge de gauche, ou autrement dit le taquet № 0, contrairement à l’environnement <literal>tabular</literal>, il n’est pas nécessaire de mettre un <literal>\noindent</literal> devant <literal>\begin{tabbing}</literal> pour éviter un renfoncement : un environnement <literal>tabbing</literal> commence @@ -5561,6 +6144,37 @@ toujours un nouveau paragraphe sans renfoncement. De plus il est inutile d’étoiler une commande <literal>\hspace</literal> en début de ligne tabulée pour que l’espace soit pris en compte. </para> +<para>Normalement, au sein du motif de taquets de tabulation, l’ordre des +taquets correspond à des positions allant de gauche à droite. Il est +cependant possible de positionner n’importe quel taquet, hormis le +taquet № 0 à n’importe quelle position en utilisant des espacements +négatifs ou nuls. En réalité, le fait de ne pas pouvoir changer la +position du taquet № 0 n’est pas restrictif, car on peut utiliser à la +place comme taquet de début de ligne le taquet № 1 grâce à la commande +<literal>\+</literal>. Ainsi dans l’exemple ci-dessous, alors qu’on a le même +contenu de l’environnement <literal>tabbing</literal> que dans l’exemple précédent, +la première et la troisième colonne ont été interverties en changeant +uniquement le motif de taquets dans la première ligne se terminant en +<literal>\kill</literal>. +</para> +<screen>\begin{tabbing} +\hspace{5.5cm}\=\hspace{-2.5cm}\=\hspace{-3cm}\=\+\kill +Navire \>Armement \>Année \\ +\textit{Sophie} \>14 \>1800 \\ +\textit{Polychrest} \>24 \>1803 \\ +\textit{Lively} \>38 \>1804 \\ +\textit{Surprise} \>28 \>1805 \\ +\end{tabbing} +</screen> +<para>Le résultat ressemble donc à cela : +</para> +<blockquote><informaltable><tgroup cols="3"><colspec colwidth="20*"></colspec><colspec colwidth="17*"></colspec><colspec colwidth="17*"></colspec><tbody><row><entry><para>Année </para></entry><entry><para>Armement </para></entry><entry><para>Navire +</para></entry></row><row><entry><para>1800 </para></entry><entry><para>14 </para></entry><entry><para><emphasis>Sophie</emphasis> +</para></entry></row><row><entry><para>1803 </para></entry><entry><para>24 </para></entry><entry><para><emphasis>Polychrest</emphasis> +</para></entry></row><row><entry><para>1804 </para></entry><entry><para>38 </para></entry><entry><para><emphasis>Lively</emphasis> +</para></entry></row><row><entry><para>1805 </para></entry><entry><para>28 </para></entry><entry><para><emphasis>Surprise</emphasis> +</para></entry></row></tbody></tgroup></informaltable></blockquote> + <para>Les commandes suivantes peuvent être utilisées au sein d’un environnement <literal>tabbing</literal> : </para> @@ -5570,46 +6184,49 @@ ligne tabulée commence, et donc le taquet courant redevient le taquet courant de début de ligne. </para> </listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\= (tabbing)</primary></indexterm><literal>\= (tabbing)</literal> -</term><listitem><para>Règle un taquet à la position courante. La <replaceable>n</replaceable>ième commande -<literal>\=</literal> de la ligne tabulée courante définit le taquet N°<replaceable>n</replaceable>, ou -le redéfinit s’il avait été déjà défini dans une ligne tabulée -précédente. Lorsque le nombre de taquets dans le motif courant est -<inlineequation><mathphrase>(<replaceable>n</replaceable>+1)</mathphrase></inlineequation>, c’est à dire qu’on a des taquets N°0 à N°<replaceable>n</replaceable>, -alors la <inlineequation><mathphrase>(<replaceable>n</replaceable>+1)</mathphrase></inlineequation>ième commande <literal>\=</literal> définit le taquet -N°<inlineequation><mathphrase><replaceable>n</replaceable>+1</mathphrase></inlineequation>, ce qui porte le nombre de taquets à -<inlineequation><mathphrase><replaceable>n</replaceable>+2</mathphrase></inlineequation>. La position des taquets peut être définie avec plus de -liberté que ce qui se passait avec un machine à écrire ordinaire. En -effet il est possible de définir à la même position deux taquets de -numéros N°<replaceable>n</replaceable> et N°<replaceable>m</replaceable> distincts, voire de faire en sorte que -les taquets N°<replaceable>n</replaceable> et N°<replaceable>m</replaceable>, avec <inlineequation><mathphrase><replaceable>n</replaceable><<replaceable>m</replaceable></mathphrase></inlineequation>, soient -à des positions telles que le taquet N°<replaceable>m</replaceable> soit avant le taquet -N°<replaceable>n</replaceable>. +</term><listitem><para>Règle le prochain taquet à la position courante, et fait de lui le +taquet courant. Si le taquet courant est le taquet № <replaceable>n</replaceable>, alors une +commande <literal>\=</literal> règle la position du taquet № <inlineequation><mathphrase><replaceable>n</replaceable>+1</mathphrase></inlineequation> et +fait de lui le taquet courant. Si on avait déjà au moins +<inlineequation><mathphrase><replaceable>n</replaceable>+2</mathphrase></inlineequation> taquets, ceci redéfinit la position du taquet +№ <inlineequation><mathphrase><replaceable>n</replaceable>+1</mathphrase></inlineequation>. Sinon, le nombre de taquets dans le motif courant +était à ce moment <inlineequation><mathphrase>(<replaceable>n</replaceable>+1)</mathphrase></inlineequation>, c’est à dire que dernier des +taquets en numéro d’ordre était le № <replaceable>n</replaceable>, alors la commande +<literal>\=</literal> en définissant le taquet № <inlineequation><mathphrase><replaceable>n</replaceable>+1</mathphrase></inlineequation>, porte le nombre +de taquets de <inlineequation><mathphrase><replaceable>n</replaceable>+1</mathphrase></inlineequation> à <inlineequation><mathphrase><replaceable>n</replaceable>+2</mathphrase></inlineequation>. +</para> +<para>La position des taquets peut être définie avec plus de liberté que ce +qui se passait avec un machine à écrire ordinaire. En effet il est +possible de définir à la même position deux taquets de № <replaceable>n</replaceable> et +№ <replaceable>m</replaceable> distincts, voire de faire en sorte que les taquets № <replaceable>n</replaceable> +et № <replaceable>m</replaceable>, avec <inlineequation><mathphrase><replaceable>n</replaceable><<replaceable>m</replaceable></mathphrase></inlineequation>, soient à des positions telles +que le taquet № <replaceable>m</replaceable> soit avant le taquet № <replaceable>n</replaceable>. </para> </listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\> (tabbing)</primary></indexterm><literal>\> (tabbing)</literal> </term><listitem><indexterm role="fn"><primary>\></primary></indexterm> <para>Change le taquet courant au taquet suivant dans l’ordre logique, -c.-à-d. si le taquet courant est le taquet N°<replaceable>n</replaceable>, alors, en +c.-à-d. si le taquet courant est le taquet № <replaceable>n</replaceable>, alors, en supposant qu’il y ait au moins <inlineequation><mathphrase><replaceable>n</replaceable>+2</mathphrase></inlineequation> taquets définis, on -passe au taquets N°<inlineequation><mathphrase><replaceable>n</replaceable>+1</mathphrase></inlineequation>, sinon cette commande provoque une +passe au taquet № <inlineequation><mathphrase><replaceable>n</replaceable>+1</mathphrase></inlineequation>, sinon cette commande provoque une erreur. </para> </listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\<</primary></indexterm><literal>\<</literal> </term><listitem><para>Change le taquet courant au taquet précédent dans l’ordre logique. Cette commande ne peut être utilisée qu’au début d’une ligne tabulée, et que -lorsque le taquet de début de ligne courant est le taquet N°<replaceable>n</replaceable> avec +lorsque le taquet de début de ligne courant est le taquet № <replaceable>n</replaceable> avec <inlineequation><mathphrase><replaceable>n</replaceable>>0</mathphrase></inlineequation>. Le taquet courant devient alors le taquet -N°<inlineequation><mathphrase><replaceable>n</replaceable>-1</mathphrase></inlineequation>. +№ <inlineequation><mathphrase><replaceable>n</replaceable>-1</mathphrase></inlineequation>. </para> <para>Il est en fait possible d’avoir <replaceable>m</replaceable> commandes <literal>\<</literal> consécutives à condition que <inlineequation><mathphrase><replaceable>m</replaceable>≤<replaceable>n</replaceable></mathphrase></inlineequation>, le taquet courant devient -alors le taquet N°<inlineequation><mathphrase>(<replaceable>n</replaceable>-<replaceable>m</replaceable>)</mathphrase></inlineequation>. Si par contre +alors le taquet № <inlineequation><mathphrase>(<replaceable>n</replaceable>-<replaceable>m</replaceable>)</mathphrase></inlineequation>. Si par contre <inlineequation><mathphrase><replaceable>m</replaceable>><replaceable>n</replaceable></mathphrase></inlineequation>, alors la <inlineequation><mathphrase><replaceable>n</replaceable>+1</mathphrase></inlineequation> commande <literal>\<</literal> provoque une erreur. </para> <para>Il est possible, même si c’est absurde, d’avoir ensuite des commandes <literal>\></literal> qui défont ce qu’on fait les commandes <literal>\<</literal>. Ainsi en supposant qu’au début d’une ligne tabulée le taquet de début de ligne -courant soit le taquet N°2, faire commencer la ligne par <literal>\<\<\>\></literal> +courant soit le taquet № 2, faire commencer la ligne par <literal>\<\<\>\></literal> n’a aucun effet. Par contre, <literal>\<\<\<\>\>\></literal> provoquera une erreur, parce que la troisième commande <literal>\<</literal> est illicite. Dans les mêmes conditions faire <literal>\<\>\<\></literal> provoque également une erreur, car la @@ -5623,26 +6240,30 @@ suivent tant qu’une autre commande ne vient pas le modifier. La notion de taquet suivant dans l’ordre logique suit le même principe que pour la commande <literal>\></literal>, c’est à dire que s’il n’y a que <inlineequation><mathphrase><replaceable>n</replaceable>+1</mathphrase></inlineequation> taquets défini, et que le taquet de début de ligne courant est le taquet -N°<replaceable>n</replaceable>, alors cette commande provoque une erreur. La commande +№ <replaceable>n</replaceable>, alors cette commande provoque une erreur. La commande <literal>\+</literal> peut être invoquée n’importe où dans la ligne tabulée, et on peut avoir plusieurs commandes <literal>\+</literal> au sein de la même ligne, du moment que pour chacune d’elle un nombre suffisant de taquets est déjà défini. Par exemple le code suivant provoque une erreur parce que bien qu’à la fin de la première on ait trois taquets définis, au moment où la commande <literal>\+</literal> est invoquée le nombre de taquets définis ne vaut que -1, on ne peut donc pas passer du taquet N°0 au taquet N°1 : -</para><screen>\begin{tabbing} +1, on ne peut donc pas passer du taquet № 0 au taquet № 1 : +</para> +<screen>\begin{tabbing} Vive \+\=la \=France\\ Vive \>la\>République\\ \end{tabbing} -</screen><para>En revanche le code suivant fonctionne, car lorsque la commande -<literal>\+</literal> est passée on a trois taquets définis, les taquets N°0 à 2, on -peut donc passer du taquet N°0 au taquet N°1. -</para><screen>\begin{tabbing} +</screen> +<para>En revanche le code suivant fonctionne, car lorsque la commande +<literal>\+</literal> est passée on a trois taquets définis, les taquets № 0 à 2, on +peut donc passer du taquet № 0 au taquet № 1. +</para> +<screen>\begin{tabbing} Vive \=la \=France\+\\ Vive \>la\>République\\ \end{tabbing} -</screen><para>C’est pourquoi l’usage est que la ou les commandes <literal>\+</literal> sont +</screen> +<para>C’est pourquoi l’usage est que la ou les commandes <literal>\+</literal> sont toujours invoquées juste avant la fin de ligne <literal>\\</literal> ou <literal>\kill</literal>. </para> <para>Il est possible, même si cela est absurde, d’avoir sur la même ligne à @@ -5653,10 +6274,10 @@ du moment qu’aucune d’elle ne fasse passer sur un taquet non défini </term><listitem><para>Change le taquet de début de ligne courant au taquet précédent dans l’ordre logique pour la ligne tabulée suivante, et toutes celles qui suivent tant qu’une autre commande ne vient pas le modifier. C’est à -dire que si le taquet de début de ligne courant est le taquet N°<replaceable>n</replaceable>, +dire que si le taquet de début de ligne courant est le taquet № <replaceable>n</replaceable>, et qu’on a <replaceable>m</replaceable> commandes <literal>\-</literal> avec <inlineequation><mathphrase><replaceable>m</replaceable>≥<replaceable>n</replaceable></mathphrase></inlineequation>, alors le taquet de début de ligne courant de la ligne suivante devient -le taquet N°<inlineequation><mathphrase><replaceable>n</replaceable>-<replaceable>m</replaceable></mathphrase></inlineequation>. Par contre, si +le taquet № <inlineequation><mathphrase><replaceable>n</replaceable>-<replaceable>m</replaceable></mathphrase></inlineequation>. Par contre, si <inlineequation><mathphrase><replaceable>m</replaceable>><replaceable>n</replaceable></mathphrase></inlineequation>, alors la <inlineequation><mathphrase>(<replaceable>n</replaceable>+1)</mathphrase></inlineequation>ième commande <literal>\+</literal> provoque une erreur. </para> @@ -5689,7 +6310,7 @@ l’alignement se fait sur la marge de droite et sans espacement relatif. <indexterm role="fn"><primary>\a= (macron, accent dans tabbing)</primary></indexterm> <para>Dans un environnement <literal>tabbing</literal>, les commandes <literal>\=</literal>, <literal>\'</literal> et <literal>\`</literal> ne produisent pas d’accents comme d’habitude -(see <link linkend="Accents">Accents</link>). À leur place, on utilise les commandes <literal>\a=</literal>, +(voir <link linkend="Accents">Accents</link>). À leur place, on utilise les commandes <literal>\a=</literal>, <literal>\a'</literal> et <literal>\a`</literal>. </para> </listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\kill</primary></indexterm><literal>\kill</literal> @@ -5700,18 +6321,19 @@ produire une sortie. L’effet de toute commande <literal>\=</literal>, <lit </para> </listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\poptabs</primary></indexterm><literal>\poptabs</literal> </term><listitem><indexterm role="fn"><primary>\poptabs</primary></indexterm> -<para>Restaure les positions de taquets sauvegardés par le dernier -<literal>\pushtabs</literal>. +<para>Restaure les positions de taquets et le taquet de début de ligne +sauvegardés par le dernier <literal>\pushtabs</literal>. </para> </listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\pushtabs</primary></indexterm><literal>\pushtabs</literal> </term><listitem><para>Sauvegarde dans une pile dédiée à cet effet le motif courant de taquets -de tabulation. C’est utile pour changer temporairement les positions de -taquets au milieu d’un environnement <literal>tabbing</literal>. Après un -<literal>\pushtabs</literal>, on a un nouveau motif vierge, c.-à-d. ne contenant -qu’un seul taquet, le taquet N°0 à la position de début de ligne. Pour -toute commande <literal>\pushtabs</literal> il doit y avoir une commande -<literal>\poptabs</literal> avant la fin de l’environnement, c’est à dire que la -pile doit être explicitement vidée avant le <literal>end{tabbing}</literal>. +de tabulation ainsi que le taquet de début de ligne. C’est utile pour +changer temporairement les positions de taquets au milieu d’un +environnement <literal>tabbing</literal>. Après un <literal>\pushtabs</literal>, on a un nouveau +motif vierge, c.-à-d. ne contenant qu’un seul taquet, le taquet № 0 à +la position de début de ligne. Pour toute commande <literal>\pushtabs</literal> il +doit y avoir une commande <literal>\poptabs</literal> avant la fin de +l’environnement, c’est à dire que la pile doit être explicitement vidée +avant le <literal>end{tabbing}</literal>. </para> </listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\tabbingsep</primary></indexterm><literal>\tabbingsep</literal> @@ -5746,18 +6368,9 @@ function \= fact(n : integer) : integer;\+\\ fact := 1; end; </screen> -<indexterm role="fn"><primary>paquetage <literal>algorithm2e</literal></primary></indexterm> -<indexterm role="fn"><primary><literal>algorithm2e</literal>, paquetage</primary></indexterm> - -<indexterm role="fn"><primary>paquetage <literal>listings</literal></primary></indexterm> -<indexterm role="fn"><primary><literal>listings</literal>, paquetage</primary></indexterm> - -<para>Ceci n’était qu’un exemple illustrant <literal>tabbing</literal>, pour formatter du -code considérez plutôt les paquetages <filename>algorithm2e</filename> pour du -pseudo-code, et <literal>listings</literal> pour du vrai code. -</para> -<para>Voici un autre exemple où le taquet N°2 est entre le taquet N°0 et le -taquet N°1 : + +<para>Voici un autre exemple où le taquet № 2 est entre le taquet № 0 et le +taquet № 1 : </para> <screen>{\ttfamily \begin{tabbing} @@ -5770,13 +6383,13 @@ taquet N°1 : </para><screen>123456789 1 3 2 </screen> -<para>Voici un exemple où les taquets N°0 et N°1 sont confondus, ainsi que les -taquets N°2 et N°3, ce qui permet de superposer le texte aux taquets +<para>Voici un exemple où les taquets № 0 et № 1 sont confondus, ainsi que les +taquets № 2 et № 3, ce qui permet de superposer le texte aux taquets impairs sur celui au taquets pairs, par exemple pour souligner ou barrer comme avec une machine à écrire, en superposant un caractère <literal>_</literal> ou un caractère <literal>−</literal>. Evidemment ce n’est qu’une illustration de -la flexivilité des taquets, et non une méthode convenable pour souligner -ou barrer un mot, d’un part parce que <literal>tabbing</literal> en soi commençant +la flexibilité des taquets, et non une méthode convenable pour souligner +ou barrer un mot, d’une part parce que <literal>tabbing</literal> en soi commençant un nouveau paragraphe ne permet pas d’agir sur un seul mot, et d’autre part, parce que le paquetage <literal>soul</literal> fait cela beaucoup mieux. <indexterm role="fn"><primary>paquetage <literal>soul</literal></primary></indexterm> @@ -5792,7 +6405,7 @@ part, parce que le paquetage <literal>soul</literal> fait cela beaucoup mieux. \end{tabbing}} </screen> -<para>Finalement, voici un exemple où on a placé le taquet N°5 décalé d’une +<para>Finalement, voici un exemple où on a placé le taquet № 5 décalé d’une longueur <literal>\tabbingsep</literal> à droite de la marge de droite. </para> <screen>{\ttfamily @@ -5823,36 +6436,57 @@ longueur <literal>\tabbingsep</literal> à droite de la marge de droite. <para>Synopsis : </para> -<screen> \begin{table}[<replaceable>placement</replaceable>] +<screen>\begin{table}[<replaceable>placement</replaceable>] <replaceable>corps-du-tableau</replaceable> - \caption[<replaceable>titreldt</replaceable>]{<replaceable>titre</replaceable>} - \end{table} + \caption[<replaceable>titreldt</replaceable>]{<replaceable>titre</replaceable>} % optionnel + \label{<replaceable>étiquette</replaceable>} % également opionnel +\end{table} </screen> -<para>Une classe de flottants (see <link linkend="Floats">Floats</link>). Parce qu’ils ne peuvent pas +<para>Une classe de flottants (voir <link linkend="Floats">Floats</link>). 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. </para> +<para>Dans l’exemple suivant, l’environnement <literal>table</literal> contient un <literal>tabular</literal> : +</para> +<screen>\begin{table} + \centering\small + \begin{tabular}{ll} + \multicolumn{1}{c}{\textit{Auteur}} + &\multicolumn{1}{c}{\textit{Pièce}} \\ \hline + Bach &Suite Numéro 1 pour violoncelle\\ + Beethoven &Sonate Numéro 3 pour violoncelle\\ + Brahms &Sonate Numéro 1 pour violoncelle + \end{tabular} + \caption{Meilleures pièces pour violoncelle} + \label{tab:violoncelle} +\end{table} +</screen> +<para>mais vous pouvez placer beaucoup de types différents de contenu au sein +d’une <literal>table</literal> : le <replaceable>table body</replaceable> peut contenir du texte, des +commandes &latex;, des graphiques, etc. Il est composé dans une +<literal>parbox</literal> de largueur <literal>\textwidth</literal>. +</para> <para>Pour les valeurs possibles de <replaceable>placement</replaceable> et leur effet sur l’algorithme de placement des flottants, voir <link linkend="Floats">Floats</link>. </para> -<para>Le corps du tableau est composé dans une <literal>parbox</literal> de largueur -<literal>\textwidth</literal> and ainsi il peut contenir du texte, des commandes, -etc. -</para> <para>L’étiquette est optionnelle ; elle est utilisée pour les double renvois -(see <link linkend="Cross-references">Cross references</link>). +(voir <link linkend="Cross-references">Cross references</link>). <indexterm role="fn"><primary>\caption</primary></indexterm> -La commande <literal>\caption</literal> spécifie la légende <replaceable>texte</replaceable> pour la -figure. La légende est numérotée par défaut. Si <replaceable>titreldt</replaceable> est -présent, il est utilisé dans la liste des tableaux au lieu de <replaceable>titre</replaceable> -(see <link linkend="Table-of-contents-etc_002e">Table of contents etc.</link>). +La commande <literal>\caption</literal> est également optionnelle. Elle spécifie la +légende <replaceable>titre</replaceable> pour la figure. La légende est numérotée par +défaut. Si <replaceable>titreldt</replaceable> est présent, il est utilisé dans la liste des +tableaux au lieu de <replaceable>titre</replaceable> (voir <link linkend="Table-of-contents-etc_002e">Table of contents etc.</link>). +</para> +<para>Dans l’exemple suivant le tabeau et se légende flottent jusqu’au bas +d’une page, à moins qu’il soit repoussé jusqu’à une page de flottants à +la fin. </para> <screen>\begin{table}[b] \centering \begin{tabular}{r|p{2in}} \hline Un &Le plus solitaire des nombres \\ - Deux &Peut être aussi triste qu'un. + Deux &Peut être aussi triste que un. C'est le nombre le plus solitaire après le nombre un. \end{tabular} \caption{Vertus cardinales} @@ -5953,7 +6587,7 @@ de l’environnement. </listitem></varlistentry><varlistentry><term><literal>@{<replaceable>texte ou espace</replaceable>}</literal> </term><listitem><para>Ceci insère <replaceable>texte ou espace</replaceable> à cette position dans chaque ligne. Le matériel <replaceable>texte ou espace</replaceable> est composé en mode LR. Ce texte est -fragile (see <link linkend="_005cprotect">\protect</link>). +fragile (voir <link linkend="_005cprotect">\protect</link>). </para> <para>Ce spécificateur est optionnel : à moins que vous mettiez dans votre propre @-expression alors les classes <literal>book</literal>, <literal>article</literal> et @@ -6016,17 +6650,20 @@ spécificateur <literal>>{...}</literal>. </listitem></varlistentry><varlistentry><term><literal>p{<replaceable>lrg</replaceable>}</literal> </term><listitem><para>Chaque cellule de la colonne est composée au sein d’une parbox de -largeur <replaceable>lrg</replaceable>. +largeur <replaceable>lrg</replaceable>, comme si c’était l’argument d’une commande +<literal>\parbox[t]{<replaceable>lrg</replaceable>}{...}</literal>. </para> -<para>Note que les sauts de ligne de type double-contr’oblique <literal>\\</literal> ne -sont pas permis au sein d’une telle cellule, sauf à l’intérieur d’un -environnement comme <literal>minipage</literal>, <literal>array</literal>, ou <literal>tabular</literal>, -ou à l’intérieur d’une <literal>\parbox</literal> explicite, ou dans la portée d’une +<para>Les sauts de ligne de type double-contr’oblique <literal>\\</literal> ne sont pas +permis au sein d’une telle cellule, sauf à l’intérieur d’un +environnement comme <literal>minipage</literal>, <literal>array</literal>, ou <literal>tabular</literal>, ou +à l’intérieur d’une <literal>\parbox</literal> explicite, ou dans la portée d’une déclaration <literal>\centering</literal>, <literal>\raggedright</literal>, ou <literal>\raggedleft</literal> (quand elles sont utilisées au sein d’une cellule de colonne en <literal>p</literal> ces déclarations doivent apparaître entre accolades, comme dans <literal>{\centering .. \\ ..}</literal>. Sans quoi &latex; prendra la -double contr’oblique comme une fin de ligne. +double contr’oblique comme une fin de ligne de tableau. Au lieu de cela, pour +obtenir un saut de ligne dans une cellule de ce type utilisez +<literal>\newline</literal> (voir <link linkend="_005cnewline">\newline</link>). </para> </listitem></varlistentry><varlistentry><term><literal>*{<replaceable>num</replaceable>}{<replaceable>cols</replaceable>}</literal> </term><listitem><para>Équivalent à <replaceable>num</replaceable> copies de <replaceable>cols</replaceable>, où <replaceable>num</replaceable> est un entier @@ -6209,7 +6846,7 @@ utilisée dans une expression <literal>@{…}</literal>. <indexterm role="fn"><primary>environnement <literal>thebibliography</literal></primary></indexterm> <indexterm role="fn"><primary><literal>thebibliography</literal>, environnement</primary></indexterm> -<indexterm role="cp"><primary>bibliography, creating (manually)</primary></indexterm> +<indexterm role="cp"><primary>bibliographie, créer (manuellement)</primary></indexterm> <para>Synopsis : </para> @@ -6219,39 +6856,60 @@ utilisée dans une expression <literal>@{…}</literal>. \end{thebibliography} </screen> <para>L’environnement <literal>thebibliography</literal> produit une bibliographie ou une -liste de références. -</para> -<para>Dans la classe <literal>article</literal>, cette liste de références est intitulée -‘<literal>Références</literal>’ et ce titre est stocké dans la macro <literal>\refname</literal> ; -dans la classe <literal>report</literal>, elle est intitulée ‘<literal>Bibliographie</literal>’ et -ce titre est stocké dans la macro <literal>\bibname</literal>. -</para> -<para>Vous pouvez changer le titre en redéfinissant celle des commandes -<literal>\refname</literal> ou <literal>\bibname</literal> qui est applicable selon la classe : -</para> -<itemizedlist><listitem><indexterm role="fn"><primary>\bibname</primary></indexterm> -<para>Pour les classes standardes dont le niveau le plus élevé de rubricage -est <literal>\chapter</literal> le titre est dans la macro <literal>\bibname</literal>, par -exemple les classes <filename>book</filename> et <filename>report</filename> tombent dans cette -catégorie. -</para></listitem><listitem><indexterm role="fn"><primary>\refname</primary></indexterm> -<para>Pour les classes standardes dont le niveau le plus élevé de rubricage -est <literal>\section</literal> le titre est dans la macro <literal>\refname</literal>, par -exemple la classe <filename>article</filename> tombe dans cette catégorie. -</para></listitem></itemizedlist> -<indexterm role="fn"><primary>paquetage <literal>babel</literal></primary></indexterm> -<indexterm role="fn"><primary><literal>babel</literal>, paquetage</primary></indexterm> - -<para>Typiquement il n’est ni nécessaire ni désirable de redéfinir directement -<literal>\refname</literal> ou <literal>\bibname</literal> ; les paquetages linguistiques comme -<filename>babel</filename> s’en chargent. +liste de références. Il y a deux façons de produire des listes +bibliographiques. Cet environnement convient quand vous avez un petit +nombre de références et pouvez maintenirla liste manuellement. +Voir <link linkend="Using-BibTeX">Using BibTeX</link>, pour une approche plus sophistiquée. +</para> +<para>L’exemple ci-dessous illustre l’environnement avec deux articles. +</para> +<screen>Ce travail s'appuie sur \cite{latexdps}. +Et ensemble à \cite{latexdps, texbook}. + ... +\begin{thebibliography}{9} +\bibitem{latexdps} + Leslie Lamport. + \textit{\LaTeX{}: a document preparation system}. + Addison-Wesley, Reading, Massachusetts, 1993. +\bibitem{texbook} + Donald Ervin Knuth. + \textit{Le Texbook : Composition informatique}. + Vuibert, 1er août 2017.\end{thebibliography} +</screen> +<para>Cela formate la première référe,ce comme ‘<literal>[1] Leslie ...</literal>’, de sorte +que <literal>... s'appuie sur \cite{latexdps}</literal> produit ‘<literal>... s'appuie +sur [1]</literal>’. Le second <literal>\cite</literal> produit ‘<literal>[1, 2]</literal>’. On doit +compile le document deux fois pour que ces numéros de référence soient +résolus. </para> <para>L’argument obligatoire <replaceable>étiquette-la-plus-large</replaceable> est un texte qui, lorsqu’il est composé, est aussi large que la plus large des étiquettes -d’article produit pas les commandes <literal>\bibitem</literal>. C’est typiquement -donné comme <literal>9</literal> pour des bibliographies de moins de 10 références, +d’article produit pas les commandes <literal>\bibitem</literal>. Traditionnellement +on utilise <literal>9</literal> pour des bibliographies de moins de 10 références, <literal>99</literal> pour celles qui en on moins de 100, etc. </para> +<indexterm role="fn"><primary>\bibname</primary></indexterm> +<indexterm role="fn"><primary>\refname</primary></indexterm> +<para>La liste bibliographique a un titre de bibliographie tel que +‘<literal>Bibliographie</literal>’. Pour le changer il y a deux cas. Dans les classes +<filename>book</filename> et <filename>report</filename>, lorsque le niveau de rubricage le plus +élevé est <literal>\chapter</literal> et le titre par défaut ‘<literal>Bibliographie</literal>’, +ce titre est dans la macro <literal>\bibname</literal>. Pour <filename>article</filename>, lorsque +le niveau de rubricage le plus élevé est <literal>\section</literal> et que le titre +par défaut est ‘<literal>Références</literal>’, le titre est stocké dans la macro +<literal>\refname</literal>. Pour le changer redéfinissez la commande, comme dans +<literal>\renewcommand{\refname}{Références citées}</literal>, après +<literal>\begin{document}</literal>. +</para> +<indexterm role="fn"><primary>paquetage <literal>babel</literal></primary></indexterm> +<indexterm role="fn"><primary><literal>babel</literal>, paquetage</primary></indexterm> + +<para>Les paquetages de prise en charge linguistique comme <filename>babel</filename> +redéfinissent automatiquement <literal>\refname</literal> ou <literal>\bibname</literal> pour +s’adapter à la langue sélectionnée. +</para> +<para>Voir <link linkend="list">list</link>, pour les paramètres de contrôle de disposition de la liste. +</para> <sect2 label="8.24.1" id="_005cbibitem"> @@ -6260,27 +6918,70 @@ donné comme <literal>9</literal> pour des bibliographies de moins de 10 référ <indexterm role="fn"><primary>\bibitem</primary></indexterm> <para>Synopsis : -</para><screen>\bibitem[<replaceable>étiquette</replaceable>]{<replaceable>clef_de_cite</replaceable>} +</para> +<screen>\bibitem{<replaceable>clef_de_cite</replaceable>} </screen> -<para>La commande <literal>\bibitem</literal> génère une entrée étiquetée par -<replaceable>étiquette</replaceable>. Si l’argument <replaceable>étiquette</replaceable> est omis, un numéro est -automatiquement généré en utilisant le compteur <literal>enumi</literal>. L’argument +<para>ou : +</para> +<screen>\bibitem[<replaceable>étiquette</replaceable>]{<replaceable>clef_de_cite</replaceable>} +</screen> +<para>La commande <literal>\bibitem</literal> génère un article étiqueté par défaut par un +numéro généré en utilisant le compteur <literal>enumi</literal>. L’argument <replaceable>clef_de_cite</replaceable> est une <indexterm role="cp"><primary>clef de référence bibiliographique</primary></indexterm> <indexterm role="cp"><primary>référence bibiliographique, clef</primary></indexterm> <firstterm>clef de référence bibiliographique</firstterm> consistant -en une séquence quelconque de lettres, chiffres, et signes de -ponctuation ne contenant aucune virgule. -</para> -<para>Cette commande écrit une entrée dans le fichier <filename>.aux</filename>, et cette -entrée contient les <replaceable>étiquette</replaceable> et <replaceable>clef_de_cite</replaceable> de l’article -considéré. Lorsque le fichier <filename>.aux</filename> est lu par la commande -<literal>\begin{document}</literal>, l’<replaceable>étiquette</replaceable> de l’article est associée à -sa <replaceable>clef_de_cite</replaceable>, ce qui a pour effet que toute référence à -<replaceable>clef_de_cite</replaceable> avec une commande <literal>\cite</literal> (see <link linkend="_005ccite">\cite</link>) -produit l’<replaceable>étiquette</replaceable> associée. +en une chaîne quelconque de lettres, chiffres, et signes de +ponctuation (hormis la virgule). +</para> +<para>Voir <link linkend="thebibliography">thebibliography</link>, pour un exemple. +</para> +<para>L’argument optionnel <replaceable>étiquette</replaceable>, lorsqu’il est présent, sert +d’étiquette et le compteur <literal>enumi</literal> n’est pas incrémenté. Dans +l’exemple suivant : +</para> +<screen>\begin{thebibliography} +\bibitem[Lamport 1993]{latexdps} + Leslie Lamport. + \textit{\LaTeX{}: a document preparation system}. + Addison-Wesley, Reading, Massachusetts, 1993. +\bibitem{texbook} + Donald Ervin Knuth. + \textit{Le Texbook : Composition informatique}. + Vuibert, 1er août 2017. +\end{thebibliography} +</screen> +<para>le premier article est formaté comme ‘<literal>[Lamport 1993] Leslie ...</literal>’ +(la quantité d’espace horizontal que &latex; laisse pour l’étiquette +dépend de l’argument <replaceable>étiquette-la-plus-large</replaceable> de l’environnement +<literal>thebibliography</literal> ; voir <link linkend="thebibliography">thebibliography</link>). +De même, <literal>... s'appuyant sur \cite{latexdps}</literal> produit +‘<literal>... s'appuyant sur [Lamport 1994]</literal>’. +</para> +<para>Si vous mélangez des articles <literal>\bibitem</literal> avec et sans +<replaceable>étiquette</replaceable>, alors &latex; numérote ceux sans séquentiellement. +Dans l’exemple ci-dessus l’article <literal>texbook</literal> apparaît comme +‘<literal>[1] Donald ...</literal>’, bien que ce soit le deuxième article. +</para> +<para>Si vous utilisez la même <replaceable>clef_de_cite</replaceable> deux fois, alors vous +obtenez ‘<literal>LaTeX Warning: There were multiply-defined labels</literal>’. +</para> +<para>En coulisse, &latex; se souvient de l’information <replaceable>clef_de_cite</replaceable> et +<replaceable>étiquette</replaceable> parce que <literal>\bibitem</literal> écrit dans le fichier +auxiliaire <filename><replaceable>jobname</replaceable>.aux</filename> (voir <link linkend="Jobname">Jobname</link>). Par exemple dans +l’exemple ci-dessus ce fichier contient +<literal>\bibcite{latexdps}{Lamport, 1993}</literal> et +<literal>\bibcite{texbook}{1}</literal>. Le fichier <filename>.aux</filename> est lu par la +commande <literal>\begin{document}</literal> et alors l’information devient +disponible pour les commandes <literal>\cite</literal>. Ceci explique qu’il est +nécessaire d’exécuter &latex; deux fois pour que les références soient +résolues : une pour l’écrire, et une pour le relire. +</para> +<para>À cause de cet algorithme en deux passes, quand vous ajourez un +<literal>\bibitem</literal> ou changez sa <replaceable>clef_de_cite</replaceable> vous pouvez obtenir +‘<literal>LaTeX Warning: Label(s) may have changed. Rerun to get +cross-references right</literal>’. La solution est de recompiler. </para> - </sect2> <sect2 label="8.24.2" id="_005ccite"> <title><literal>\cite</literal></title> @@ -6289,17 +6990,57 @@ produit l’<replaceable>étiquette</replaceable> associée. <para>Synopsis : </para> +<screen>\cite{<replaceable>clefs</replaceable>} +</screen> +<para>ou +</para> <screen>\cite[<replaceable>subcite</replaceable>]{<replaceable>clefs</replaceable>} </screen> -<para>L’argument <replaceable>clefs</replaceable> est une liste d’une ou plus de clefs de -références bibliographiques (see <link linkend="_005cbibitem">\bibitem</link>), séparées par des -virgules. Cette commande génère une référence bibliographique au sein du -textes contenant les étiquettes associées aux clefs contenues dans -<replaceable>clefs</replaceable> par les entrées respectives au sein du fichier <filename>.aux</filename>. + +<para>Cette commande génère en sortie une citation des références associées à +<replaceable>clefs</replaceable>. L’argument <replaceable>clefs</replaceable> est une liste d’une ou plus de +clefs de références bibliographiques (voir <link linkend="_005cbibitem">\bibitem</link>), séparées par +des virgules. +</para> + +<para>L’exemple suivant : </para> -<para>Le texte de l’argument optionnel <replaceable>subcite</replaceable> apparaît après -l’étiquette de référence. Par exemple, <literal>\cite[p.~314]{knuth}</literal> -pourrait produire ‘<literal>[Knuth, p. 314]</literal>’. +<screen>La source ultime est \cite{texbook}. + ... +\begin{thebibliography} +\bibitem{texbook} + Donald Ervin Knuth. + \textit{Le Texbook : Composition informatique}. + Vuibert, 1er août 2017. +\end{thebibliography} +</screen> +<para>produit une sortie du genre ‘<literal>... ultime est [1]</literal>’. (Vous pouvez +changer l’apparence de la citation et de la référence en utilisant un +style de bibliographie si vous générez automatiquement l’environnement +<literal>thebibliography</literal>. Voir <link linkend="Using-BibTeX">Using BibTeX</link> pour plus ample +information). +</para> +<para>L’argument optionnel <replaceable>subcite</replaceable> est joint à la citation. Par +exemple, <literal>Voir 14.3 dans \cite[p.~314]{texbook}</literal> pourrait +produire ‘<literal>Voir 14.3 dans [1, p. 314]</literal>’. +</para> +<para>En plus de ce qui apparaît en sortie, <literal>\cite</literal> écrit de +l’information dans le fichier auxiliaire <filename><replaceable>jobname</replaceable>.aux</filename> +(voir <link linkend="Jobname">Jobname</link>). Par exemple, <literal>\cite{latexdps}</literal> écrit +‘<literal>\citation{latexdps}</literal>’ dans ce fichier. Cette information est +utilisée par Bib&tex; pour inclure dans vos listes de référence +seulement les ouvrages que vous avez effectivement cités ; voir aussi +<link linkend="_005cnocite">\nocite</link>. +</para> +<para>Si <replaceable>clefs</replaceable> n’est pas dans votre information de bibliographie, alors +vous obtenez ‘<literal>LaTeX Warning: There were undefined references</literal>’, et +en sortie la citation s’affiche comme un point d’interrogation en gras +entre crochets. Il y a deux causes possibles. Si vous avez fait une +faute de frappe, comme dans <literal>\cite{texbok}</literal> alors il n’y a qu’à +la corriger. Si par contre vous venez juste d’ajouter ou de modifier +l’information bibliographique de sorte que le fichier <filename>.aux</filename> est +modifié (voir <link linkend="_005cbibitem">\bibitem</link>) alors la solution est d’exécuter de nouveau +&latex;. </para> </sect2> @@ -6311,9 +7052,15 @@ pourrait produire ‘<literal>[Knuth, p. 314]</literal>’. </para> <screen><literal>\nocite{<replaceable>clefs</replaceable>}</literal> </screen> -<para>La commande <literal>\nocite</literal> ne produit aucun texte, mais écrit -<replaceable>clefs</replaceable>, ce qui est une liste d’une ou plusieurs clefs de référence -bibliograhique dans le fichier <filename>.aux</filename>. +<para>La commande <literal>\nocite</literal> ne produit aucun texte en sortie, mais écrit +<replaceable>clefs</replaceable> dans le fichier auxiliaire <filename><replaceable>jobname</replaceable>.aux</filename> +(voir <link linkend="Jobname">Jobname</link>). +</para> +<para>L’argument obligatoire <replaceable>clefs</replaceable> est une liste d’une ou plusieurs +clefs de référence bibliograhique (voir <link linkend="_005cbibitem">\bibitem</link>). Cette information +est utilisée par Bib&tex; pour inclure ces ouvrages dans votre liste de +références même si vous ne les avez pas cités explicitement +(voir <link linkend="_005ccite">\cite</link>). </para> </sect2> @@ -6326,43 +7073,65 @@ bibliograhique dans le fichier <filename>.aux</filename>. <indexterm role="fn"><primary>\bibliographystyle</primary></indexterm> <indexterm role="fn"><primary>\bibliography</primary></indexterm> -<para>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 <literal>thebibliography</literal> -(see <link linkend="thebibliography">thebibliography</link>). Au lieu de cela, vous incluez les lignes : +<para>Comme déscrit dans <literal>thebibliography</literal> (voir <link linkend="thebibliography">thebibliography</link>), une +approche sophistiqué pour gérer les bibliographies est fournie par le +programme Bib&tex;. Ceci est uniquement une introduction ; voir la +documentation complète sur le CTAN (voir <link linkend="CTAN">CTAN</link>). +</para> +<para>Avec Bib&tex; vous n’utilisez pas <literal>thebibliography</literal> +(voir <link linkend="thebibliography">thebibliography</link>). Au lieu de cela, vous incluez les lignes : </para> <screen>\bibliographystyle{<replaceable>stylebib</replaceable>} -\bibliography{<replaceable>ficbib1</replaceable>,<replaceable>ficbib2</replaceable>} +\bibliography{<replaceable>ficbib1</replaceable>,<replaceable>ficbib2</replaceable>, ...} </screen> -<para>La commande <literal>\bibliographystyle</literal> ne produit aucune sortie en -elle-même. En revanche, elle définit le style dans lequel la -bibliographie est à produite : <replaceable>stylebib</replaceable> fait référence à un -fichier <replaceable>stylebib</replaceable><filename>.bst</filename> définissant l’aspect que doivent avoir -vos référence bibliographique. Les nom <replaceable>stylebib</replaceable> standards -distribués avec Bib&tex; sont : +<para>L’argument <replaceable>stylebib</replaceable> fait référence à un fichier +<filename><replaceable>stylebib</replaceable>.bst</filename> définissant l’aspect que doivent avoir vos +référence bibliographique. Les noms <replaceable>stylebib</replaceable> standards distribués +avec Bib&tex; sont : </para> <variablelist><varlistentry><term><literal>alpha</literal> -</term><listitem><para>Classé alphabetiquement. Les étiquettes sont formées à partir du nom de -l’auteur et de l’année de publication. +</term><listitem><para>Les étiquettes sont formées à partir du nom de l’auteur et de l’année de +publication. Les articles bibliographiques sont classés alphabetiquement. </para></listitem></varlistentry><varlistentry><term><literal>plain</literal> -</term><listitem><para>Classé alphabetiquement. Les étiquettes sont des numéros. +</term><listitem><para>Les étiquettes sont des numéros. +Les articles sont classés alphabétiquement. </para></listitem></varlistentry><varlistentry><term><literal>unsrt</literal> </term><listitem><para>Comme <literal>plain</literal>, mais les entrées sont dans l’ordre où les références y sont faites dans le texte. </para></listitem></varlistentry><varlistentry><term><literal>abbrv</literal> </term><listitem><para>Comme <literal>plain</literal>, mais les étiquettes sont plus compactes. </para></listitem></varlistentry></variablelist> -<para>De plus, de nombreux autres styles Bib&tex; existent faits sur mesure pour -satisfaire les exigences de diverses publications. Voir -<ulink url="http://mirror.ctan.org/biblio/bibtex/contrib">http://mirror.ctan.org/biblio/bibtex/contrib</ulink>. +<para>De très nombreux autres styles Bib&tex; existent, taillés sur mesure +pour satisfaire les exigences de diverses publications. Voir la liste du +CTAN <ulink url="http://mirror.ctan.org/biblio/bibtex/contrib">http://mirror.ctan.org/biblio/bibtex/contrib</ulink>. </para> <para>La commande <literal>\bibliography</literal> est ce qui produit pour de bon la bibliographie. L’argument de <literal>\bibliography</literal> fait référence aux fichiers nommés <filename><replaceable>ficbib1</replaceable>.bib</filename>, <filename><replaceable>ficbib2</replaceable>.bib</filename>, -…, qui sont censés contenir votre base de donnée au format -Bib&tex;. Seules les entrées désignées par les commandes <literal>\cite</literal> -ou <literal>\nocite</literal> sont listées dans la bibliographie. +…, qui sont censés contenir votre base de données au format +Bib&tex;. L’exemple suivant illustre une paire typique d’entrées dans +ce format. +</para> +<screen>@book{texbook, + title = {Le {{\TeX}}book~: composition informatique}, + author = {D.E. Knuth}, + isbn = {2-7117-4819-7}, + series = {Vuibert informatique}, + year = {2003}, + publisher = {Vuibert} +} +@book{sexbook, + author = {W.H. Masters and V.E. Johnson}, + title = {Les r{\'e}action sexuelles}, + year = {1976}, + publisher = {Robert Laffont} +} +</screen> +<para>Seules les entrées désignées par les commandes <literal>\cite</literal> ou +<literal>\nocite</literal> sont listées dans la bibliographie du document. De la +sorte, vous pouvez conserver toutes vos sources ensemble dans un +fichier, ou un petit nombre de fichiers, et compter sur Bib&tex; pour +inclure dans le document seulement celles que vous avez utilisées. </para> </sect2> @@ -6378,12 +7147,35 @@ ou <literal>\nocite</literal> sont listées dans la bibliographie. <para>Synopsis : </para> <screen>\begin{theorem} -<replaceable>texte-théorème</replaceable> + <replaceable>corps du théorème</replaceable> \end{theorem} </screen> <para>L’environnement <literal>theorem</literal> produit « Théorème <replaceable>n</replaceable> » en gras -suivi de <replaceable>texte-théorème</replaceable>, où les possibilité de numérotation pour -<replaceable>n</replaceable> sont décrites par <literal>\newtheorem</literal> (see <link linkend="_005cnewtheorem">\newtheorem</link>). +suivi de <replaceable>corps du théorème</replaceable>, où les possibilités de numérotation pour +<replaceable>n</replaceable> sont décrites par <literal>\newtheorem</literal> (voir <link linkend="_005cnewtheorem">\newtheorem</link>). +</para> +<screen>\newtheorem{lem}{Lemme} % dans le préambule +\newtheorem{thm}{Théorème} + ... +\begin{lem} % dans le corps du document + texte du lemme +\end{lem} + +Le résultat suivant en découle immédiatement. +\begin{thm}[Gauss] % place « Gauss » entre parenthèses après le titre + texte du théorème +\end{thm} +</screen> +<indexterm role="fn"><primary>paquetage <literal>amsmath</literal></primary></indexterm> +<indexterm role="fn"><primary><literal>amsmath</literal>, paquetage</primary></indexterm> + +<indexterm role="fn"><primary>paquetage <literal>amsthm</literal></primary></indexterm> +<indexterm role="fn"><primary><literal>amsthm</literal>, paquetage</primary></indexterm> + +<para>La plupart des nouveaux documents utilisent les paquetages <literal>amsthm</literal> +et <literal>amsmath</literal> de l’American Mathematical Society. Entre autres ces +paquetages incluent un grand nombre d’options pour les environnements de +théorèmes, telles que des options de formatage. </para> </sect1> @@ -6399,18 +7191,41 @@ suivi de <replaceable>texte-théorème</replaceable>, où les possibilité de nu <para>Synopsis : </para> <screen>\begin{titlepage} -<replaceable>texte</replaceable> + ... texte et espacement ... \end{titlepage} </screen> <para>L’environnement <literal>titlepage</literal> 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 <literal>\today</literal> -peut être utile sur les pages de titre (see <link linkend="_005ctoday">\today</link>). +rubrique. Il entraîne aussi que la page suivante a le numéro un. +</para> + +<para>Dans l’exemple suivant tout le formatage, y compris l’espacement +vertical, est laissé à l’auteur. </para> -<para>Vous pouvez utiliser la commande <literal>\maketitle</literal> (see <link linkend="_005cmaketitle">\maketitle</link>) -pour produire une page de titre standarde sans utiliser l’environnement -<literal>titlepage</literal>. +<screen>\begin{titlepage} +\vspace*{\stretch{1}} +\begin{center} + {\huge\bfseries Thèse \\[1ex] + titre} \\[6.5ex] + {\large\bfseries Nom de l'auteur} \\ + \vspace{4ex} + Thèse soumise à \\[5pt] + \textit{Nom de l'université} \\[2cm] + pour obtenir le grade de \\[2cm] + \textsc{\Large Docteeur en} \\[2ex] + \textsc{\large Mathématiques} \\[12ex] + \vfill + Departement de Mathématiques \\ + Adresse \\ + \vfill + \today +\end{center} +\vspace{\stretch{2}} +\end{titlepage} +</screen> +<para>Pour produire par contre une une page de titre standarde sans utiliser +l’environnement <literal>titlepage</literal>, utilisez la commande <literal>\maketitle</literal> +(voir <link linkend="_005cmaketitle">\maketitle</link>). </para> </sect1> @@ -6424,22 +7239,65 @@ pour produire une page de titre standarde sans utiliser l’environnement <indexterm role="cp"><primary>simuler du texte tapuscrit</primary></indexterm> <indexterm role="cp"><primary>texte tapuscrit, simulation de</primary></indexterm> <indexterm role="cp"><primary>code source, composer du</primary></indexterm> -<indexterm role="cp"><primary>source logiciel, composer du</primary></indexterm> +<indexterm role="cp"><primary>programmes informatiques, composer du</primary></indexterm> <para>Synopsis : </para> <screen>\begin{verbatim} -<replaceable>literal-texte</replaceable> +<replaceable>texte-litéral</replaceable> \end{verbatim} </screen> <para>L’environnement <literal>verbatim</literal> est un environnement qui fabrique des -paragraphes dans lequel &latex; produit exactement ce qui vous y taez ; -par exemple le caractère <literal>\</literal> produit ‘<literal>\</literal>’ à l’impression . Il, -fait de &latex; une machine à écrire, c.-à-d. que le retour chariot -et les blancs y ont un tel effet. +paragraphes dans lequel &latex; produit exactement ce qui vous y tapez. +Par exemple au sein de <replaceable>texte-litéral</replaceable> le caractère <literal>\</literal> ne +commence pas de commande, il produit ‘<literal>\</literal>’ à l’impression, et les +retour chariot et les blancs sont pris littéralement. La sortie +appraraît dans une police genre tapuscrit (encore appelé « machine à +écrire ») à chasse fixe (<literal>\tt</literal>). </para> -<para>L’environnement <literal>verbatim</literal> utilise une police de type tapuscrit -(encore appelé « machine à écrire ») à chasse fixe (<literal>\tt</literal>). +<screen>\begin{verbatim} +Juron symbolique : %&$#?!. +\end{verbatim} +</screen> +<para>La seule restriction sur <literal>text-literale</literal> est qu’il ne peut pas +inclure la chaîne <literal>\end{verbatim}</literal>. +</para> +<indexterm role="fn"><primary>paquetage <literal>cprotect</literal></primary></indexterm> +<indexterm role="fn"><primary><literal>cprotect</literal>, paquetage</primary></indexterm> + + +<para>Il est impossible d’utiliser l’environnement <literal>verbatim</literal> au sein +d’un argument de macro, par exemple dans l’argument passé à +<literal>\section</literal>. Ce n’est pas le même problème que celui des commandes +fragiles (voir <link linkend="_005cprotect">\protect</link>), mais c’est juste impossible parce que +l’environnement <literal>verbatim</literal> change le régime de catcode avant de +traiter son contenu, et le rétablit juste après, or au sein d’un argument +de macro le contenu de l’argument est déjà converti en une liste +d’unités lexicales selon le régime de catcode courant à l’appel de la +macro. Cependant, le paquetage <literal>cprotect</literal> peut être utile dans +cette situation. +</para> +<indexterm role="fn"><primary>paquetage <literal>listings</literal></primary></indexterm> +<indexterm role="fn"><primary><literal>listings</literal>, paquetage</primary></indexterm> +<indexterm role="fn"><primary>paquetage <literal>minted</literal></primary></indexterm> +<indexterm role="fn"><primary><literal>minted</literal>, paquetage</primary></indexterm> + +<para>Une utilisation courante d’entrée verbatim est de composer du code +informatique. Il y a des paquetages qui améliorent l’environnement +<literal>verbatim</literal>. Par exemple, une amélioration est de permettre +l’inclusion verbatim de fichiers externes, totalement ou en +partie. Parmi ces paquetages : <literal>listings</literal> et <literal>minted</literal>. +</para> +<indexterm role="fn"><primary>paquetage <literal>fancyvrb</literal></primary></indexterm> +<indexterm role="fn"><primary><literal>fancyvrb</literal>, paquetage</primary></indexterm> + +<indexterm role="fn"><primary>paquetage <literal>verbatimbox</literal></primary></indexterm> +<indexterm role="fn"><primary><literal>verbatimbox</literal>, paquetage</primary></indexterm> + +<para>Un paquetage qui offre beaucoup plus d’options pour les environnements +verbatim est <literal>fancyvrb</literal>. Un autre <literal>verbatimbox</literal>. +</para> +<para>Pour une liste complète de tous les paquetages pertinents voir le CTAN (voir <link linkend="CTAN">CTAN</link>). </para> <sect2 label="8.27.1" id="_005cverb"> @@ -6464,6 +7322,40 @@ dans le <replaceable>texte-littéral</replaceable>. <para>La forme étoilée (en <literal>*</literal>) diffère seulement en ce que les espaces sont tapés avec un caractère « espace visible ». </para> +<para>La sortie correspondant à ce qui suit utilise un espace visible de part +et d’autre du mot ‘<literal>with</literal>’ : +</para> +<screen>Le premier argument de la commande est \verb*!filename with extension! et ... +</screen> +<indexterm role="fn"><primary>paquetage <literal>url</literal></primary></indexterm> +<indexterm role="fn"><primary><literal>url</literal>, paquetage</primary></indexterm> + +<para>Pour composer des adresses réticulaires, appelée aussi URL, le paquetage +<literal>url</literal> est une option préférable à la commande <literal>\verb</literal>, puisque +il permet les sauts de ligne. +</para> +<indexterm role="fn"><primary>paquetage <literal>listings</literal></primary></indexterm> +<indexterm role="fn"><primary><literal>listings</literal>, paquetage</primary></indexterm> + +<indexterm role="fn"><primary>paquetage <literal>minted</literal></primary></indexterm> +<indexterm role="fn"><primary><literal>minted</literal>, paquetage</primary></indexterm> + +<para>Pour du code informatique il y a beaucoup de paquetages plus avantageux +que <literal>\verb</literal>. L’un est <filename>listings</filename>, un autre <filename>minted</filename>. +</para> +<indexterm role="fn"><primary>paquetage <literal>cprotect</literal></primary></indexterm> +<indexterm role="fn"><primary><literal>cprotect</literal>, paquetage</primary></indexterm> + +<para>Vous ne pouvez pas utiliser <literal>\verb</literal> au sein d’un argument de macro, +par exemple dans l’argument passé à <literal>\section</literal>. Ce n’est pas une +question que <literal>\verb</literal> serait fragile (voir <link linkend="_005cprotect">\protect</link>), mais c’est +juste impossible parce que la commande <literal>\verb</literal> change le régime de +catcode avant de lire son argument et le rétablit juste après, or au sein +d’un argument de macro le contenu de l’argument a déjà été converti en +une liste d’unités lexicales selon le régime de catcode courant l’appel +de la macro. Cependant, le paquetage <literal>cprotect</literal> peut être utile +dans cette situation. +</para> </sect2> </sect1> @@ -6477,8 +7369,8 @@ sont tapés avec un caractère « espace visible ». <para>Synopsis : </para> <screen>\begin{verse} -<replaceable>line1</replaceable> \\ -<replaceable>line2</replaceable> \\ + <replaceable>line1</replaceable> \\ + <replaceable>line2</replaceable> \\ ... \end{verse} </screen> @@ -6541,7 +7433,7 @@ environnement <literal>tabular</literal> ou <literal>array</literal>. <para>Dans des circonstances ordinaires (par ex. en dehors d’une colonne spécifiée par <literal>p{...}</literal> dans un environnement <literal>tabular</literal>) la commande <literal>\newline</literal> est un synonyme de <literal>\\</literal> -(see <link linkend="_005cnewline">\newline</link>). +(voir <link linkend="_005cnewline">\newline</link>). </para> <para>En plus de commencer une nouvelle ligne, la forme étoilée <literal>\\*</literal> dit à &latex; de ne pas commencer une nouvelle page entre les deux lignes, @@ -6560,11 +7452,10 @@ en émettant un <literal>\nobreak</literal>. <para>La commande <literal>\obeycr</literal> a pour effet qu’un retour chariot dans le fichier d’entrée (‘<literal>^^M</literal>’, internement) soit traité de la même façon -que <literal>\\</literal> (suivi d’un <literal>\relax</literal>). Ainsi chaque passage à la -ligne dans l’entrée est aussi un passage à la ligne dans la sortie. -</para> -<para><literal>\restorecr</literal> restaure le comportement normal vis à vis des saut de -ligne. +que <literal>\\</literal> suivi d’un <literal>\relax</literal>. Ainsi chaque passage à la ligne +dans l’entrée est aussi un passage à la ligne dans la sortie. La +commande <literal>\restorecr</literal> restaure le comportement normal vis à vis des +sauts de ligne. </para> </sect1> @@ -6576,7 +7467,7 @@ ligne. <indexterm role="cp"><primary>saut de ligne</primary></indexterm> <para>Dans du texte ordinaire ceci est équivalent à une double-contr’oblique -(see <link linkend="_005c_005c">\\</link>) ; cela rompt la ligne, sans dilatation du texte le +(voir <link linkend="_005c_005c">\\</link>) ; cela rompt la ligne, sans dilatation du texte le précéndent. </para> <para>Au sein d’un environnement <literal>tabular</literal> ou <literal>array</literal>, dans une @@ -6627,7 +7518,7 @@ 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 <literal>\hyphenation</literal> -(see <link linkend="_005chyphenation">\hyphenation</link>) et <literal>\-</literal> (see <link linkend="_005c_002d-_0028hyphenation_0029">\- (césure +(voir <link linkend="_005chyphenation">\hyphenation</link>) et <literal>\-</literal> (voir <link linkend="_005c_002d-_0028hyphenation_0029">\- (césure à gré)</link>). </para> <para><literal>\discretionary</literal> indique qu’un saut de ligne est possible à cet @@ -6677,7 +7568,7 @@ effet que &tex; fait le difficile à propos des saut de ligne. Ceci d’occasionnellement une boîte trop pleine (‘<literal>overfull \hbox</literal>’). </para> <para>Cette commande annule l’effet d’une commande <literal>\sloppy</literal> précédente -(see <link linkend="_005csloppy">\sloppy</link>). +(voir <link linkend="_005csloppy">\sloppy</link>). </para> </sect1> @@ -6688,7 +7579,7 @@ d’occasionnellement une boîte trop pleine (‘<literal>overfull \hbox difficile à propos des sauts de ligne. Ceci evite les boîtes trop pleines, au prix d’un espacement lâche entre les mots. </para> -<para>L’effet dure jusqu’à la prochaine commande <literal>\fussy</literal> (see <link linkend="_005cfussy">\fussy</link>). +<para>L’effet dure jusqu’à la prochaine commande <literal>\fussy</literal> (voir <link linkend="_005cfussy">\fussy</link>). </para> </sect1> @@ -6786,7 +7677,7 @@ apparus en entrée jusqu’à ce point et sont en attente. <screen>\newpage </screen> <para>La commande <literal>\newpage</literal> finit la page courante. Cette commande est -robuste (see <link linkend="_005cprotect">\protect</link>). +robuste (voir <link linkend="_005cprotect">\protect</link>). </para> <para>Les sauts de page de &latex; sont optimisés de sorte que d’ordinaire on n’utilise cette commande dans le corps d’un document que pour les @@ -6794,13 +7685,13 @@ finitions sur la version finale, ou à l’interieur de commandes. </para> <para>Alors que les commandes <literal>\clearpage</literal> et <literal>\cleardoublepage</literal> finissent également la page courante, en plus de cela elles débourrent -les flottants pendants (see <link linkend="_005cclearpage-_0026-_005ccleardoublepage">\clearpage & \cleardoublepage</link>). Et, si +les flottants pendants (voir <link linkend="_005cclearpage-_0026-_005ccleardoublepage">\clearpage & \cleardoublepage</link>). Et, si &latex; est en mode à deux colonne alors <literal>\clearpage</literal> et <literal>\cleardoublepage</literal> finissent las page courante en laissant possiblement une colonne vide, alors que <literal>\newpage</literal> finit seulement la colonne courante. </para> -<para>Contrairement à <literal>\pagebreak</literal> (see <link linkend="_005cpagebreak-_0026-_005cnopagebreak">\pagebreak & \nopagebreak</link>), +<para>Contrairement à <literal>\pagebreak</literal> (voir <link linkend="_005cpagebreak-_0026-_005cnopagebreak">\pagebreak & \nopagebreak</link>), la commande <literal>\newpage</literal> n’a pas pour effet que la nouvelle page commence exactement là où la requête est faite. Dans l’exemple suivant </para> @@ -6911,7 +7802,7 @@ contraire. <para>Changez l’aspect que &latex; donne au compteur de note en bas de page avec quelque chose du genre de <literal>\renewcommand{\thefootnote}{\fnsymbol{footnote}}</literal>, ce qui -utilise une séquence de symboles (see <link linkend="_005calph-_005cAlph-_005carabic-_005croman-_005cRoman-_005cfnsymbol">\alph \Alph \arabic \roman +utilise une séquence de symboles (voir <link linkend="_005calph-_005cAlph-_005carabic-_005croman-_005cRoman-_005cfnsymbol">\alph \Alph \arabic \roman \Roman \fnsymbol</link>). Pour rendre ce changement global mettez cela dans le préambule. Si vous faite ce changement local alors vous désirerez sans doute réinitialiser le compte avec @@ -6953,7 +7844,7 @@ rubriques suivantes. utilise le compteur <literal>mpfootnote</literal> au lieu de <literal>footnote</literal>, de sorte que les notes sont numérotéee indépendemment. Elles apparaissent au bas de l’environnement, et non au bas de la page. Et par défaut -elles apparaissent alphabétiquement. See <link linkend="minipage">minipage</link>. +elles apparaissent alphabétiquement. Voir <link linkend="minipage">minipage</link>. </para> </sect1> @@ -7019,7 +7910,7 @@ dans la cellule du tableau mais rien n’est composé en bas de la page. \end{center} </screen> <para>La solution est d’entourer l’environnement the <literal>tabular</literal> d’un environnement -<literal>minipage</literal>, comme ci-après (see <link linkend="minipage">minipage</link>). +<literal>minipage</literal>, comme ci-après (voir <link linkend="minipage">minipage</link>). </para> <screen>\begin{center} \begin{minipage}{.5\textwidth} @@ -7028,7 +7919,7 @@ dans la cellule du tableau mais rien n’est composé en bas de la page. \end{center} </screen> <para>La même technique marche au sein d’un environnement <literal>table</literal> -flottant (see <link linkend="table">table</link>). To get the footnote at the bottom of the page +flottant (voir <link linkend="table">table</link>). To get the footnote at the bottom of the page use the <filename>tablefootnote</filename> package, comme illustré dans l’exemple ci-apès. Si vous placez <literal>\usepackage{tablefootnote}</literal> dans le préambule et utilisez le code source ci-dessous, alors la note @@ -7095,7 +7986,7 @@ n’apparaît pas). </listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\footnotesep</primary></indexterm><literal>\footnotesep</literal> </term><listitem><para>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 -<literal>\footnotesize</literal> (see <link linkend="Font-sizes">Font sizes</link>), donc il n’y a pas d’espace +<literal>\footnotesize</literal> (voir <link linkend="Font-sizes">Font sizes</link>), donc il n’y a pas d’espace supplémentaire entre les notes. Cela vaut ‘<literal>6.65pt</literal>’ pour des polices à ‘<literal>10pt</literal>’, ‘<literal>7.7pt</literal>’ pour ‘<literal>11pt</literal>’, et ‘<literal>8.4pt</literal>’ pour ‘<literal>12pt</literal>’. @@ -7251,7 +8142,7 @@ la définition et par conséquent définissent bien un groupe. \providecommand*{<replaceable>cmd</replaceable>}[<replaceable>nargs</replaceable>][<replaceable>optargdéfaut</replaceable>]{<replaceable>defn</replaceable>} </screen> <para>Si aucune commande de ce nom n’existe alors ceci a le même effet que -<literal>\newcommand</literal> (see <link linkend="_005cnewcommand-_0026-_005crenewcommand">\newcommand & \renewcommand</link>). Si une +<literal>\newcommand</literal> (voir <link linkend="_005cnewcommand-_0026-_005crenewcommand">\newcommand & \renewcommand</link>). Si une commande de ce nom existe déjà alors cette définition est sans effet. Ceci est particulièrement utile dans un fichier de style, ou dans tout fichier susceptible d’être chargé plus d’une fois. @@ -7266,15 +8157,15 @@ tout fichier susceptible d’être chargé plus d’une fois. ... définition de commande comprenant @ dans leur nom .. \makeatother </screen> -<para>Utilisez cette paire de commande quand vous redéfinissser les commandes -&latex; dont le nom comprend un caractère arobe <literal>@</literal>. La -déclaration <literal>\makeatletter</literal> a pour effet que le caractère -arobase <literal>@</literal> ait le code de catégorie des lettres, c.-à-d. 11. La -déclaration <literal>\makeatother</literal> règle de code de catégorie de <literal>@</literal> -à 12, sa valeur d’origine. +<para>Utilisez cette paire de commandes quand vous redéfinissser les commandes +&latex; dont le nom comprend un caractère arobe ‘<literal><literal>@</literal></literal>’. La +déclaration <literal>\makeatletter</literal> a pour effet que le caractère arobe ait +le code de catégorie des lettres, c.-à-d. le code 11. La déclaration +<literal>\makeatother</literal> règle de code de catégorie de l’arobe au code 12, sa +valeur d’origine. </para> -<para>À mesure que chaque caractère est lu par &tex; pour &latex;, un code -de catégorie lui est assigné. On appelle aussi ce code +<para>À mesure que chaque caractère est lu par &tex;, un code de catégorie +lui est assigné. On appelle aussi ce code <indexterm role="cp"><primary>catcode</primary></indexterm> <indexterm role="cp"><primary>code de catégorie de caractère</primary></indexterm> <indexterm role="cp"><primary>catégorie, code de caractère</primary></indexterm> @@ -7303,7 +8194,7 @@ que l’arobe ait le catcode d’une lettre, à savoir 11. <indexterm role="fn"><primary>paquetage <literal>macros2e</literal></primary></indexterm> <indexterm role="fn"><primary><literal>macros2e</literal>, paquetage</primary></indexterm> -<para>Pour une liste complète des macros contenant une arobase dans leur nom, +<para>Pour une liste complète des macros contenant une arobe dans leur nom, voir le document <ulink url="http://ctan.org/pkg/macros2e">http://ctan.org/pkg/macros2e</ulink>. <!-- xx pourquoi est-ce que ceci a été enlevé : --> <!-- xx Ces macros sont surtout à l'intention des auteurs de classes et de --> @@ -7327,33 +8218,47 @@ dans le préambule, avant le <literal>\begin{document}</literal> : <indexterm role="cp"><primary>commandes, variantes étoilées</primary></indexterm> <indexterm role="cp"><primary>étoilées, variantes de commandes</primary></indexterm> - +<para>Synopsis : +</para> +<screen>\newcommand{\macmd}{\@ifstar{\macmd@star}{\macmd@nostar}} +\newcommand{\macmd@nostar}[<replaceable>nostar-nbre-args</replaceable>]{<replaceable>nostar-corps</replaceable>} +\newcommand{\macmd@star}[<replaceable>star-nbre-args</replaceable>]{<replaceable>star-corps</replaceable>} +</screen> <!-- Inpirée des trucs & astuces de Manuel Pégourié-Gonnard --> <!-- (https://elzevir.fr/imj/latex/tips.html#stared) --> <para>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. -</para> -<para>Si vous avez lu <link linkend="_005cnewenvironment-_0026-_005crenewenvironment">\newenvironment & \renewenvironment</link>, 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 -<literal>\newenvironment{<replaceable>monenv</replaceable>}</literal> et -<literal>\newenvironment{<replaceable>monenv</replaceable>*}</literal> avec les définitions souhaitées. -</para> -<para>Pour les commandes, c’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 <literal>\@ifstar</literal> interne du noyau &latex; et -vous pouvez vous reportez à « <link linkend="_005cmakeatletter-_0026-_005cmakeatother">\makeatletter & \makeatother</link> » pour -comprendre pourquoi cela implique l’usage d’un bloc -<literal>\makeatletter...\makeatother</literal>. +standards de &latex; existent sous une variante avec le même nom mais +finissant avec le caractère étoile <literal>*</literal>, un astérisque. Par exemple +c’est le cas des environnement <literal>table</literal> et <literal>table*</literal>, et des +commandes <literal>\section</literal> et <literal>\section*</literal>. +</para> +<para>Lorsque on définit un environnement, cela est facile puisque +<literal>\newenvironment</literal> et <literal>\renewenvironment</literal> autorisent que le nom +de l’environnement contienne un astérisque. Il vous suffit donc +d’écrire <literal>\newenvironment{<replaceable>monenv</replaceable>}</literal> ou +<literal>\newenvironment{<replaceable>monenv</replaceable>*}</literal> et de continuer la définition +comme d’habitude. Pour les commandes, c’est plus compliqué car l’étoile +n’étant pas une lettre one peut pas faire partie du nom de la +commande. Comme dans le synopsis ci-dessus, on a donc une commande +utilisateur, donnée ci-dessus comme <literal>\macmd</literal>, qui doit être capable +de regarder si elle est ou non suivie d’une étoile. Par exemple, +&latex; n’a pas réellement une commande <literal>\section*</literal> ; au lieu de +cela la commande <literal>\section</literal> regarde ce qui la suit. Cette première +commande n’accepte d’argument, mais au lieu de cela se développe en +l’une de deux commandes qui elle accepte des arguments. Dans le synopsis +ces commande sont <literal>\macmd@nostar</literal> et <literal>\macmd@star</literal>. Elles +peuvent prendre le même nombre d’arguments ou un nombre différent, ou +pas d’argument du tout. Comme d’habitude, dans un document &latex; une +commande utilisant l’arobe <literal>@</literal> dans son nom doit être comprise au +sein d’un bloc <literal>\makeatletter ... \makeatother</literal> +(voir <link linkend="_005cmakeatletter-_0026-_005cmakeatother">\makeatletter & \makeatother</link>). </para> <para>Dans cet exemple, on définit <literal>\ciel</literal> comme une commande avec un argument obligatoire et admettant une variante étoilée <literal>\ciel*</literal> -également avec un argument obligatoire : +également avec un argument obligatoire. Ainsi, <literal>\ciel{bleu}</literal> +composera « ciel bleu non étoilé » tandis que <literal>\ciel*{nocturne}</literal> +composera « ciel nocturne étoilé ». </para> <screen>\makeatletter \newcommand*\ciel@starred[1]{ciel #1 étoilé} @@ -7361,46 +8266,48 @@ argument obligatoire et admettant une variante étoilée <literal>\ciel*</litera \newcommand\ciel{\@ifstar{\ciel@starred}{\ciel@unstarred}} \makeatother </screen> -<para>ainsi, <literal>\ciel{bleu}</literal> composera « ciel bleu non étoilé » tandis que -<literal>\ciel*{nocturne}</literal> composera « ciel nocturne étoilé ». -</para> -<para>Notez que les commandes intermédiaires <literal>\ciel@starred</literal> et -<literal>\ciel@unstarred</literal> comportent un <literal>@</literal> dans leur nom ce qui est -possible puisque elles apparaissent au sein d’un bloc -<literal>\makeatletter...\makeatother</literal>. 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 -<literal>\newcommand*{\<replaceable>cmd</replaceable>}</literal> vérifie que si la commande <literal>\<replaceable>cmd</replaceable></literal> -n’est pas déjà définie et génère une erreur si c’est le cas. -</para> -<para>Voici un autre exemple, où la commande <literal>\agentsecret</literal> comporte deux -arguments, tandis que sa variante étoilée <literal>\agentsecret*</literal> n’en présente qu’un seul : + +<para>Voici un autre exemple, où la variante étoilée prend un nombre +d’arguments différent de la non étoilée. Avec cette définition, la +célèbre réplique de l’agent 007 « <literal>Mon nom est +\agentsecret*{Bond}, \agentsecret{James}{Bond}</literal>. » est équivalente +à saisir les commandes « Je m’appelle \textsc{Bond}, \textit{James} +textsc{Bond}. » </para> <screen>\makeatletter \newcommand*\agentsecret@starred[1]{\textsc{#1}} \newcommand*\agentsecret@unstarred[2]{\textit{#1} \textsc{#2}} -\newcommand\agentsecret{\@ifstar{\agentsecret@starred} -                                        {\agentsecret@unstarred}} +\newcommand\agentsecret{\@ifstar{\agentsecret@starred}{\agentsecret@unstarred}} \makeatother </screen> -<para>Avec cette définition, la célèbre réplique de l’agent 007 : +<para>Après le nom d’une commande, l’étoile est traitée d’une manière +similaire à un argument optionnel. (Ceci est différent des noms +d’environnement, où l’étoile fait partie du nom lui-même, et peut donc +être à n’importe quelle position). D’un point de vue purement technique +il est donc possible de mettre un nombre indéfini d’espaces entre la +commande et l’étoile. Ainsi <literal>\agentsecret*{Bond}</literal> et +<literal>\agentsecret *<!-- /@w -->{Bond}</literal> sont équivalents. Toutefois, la +pratique normale est de ne pas insérer de tels espaces. </para> -<screen>Je m'appelle \agentsecret*{Bond}, \agentsecret{James}{Bond}. -</screen> -<para>est équivalente à : +<indexterm role="fn"><primary>paquetage <literal>suffix</literal></primary></indexterm> +<indexterm role="fn"><primary><literal>suffix</literal>, paquetage</primary></indexterm> + +<indexterm role="fn"><primary>paquetage <literal>xparse</literal></primary></indexterm> +<indexterm role="fn"><primary><literal>xparse</literal>, paquetage</primary></indexterm> + + +<para>Il y a deux manières pouvant être plus commodes d’accomplir la même +tâche que <literal>\@ifstar</literal>. Le paquetage <filename>suffix</filename> permet la +construction <literal>\newcommand\macommande{<replaceable>variante-non-étoilée</replaceable>}</literal> +suivie de +<literal>\WithSuffix\newcommand\macommande*{<replaceable>variante-étoilée</replaceable>}</literal>. Et +&latex;3 a le paquetage <filename>xparse</filename> qui permet ce code. </para> -<screen>Je m'appelle \textsc{Bond}, \textit{James} textsc{Bond}. +<screen>\NewDocumentCommand\toto{s}{\IfBooleanTF#1 + {<replaceable>variante-étoilée</replaceable>}% + {<replaceable>variante-non-étoilée</replaceable>}% + } </screen> -<para>Un dernier mot : -dans le nom d’une commande, l’étoile est comme une sorte d’argument optionnel. -Ceci est différent des noms d’environnement, où l’étoile fait partie -du nom lui-même, et peut donc être à n’importe quelle position ! -D’un point de vue purement &tex;nique il est donc possible de mettre un nombre indéfini -d’espaces entre la commande et l’étoile. Ainsi <literal>\agentsecret*{Bond}</literal> et -<literal>\agentsecret *{Bond}</literal> sont équivalents. Toutefois la pratique commune -est de ne jamais insérer de tels espaces. -</para> </sect1> <sect1 label="12.5" id="_005cnewcounter"> <title><literal>\newcounter</literal> : allouer un compteur</title> @@ -7419,7 +8326,7 @@ Le nouveau compteur est initialisé à zéro. <replaceable>nomcompteur</replaceable> est réinitialisé à chaque incrémentation du compteur nommé <replaceable>super</replaceable>. </para> -<para>See <link linkend="Counters">Counters</link>, pour plus d’information à propos des compteurs. +<para>Voir <link linkend="Counters">Counters</link>, pour plus d’information à propos des compteurs. </para> </sect1> @@ -7444,7 +8351,7 @@ longueurs (élastiques) telles que <literal>1in plus.2in minus.1in</literal> (ce pas). Le registre est crée avec une valeur initiale de zéro. La séquence de contrôle <literal>\<replaceable>arg</replaceable></literal> doit ne pas être déjà définie. </para> -<para>See <link linkend="Lengths">Lengths</link>, pour plus d’information à propos des longueurs. +<para>Voir <link linkend="Lengths">Lengths</link>, pour plus d’information à propos des longueurs. </para> </sect1> @@ -7460,12 +8367,12 @@ de contrôle <literal>\<replaceable>arg</replaceable></literal> doit ne pas êtr </screen> <para>Définit <literal>\<replaceable>cmd</replaceable></literal> pour se référer à un nouveau baquet pour stocker des boîtes. Une telle boîte sert à détenir du matériel composé, pour -l’utiliser plusieurs fois (see <link linkend="Boxes">Boxes</link>) ou pour le mesurer ou le +l’utiliser plusieurs fois (voir <link linkend="Boxes">Boxes</link>) ou pour le mesurer ou le manipuler. Le nom <literal>\<replaceable>cmd</replaceable></literal> doit commencer par une contr’oblique, et ne doit pas être déjà défini. </para> <para>L’allocation d’une boîte est globale. Cette commande est fragile -(see <link linkend="_005cprotect">\protect</link>). +(voir <link linkend="_005cprotect">\protect</link>). </para> </sect1> @@ -7583,7 +8490,7 @@ Dans le document, utilisez l’environnement comme ceci : </screen> <para>Ce dernier exemple montre comment sauvegarder la valeur d’un argument pour l’utiliser dans <replaceable>déffin</replaceable>, dans ce cas dans une boîte -(see <link linkend="_005csbox">\sbox</link>). +(voir <link linkend="_005csbox-_0026-_005csavebox">\sbox & \savebox</link>). </para> <screen>\newsavebox{\quoteauthor} \newenvironment{citequote}[1][Corneille]{% @@ -7637,9 +8544,9 @@ fois. <para>Cette commande crée un compteur nommé <replaceable>name</replaceable>. De plus, à moins que l’argument optionnel <replaceable>numéroté_comme</replaceable> soit utilisé, la valeur courrante de <literal>\ref</literal> est celle de -<literal>\the<replaceable>numéroté_au_sein_de</replaceable></literal> (see <link linkend="_005cref">\ref</link>). +<literal>\the<replaceable>numéroté_au_sein_de</replaceable></literal> (voir <link linkend="_005cref">\ref</link>). </para> -<para>Cette déclaration est globale. Elle est fragile (see <link linkend="_005cprotect">\protect</link>). +<para>Cette déclaration est globale. Elle est fragile (voir <link linkend="_005cprotect">\protect</link>). </para> <variablelist><varlistentry><term><replaceable>nom</replaceable> </term><listitem><para>Le nom de l’environnement. Il ne doit pas commencer avec une @@ -7751,7 +8658,7 @@ 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 <filename>.fd</filename> ou à travers l’utilisation d’un moteur qui sait accéder au système de polices de -caractère, tel que Xe&latex; (see <link linkend="TeX-engines">Les moteurs +caractère, tel que Xe&latex; (voir <link linkend="TeX-engines">Les moteurs &tex;</link>). <!-- xx explain nfss somewhere --> </para> @@ -7804,10 +8711,10 @@ comme la table des matières. On appelle &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 ceux qui apparaissent -au sein des commandes <literal>\caption{...}</literal> (see <link linkend="figure">figure</link>), dans la -commande <literal>\thanks{...}</literal> (see <link linkend="_005cmaketitle">\maketitle</link>), et dans les +au sein des commandes <literal>\caption{...}</literal> (voir <link linkend="figure">figure</link>), dans la +commande <literal>\thanks{...}</literal> (voir <link linkend="_005cmaketitle">\maketitle</link>), et dans les expression en @ des environnements <literal>tabular</literal> et <literal>array</literal> -(see <link linkend="tabular">tabular</link>). +(voir <link linkend="tabular">tabular</link>). </para> <para>Si vous obtenez des erreurs étranges de commandes utilisées au sein d’arguments mouvants, essayez des les précéder d’un <literal>\protect</literal>. Il @@ -7936,10 +8843,10 @@ pour numéroter les articles de la liste. souvent utilisé dans <literal>\setcounter</literal> ou <literal>\addtocoutner</literal>, mais <literal>\value</literal> peut être utilisé partout là où &latex; attend un nombre. Elle ne doit pas être précédée par <literal>\protect</literal> -(see <link linkend="_005cprotect">\protect</link>). +(voir <link linkend="_005cprotect">\protect</link>). </para> <para>La commande <literal>\value</literal> n’est pas utiliser pour composer la valeur du -compteur. See <link linkend="_005calph-_005cAlph-_005carabic-_005croman-_005cRoman-_005cfnsymbol">\alph \Alph \arabic \roman \Roman \fnsymbol</link>. +compteur. Voir <link linkend="_005calph-_005cAlph-_005carabic-_005croman-_005cRoman-_005cfnsymbol">\alph \Alph \arabic \roman \Roman \fnsymbol</link>. </para> <para>Cet exemple produit en sortie ‘<literal>Le compteur essai vaut 6. Le compteur autre vaut 5</literal>’. @@ -7987,7 +8894,7 @@ quantité spécifiée par l’argument <replaceable>valeur</replaceable>, qu <indexterm role="fn"><primary>\refstepcounter</primary></indexterm> <para>La commande <literal>\refstepcounter</literal> fonctionne de la même façon que -<literal>\stepcounter</literal> See <link linkend="_005cstepcounter">\stepcounter</link>, à ceci près qu’elle définit +<literal>\stepcounter</literal> Voir <link linkend="_005cstepcounter">\stepcounter</link>, à ceci près qu’elle définit également la valeur courante de <literal>\ref</literal> comme le résultat de <literal>\thecounter</literal>. </para> @@ -8015,7 +8922,7 @@ re-initialise tous les compteurs subsidiaires. pas remis à jour pendant que le traitement par &tex; progresse. </para> <para>En relation avec ces compteurs, la commande <literal>\today</literal> produit une -chaîne représentant le jour courant (see <link linkend="_005ctoday">\today</link>). +chaîne représentant le jour courant (voir <link linkend="_005ctoday">\today</link>). </para> </sect1> @@ -8128,7 +9035,7 @@ horizontalement sur la page. <para>&tex; en réalité a trois niveaux d’infinité pour les composantes élastiques : <literal>fil</literal>, <literal>fill</literal>, et <literal>filll</literal> dans l’ordre d’infinité croissante. D’ordinaire les auteurs de documents n’utilisent -que celle du milieu (see <link linkend="_005chfill">\hfill</link> et see <link linkend="_005cvfill">\vfill</link>). +que celle du milieu (voir <link linkend="_005chfill">\hfill</link> et voir <link linkend="_005cvfill">\vfill</link>). </para> <para>Multiplier une longueur élastique par un nombre la transforme en une longueur rigide, de sorte qu’après <literal>\setlength{\ylength}{2.5cm @@ -8219,7 +9126,7 @@ points. <para>En mode mathématique, beaucoup de définitions sont exprimées dans l’unité mathématique <firstterm>mu</firstterm> donnée par 1em = 18mu, où le em est pris de la famille courante des symboles mathématiques. -See <link linkend="Spacing-in-math-mode">Spacing in math mode</link>. +Voir <link linkend="Spacing-in-math-mode">Spacing in math mode</link>. </para> </sect1> @@ -8312,7 +9219,7 @@ longueur <literal>\<replaceable>longueur</replaceable></literal> à la largeur <indexterm role="fn"><primary>\totalheight</primary></indexterm> </para> <para>Ces paramètres de longueur peuvent être utilisés au sein des arguments -des commandes de fabrication de boîte (see <link linkend="Boxes">Boxes</link>). Il spécifient la +des commandes de fabrication de boîte (voir <link linkend="Boxes">Boxes</link>). Il spécifient la largeur naturelle, etc., du texte dans la boîte. <literal>\totalheight</literal> vaut <inlineequation><mathphrase><literal>\height</literal> + <literal>\depth</literal></mathphrase></inlineequation>. Pour frabriquer une boîte dont le texte @@ -8405,11 +9312,11 @@ ligne de la note a la même ligne de base que la ligne dans le texte où le <para>Lorsque vous spécifiez seulement l’argument obligatoire <replaceable>droite</replaceable>, le texte est placé </para> -<itemizedlist><listitem><para>dans la marge de droite pour une disposition en recto simple (option +<itemizedlist><listitem><para>– dans la marge de droite pour une disposition en recto simple (option <literal>oneside</literal>, voir <link linkend="Document-class-options">Document class options</link>) ; -</para></listitem><listitem><para>dans la marge extérieure pour une disposition en recto-verso (option +</para></listitem><listitem><para>– dans la marge extérieure pour une disposition en recto-verso (option <literal>twoside</literal>, voir <link linkend="Document-class-options">Document class options</link>) ; -</para></listitem><listitem><para>dans la nearest la plus proche pour une disposition à deux colonnes +</para></listitem><listitem><para>– dans la plus proche pour une disposition à deux colonnes (option <literal>twocolumn</literal>, voir <link linkend="Document-class-options">Document class options</link>). </para></listitem></itemizedlist> <indexterm role="fn"><primary>\reversemarginpar</primary></indexterm> @@ -8660,10 +9567,10 @@ pointant vers le haut (opérateur). (opérateur). (Notez que le nom a juste un p.) </para> </listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\bigvee</primary></indexterm><literal>\bigvee</literal> -</term><listitem><para>⋁ De taille variable, ou n-aire, et-logique (opérateur). +</term><listitem><para>⋁ De taille variable, ou n-aire, ou-logique (opérateur). </para> </listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\bigwedge</primary></indexterm><literal>\bigwedge</literal> -</term><listitem><para>⋀ De taille variable, ou n-aire, ou-logique (opérateur). +</term><listitem><para>⋀ De taille variable, ou n-aire, et-logique (opérateur). </para> </listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\bot</primary></indexterm><literal>\bot</literal> </term><listitem><para>⊥ Taquet vers le haut, minimum, plus petit élément d’un ensemble @@ -8954,7 +9861,7 @@ simple (relation). Similaire : version courte <literal>\mapsto</literal>. double <literal>\Longrightarrow</literal>. </para> </listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\lor</primary></indexterm><literal>\lor</literal> -</term><listitem><para>∨ Ou-logique (binaire). Synonyme : <literal>\wedge</literal>. +</term><listitem><para>∨ Ou-logique (binaire). Synonyme : <literal>\vee</literal>. Voir auss et-logique <literal>\land</literal>. </para> </listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\mapsto</primary></indexterm><literal>\mapsto</literal> </term><listitem><para>↦ Flèche d’un taquet vers la droite (relation). @@ -9586,7 +10493,7 @@ police romaine et avec l’espacement adéquat. <para>&latex; fournit diverse commandes pour produire des lettres accentuées en math. Elles diffèrent de celles concernant les accents en texte normal -(see <link linkend="Accents">Accents</link>). +(voir <link linkend="Accents">Accents</link>). </para> <variablelist><varlistentry><term><indexterm role="fn"><primary>\acute</primary></indexterm><literal>\acute</literal> </term><listitem><indexterm role="cp"><primary>accent aigu en math</primary></indexterm> @@ -9674,7 +10581,7 @@ normales pour les textes mathématiques. </para> <para>En mode mathématique, beaucoup de définitions sont exprimées dans l’unité mathématique <firstterm>mu</firstterm> donnée par 1 em = 18 mu, où le em est pris -de la famille courante des symboles mathématiques (see <link linkend="Units-of-length">Units of length</link>). +de la famille courante des symboles mathématiques (voir <link linkend="Units-of-length">Units of length</link>). </para> <variablelist><varlistentry><term><literal>\;</literal> </term><listitem><indexterm role="cp"><primary>thickspace</primary></indexterm> @@ -9696,7 +10603,7 @@ de la famille courante des symboles mathématiques (see <link linkend="Units-of- <indexterm role="fn"><primary>\,</primary></indexterm> <indexterm role="fn"><primary>\thinspace</primary></indexterm> <para>Normalement <literal>3mu</literal>. Le nom long est <literal>\thinspace</literal>. Utilisable à -la fois en mode mathématique et en mode texte. See <link linkend="_005cthinspace">\thinspace</link>. +la fois en mode mathématique et en mode texte. Voir <link linkend="_005cthinspace">\thinspace</link>. </para> </listitem></varlistentry><varlistentry><term><literal>\!</literal> </term><listitem><indexterm role="fn"><primary>\!</primary></indexterm> @@ -9841,9 +10748,9 @@ prenant en compte les jambages. <para>Quand &latex; traite votre texte en entrée, il est forcément dans l’un de ces trois modes : </para> -<itemizedlist><listitem><para>Mode paragraphe -</para></listitem><listitem><para>Mode math -</para></listitem><listitem><para>Mode gauche-à-doite, appelé également mode LR (left-to-right) pour +<itemizedlist><listitem><para>– Mode paragraphe +</para></listitem><listitem><para>– Mode math +</para></listitem><listitem><para>– Mode gauche-à-doite, appelé également mode LR (left-to-right) pour faire bref </para></listitem></itemizedlist> <para>&latex; change le mode seulement lorsqu’il monte ou descend un escalier @@ -10069,8 +10976,9 @@ change en <replaceable>style</replaceable> pour la page courante seulement. </para> <para>Une autre commande produisant de l’espace est <literal>\,</literal> pour produire une espace « fine » (d’habitude 1/6quad). Elle peut être utilisée en -mode texte, mais est le plus souvent utile en mode math (see <link linkend="Spacing-in-math-mode">Espacement en mode mathématique</link>). +mode texte, mais est le plus souvent utile en mode math (voir <link linkend="Spacing-in-math-mode">Espacement en mode mathématique</link>). </para> +<!-- xxx Realigner sur l'anglais --> <!-- --> <!-- --> <sect1 label="19.1" id="_005chspace"> @@ -10123,7 +11031,7 @@ une abréviation. <para>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 -(see <link linkend="_005cfrenchspacing">\frenchspacing</link>). &latex; suppose que le point finit une phrase +(voir <link linkend="_005cfrenchspacing">\frenchspacing</link>). &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 @@ -10137,7 +11045,7 @@ contr’oblique-espace (<literal>\ </literal>), où d’un tilde (<liter exemples : <literal>Nat.\ Acad.\ Science</literal>, et <literal>Mr.~Bean</literal>, et <literal>(du fumier, etc.)\ à vendre</literal>. </para> -<para>Pour une autre utilisation de <literal>\ </literal>, see <link linkend="_005c_0028SPACE_0029-after-control-sequence"><literal>\ </literal> après une séquence de contrôle</link>. +<para>Pour une autre utilisation de <literal>\ </literal>, voir <link linkend="_005c_0028SPACE_0029-after-control-sequence"><literal>\ </literal> après une séquence de contrôle</link>. </para> <para>Dans la situation opposée, si vous avez une lettre capitale suivi d’un point qui finit la phrase, alors placez <literal>\@</literal> avant ce point. Par ex., @@ -10229,7 +11137,7 @@ avec <emphasis>f: f;</emphasis>. <para>Lorsque on change de fontes avec des commandes telles que <literal>\textit{italic text}</literal> ou <literal>{\itshape italic text}</literal>, &latex; insère automatiquement une correction italique appropriée si -nécessaire (see <link linkend="Font-styles">Font styles</link>). +nécessaire (voir <link linkend="Font-styles">Font styles</link>). </para> <para>Malgré leur nom, les caractères romains peuvent aussi avoir une correction italique. Comparez : @@ -10246,7 +11154,7 @@ l’espacement y est fait d’une façon différente. <indexterm role="fn"><primary>\hrulefill</primary></indexterm> <indexterm role="fn"><primary>\dotfill</primary></indexterm> -<para>Produit une longueur élastique infinie (see <link linkend="Lengths">Lengths</link>) remplie avec un +<para>Produit une longueur élastique infinie (voir <link linkend="Lengths">Lengths</link>) remplie avec un filled filet horizontal (c.-à-d. une ligne) ou avec des pointillés, au lieu de just de l’espace blanche. </para> @@ -10279,7 +11187,7 @@ défaut de 0.33em à 1.00em. <para><literal>\addvspace{<replaceable>length</replaceable>}</literal> </para> <para>Ajoute un espace vertical de longeur <replaceable>length</replaceable>, ce qui est une -longueur élatsique (see <link linkend="Lengths">Lengths</link>). Toutefois, si l’espace vertical a +longueur élatsique (voir <link linkend="Lengths">Lengths</link>). Toutefois, si l’espace vertical a déjà été ajouté au même point de la sortie par une commande <literal>\addvspace</literal> précédente, alors cette commande n’ajoutera pas plus d’espace que nécessaire à fabriquer la longeur naturelle de l’espace @@ -10291,7 +11199,7 @@ exemple, un environnement Theorem est défini pour commencer et finir en <literal>\addvspace{..}</literal> de sorte que deux Theorem consécutifs sont séparés par un espace vertical, et non deux.) </para> -<para>Cette commande est fragile (see <link linkend="_005cprotect">\protect</link>). +<para>Cette commande est fragile (voir <link linkend="_005cprotect">\protect</link>). </para> <para>L’erreur ‘<literal>Something's wrong--perhaps a missing \item</literal>’ signifie que vous n’étiez pas en mode vertical quand vous avez invoqué cette @@ -10337,7 +11245,7 @@ rétrécissement (la valeur par défaut pour les classes <literal>book</literal> <indexterm role="cp"><primary>verticale infinie, dilatation</primary></indexterm> <para>Finit le paragraphe courant et insère une longueur élastique verticale -(see <link linkend="Lengths">Lengths</link>) qui est infinie, de sorte qu’elle puisse se dilater ou +(voir <link linkend="Lengths">Lengths</link>) qui est infinie, de sorte qu’elle puisse se dilater ou se rétrécir autant que nécessaire. </para> <para>On l’utilise souvent de la même façon que <literal>\vspace{\fill}</literal>, à @@ -10373,7 +11281,7 @@ Chien perdu ! \vspace*{<replaceable>longueur</replaceable>} </screen> <para>Ajout l’espace verticale <replaceable>longueur</replaceable>. Celle-ci peut-être négative ou positive, -et c’est une longueur élastique (see <link linkend="Lengths">Lengths</link>). +et c’est une longueur élastique (voir <link linkend="Lengths">Lengths</link>). </para> <para>&latex; enlève l’espace verticale provenant de <literal>\vspace</literal> aux sauts de page, c.-à-d. au sommet et au bas des pages. La version étoilée @@ -10402,27 +11310,132 @@ chacune d’elle. <title>Boîtes</title> <indexterm role="cp"><primary>boîtes</primary></indexterm> -<para>Tous les paramètres de longueurs prédéfinies (see <link linkend="Predefined-lengths">Predefined lengths</link>) -peuvent être utilisés au sein des arguments des commandes de fabrication -de boîtes. +<para>Dans le fond, &latex; met des choses dans des boîtes et ensuite met ces +boîtes sur une page. Aussi les commandes qui suivent sont centrales. </para> +<indexterm role="fn"><primary>paquetage <literal>adjustbox</literal></primary></indexterm> +<indexterm role="fn"><primary><literal>adjustbox</literal>, paquetage</primary></indexterm> +<para>De nombreux paquetages sur le CTAN sont utiles pour la manipulation de +boîtes. Un ajout utile aux commandes décrites ici est <filename>adjustbox</filename>. +</para> +<!-- xx Vérifier que la référence @pxref{Predefined lengths} est donnée --> +<!-- par la suite. --> -<sect1 label="20.1" id="_005cmbox"> -<title><literal>\mbox{<replaceable>texte}</replaceable></literal></title> -<indexterm role="fn"><primary>\mbox</primary></indexterm> + +<sect1 label="20.1" id="_005cmbox-_0026-_005cmakebox"> +<title><literal>\mbox</literal> & <literal>\makebox</literal></title> + +<indexterm role="fn"><primary>\mbox</primary></indexterm> +<indexterm role="fn"><primary>\makebox</primary></indexterm> +<indexterm role="cp"><primary>boîte</primary></indexterm> +<indexterm role="cp"><primary>fabriquer une boîte</primary></indexterm> <indexterm role="cp"><primary>césure, empécher</primary></indexterm> <indexterm role="cp"><primary>coupure de mot, empécher</primary></indexterm> -<para>La commande <literal>\mbox</literal> crée un boîte qui a la largeur juste du texte -créé par son argument. Le <replaceable>texte</replaceable> n’est pas coupé en plusieurs -lignes, c’est pourquoi cette commande peut être utilisée pour empécher -la césure. + +<para>Synopsis, l’un parmi les suivants : +</para> +<screen>\mbox{<replaceable>texte</replaceable>} +\makebox{<replaceable>texte</replaceable>} +\makebox[<replaceable>largeur</replaceable>]{<replaceable>texte</replaceable>} +\makebox[<replaceable>largeur</replaceable>][<replaceable>position</replaceable>]{<replaceable>texte</replaceable>} +</screen> +<para>La commande <literal>\mbox</literal> crée un boîte, un conteneur pour du +matériel. Le <replaceable>texte</replaceable> est composé en mode LR (voir <link linkend="Modes">Modes</link>) ainsi il +n’est pas coupé en plusieurs lignes. La commande <literal>\mbox</literal> est +robuste, alors que <literal>\makebox</literal> est fragile (voir <link linkend="_005cprotect">\protect</link>). +</para> +<para>Comme <literal>texte</literal> n’est pas coupé en plusieurs ligne, on peut utiliser +<literal>\mbox</literal> pour empécher une césure. Dans l’exemple suivant, &latex; +ne peut pas faire de césure dans le nom du char, +‘<literal>T-34</literal>’. +</para> +<screen>Le char soviétique \mbox{T-34} est l'un des symboles de la victoire +sur le nazisme. +</screen> +<para>Dans les deux première version du synopsys, <literal>\mbox</literal> et +<literal>\makebox</literal> sont sensiblement équivalente. Elles créent une boîte +juste assez large pour contenir le <replaceable>texte</replaceable>. (Elle sont comme le +<literal>\hbox</literal> du &tex; de base). +</para> +<para>Dans la troisième version l’argument optionnel <replaceable>largeur</replaceable> spécifie la +largeur de la boîte. Notez que l’espace occupé par le texte n’est pas +nécessairement équivalent à la largeur de la boîte. D’une part, +<replaceable>texte</replaceable> peut être trop petit ; l’exemple suivant crée une boîte +d’une ligne entière de largeur : +</para> +<screen>\makebox[\linewidth]{Examen du chapitre} +</screen> +<para>où ‘<literal>Examen du chapitre</literal>’ est centré. Mais <replaceable>texte</replaceable> peut aussi +être trop large pour <replaceable>largeur</replaceable>. Voir l’exemple plus bas pour des +boîtes de largeur nulle. +</para> +<anchor id="mbox-makebox-depth"/><anchor id="mbox-makebox-height"/><anchor id="mbox-makebox-width"/><anchor id="mbox-makebox-totalheight"/><para>Au sein de l’argument <replaceable>largeur</replaceable> vous pouvez utiliser les longueur +suivante qui font référence aux dimensions de la boîte que &latex; +obtient en composant <replaceable>texte</replaceable> : <literal>\depth</literal>, <literal>\height</literal>, +<literal>\width</literal>, <literal>\totalheight</literal> (la somme de la hauteur et de la +profondeur de la boîte). Par exemple, pour fabriquer une boîte où le +texte est dilaté au double de sa largeur naturelle vous pouvez écrire +ceci : +</para> +<screen>\makebox[2\width]{Get a stretcher} +</screen> +<para>Pour la quatrième version du synopsis, la position du texte au sein de +la boîte est determinée par l’argument optionnel <replaceable>position</replaceable> qui peut +prendre l’une des valeurs suivantes : +</para> +<variablelist><varlistentry><term><literal>c</literal> +</term><listitem><para>Centré (par défaut). +</para></listitem></varlistentry><varlistentry><term><literal>l</literal> +</term><listitem><para>(Left) justifié à gauche. +</para></listitem></varlistentry><varlistentry><term><literal>r</literal> +</term><listitem><para>(Right) justifié à droite. +</para></listitem></varlistentry><varlistentry><term><literal>s</literal> +</term><listitem><para>(Stretch) justifié à travers la <replaceable>largeur</replaceable> entière ; <replaceable>texte</replaceable> doit +contenir de l’espace dilatable pour que cela marche. Par exemple, ceci +pourrait être le libellé d’un communiqué de presse : +<literal>\noindent\makebox[\textwidth][s]{\large\hfil DÉPÊCHE\hfil IMMÉDIATE\hfil}</literal> +</para></listitem></varlistentry></variablelist> +<para>Une utilisation courante de <literal>\makebox</literal> est de fabriquer des boîtes +de texte de largeur nulle. Dans l’exemple suivant on place dans un +questionnaire la valeur des questions à leur gauche. </para> +<screen>\newcommand{\pts}[1]{\makebox[0em][r]{#1 points\hspace*{1em}}} +\pts{10}Quelle est la vitesse aérodynamique d'une hirondelle à vide ? +\pts{90}Une hirondelle africaine ou européenne ? +</screen> +<para><indexterm role="fn"><primary>paquetage <literal>TikZ</literal></primary></indexterm> +<indexterm role="fn"><primary><literal>TikZ</literal>, paquetage</primary></indexterm> +</para> +<indexterm role="fn"><primary>paquetage <literal>Asymptote</literal></primary></indexterm> +<indexterm role="fn"><primary><literal>Asymptote</literal>, paquetage</primary></indexterm> + +<para>Le bord droit de la sortie ‘<literal>10 points </literal>’ (notez l’espace finale +après ‘<literal>points</literal>’) est juste avant le ‘<literal>Quelle</literal>’. Vous pouvez +utiliser <literal>\makebox</literal> de la même manière quand vous faites des +graphiques, comme en <filename>TikZ</filename> ou <filename>Asymptote</filename>, où vous mettez le +bord du texte à une position connue, quelle que soit la longueur de ce +texte. +</para> +<para>Pour des boîtes avec cadre voir <link linkend="_005cfbox-_0026-_005cframebox">\fbox & \framebox</link>. Pour des boîtes +de couleurs voir <link linkend="Colored-boxes">Colored boxes</link>. +</para> +<para>Il y a une version apparentée de <literal>\makebox</literal> qui utilisée au sein de +l’environnement <literal>picture</literal>, où la longueur est données en termes +d’<literal>\unitlength</literal> (voir <link linkend="_005cmakebox-_0028picture_0029">\makebox (picture)</link>). +</para> +<para>Comme <replaceable>texte</replaceable> est composé en mode LR, ni une double contr’oblique +<literal>\\</literal>, ni <literal>\par</literal> ne produisent un saut de ligne ; par exemple +<literal>\makebox{abc def \\ ghi}</literal> produit en sortie ‘<literal>abc defghi</literal>’ +alors que <literal>\makebox{abc def \par ghi}</literal> produit ‘<literal>abc def +ghi</literal>’, tout deux sur une seule ligne. Pour obtenir des lignes multiples +voir <link linkend="_005cparbox">\parbox</link> et <link linkend="minipage">minipage</link>. +</para> </sect1> -<sect1 label="20.2" id="_005cfbox-and-_005cframebox"> -<title><literal>\fbox</literal> and <literal>\framebox</literal></title> +<sect1 label="20.2" id="_005cfbox-_0026-_005cframebox"> +<title><literal>\fbox</literal> & <literal>\framebox</literal></title> <indexterm role="fn"><primary>\fbox</primary></indexterm> <indexterm role="fn"><primary>\framebox</primary></indexterm> @@ -10446,59 +11459,12 @@ la largeur de la boîte avec l’argument optionnel <replaceable>largeur</re (valant par défaut ‘<literal>.4pt</literal>’), et laisse un espace de <literal>\fboxsep</literal> (valant par défaut ‘<literal>3pt</literal>’) entre le filet et le contenu de la boîte. </para> -<para>See <link linkend="_005cframebox-_0028picture_0029">\framebox (picture)</link>, pour la commande <literal>\framebox</literal> dans +<para>Voir <link linkend="_005cframebox-_0028picture_0029">\framebox (picture)</link>, pour la commande <literal>\framebox</literal> dans l’environnement <literal>picture</literal>. </para> </sect1> -<sect1 label="20.3" id="lrbox"> -<title><literal>lrbox</literal></title> -<indexterm role="fn"><primary>lrbox</primary></indexterm> - -<para>Synopsis : -</para> -<screen>\begin{lrbox}{\<replaceable>cmd</replaceable>} - <replaceable>texte </replaceable> -\end{lrbox} -</screen> -<para>Ceci est la forme environnement de la commande <link linkend="_005csbox"><literal>\sbox</literal></link>. -</para> -<para>Le <replaceable>texte</replaceable> au sein de l’environnement est sauvegarder dans une boîte -<literal>\<replaceable>cmd</replaceable></literal> qui doit avoir préalablement été déclarée avec -<literal>\newsavebox</literal>. -</para> - -</sect1> -<sect1 label="20.4" id="_005cmakebox"> -<title><literal>\makebox</literal></title> -<indexterm role="fn"><primary>\makebox</primary></indexterm> - -<para>Synopsis : -</para> -<screen>\makebox[<replaceable>largeur</replaceable>][<replaceable>position</replaceable>]{<replaceable>texte</replaceable>} -</screen> -<para>La commande <literal>\makebox</literal> crée une boîte juste assez large pour -contenir le <replaceable>texte</replaceable> spécifié. La largeur de la boîte peut-être -emportée par l’argument optionnel <replaceable>largeur</replaceable>. La position du -texte au sein de la boîte est determinée par l’argument optionnel -<replaceable>position</replaceable> qui peut prendre l’une des valeurs suivantes : -</para> -<variablelist><varlistentry><term><literal>c</literal> -</term><listitem><para>Centré (par défaut). -</para></listitem></varlistentry><varlistentry><term><literal>l</literal> -</term><listitem><para>(Left) justifié à gauche. -</para></listitem></varlistentry><varlistentry><term><literal>r</literal> -</term><listitem><para>(Right) justifié à droite. -</para></listitem></varlistentry><varlistentry><term><literal>s</literal> -</term><listitem><para>(Stretch) justifié à travers la <replaceable>largeur</replaceable> entière ; <replaceable>texte</replaceable> doit -contenir de l’espace dilatable pour que cela marche. -</para></listitem></varlistentry></variablelist> -<para><literal>\makebox</literal> est aussi utilisé au sein de l’environnement <literal>picture</literal>, -see <link linkend="_005cmakebox-_0028picture_0029">\makebox (picture)</link>. -</para> - -</sect1> -<sect1 label="20.5" id="_005cparbox"> +<sect1 label="20.3" id="_005cparbox"> <title><literal>\parbox</literal></title> <indexterm role="fn"><primary>\parbox</primary></indexterm> <indexterm role="cp"><primary>paragraphe, mode</primary></indexterm> @@ -10517,7 +11483,7 @@ see <link linkend="_005cmakebox-_0028picture_0029">\makebox (picture)</link>. <para>La commande <literal>\parbox</literal> produit une boîte de texte de largeur <literal>largeur</literal>. Cette commande peut être utilisée pour fabriquer une boîte à partir de petits morceaux de texte, et contenant un seul -paragraphe. Cette commande est fragile (see <link linkend="_005cprotect">\protect</link>). +paragraphe. Cette commande est fragile (voir <link linkend="_005cprotect">\protect</link>). </para> <screen>\begin{picture}(0,0) ... @@ -10526,10 +11492,10 @@ paragraphe. Cette commande est fragile (see <link linkend="_005cprotect">\protec exponentielle.}} \end{picture} </screen> -<para>Le <replaceable>contenu</replaceable> est taité en mode texte (see <link linkend="Modes">Modes</link>) ainsi +<para>Le <replaceable>contenu</replaceable> est taité en mode texte (voir <link linkend="Modes">Modes</link>) ainsi &latex; fait des sauts de ligne de sorte à former un paragraphe. Mais il ne fabriquera pas plusieurs paragraphes ; pour cela, utilisez un -environnement <literal>minipage</literal> (see <link linkend="minipage">minipage</link>). +environnement <literal>minipage</literal> (voir <link linkend="minipage">minipage</link>). </para> <para>Les options d’une <literal>\parbox</literal> (à l’exception du <replaceable>contenu</replaceable>) sont les mêmes que pour une <literal>minipage</literal>. Par commodité on rappelle ces @@ -10537,7 +11503,7 @@ options ici plus bas, mais se référer à <link linkend="minipage">minipage</l description complète. </para> <para>Il y a deux arguments obligatoires. La <replaceable>largeur</replaceable> est une longueur -rigide (see <link linkend="Lengths">Lengths</link>). Elle règle la largeur de la boîte dans +rigide (voir <link linkend="Lengths">Lengths</link>). Elle règle la largeur de la boîte dans laquelle &latex; compose le <literal>contenu</literal>. Le <literal>contenu</literal> est le texte qui est placé dans cette boîte. Il ne devrait pas avoir de composants qui fabriquent des paragraphes. @@ -10547,7 +11513,7 @@ composants qui fabriquent des paragraphes. <firstterm>parbox</firstterm> relativement au texte alentour. La valeurs prises en charge sont <literal>c</literal> ou <literal>m</literal> pour que le centre selon la dimension verticale de la parbox soit aligné avec le centre de la ligne de texte -adjacente (c’est le réglage par défaut), ou <literal>t</literal> pour s’accorder la +adjacente (c’est le réglage par défaut), ou <literal>t</literal> pour accorder la ligne du haut de la parbox avec la ligne de base du texte alentour, ou <literal>b</literal> pour accorder la ligne du bas. </para> @@ -10555,75 +11521,215 @@ ligne du haut de la parbox avec la ligne de base du texte alentour, ou la boîte. </para> <para>L’argument optionnel <replaceable>pos-interne</replaceable> contrôle la position du -<replaceable>contenu</replaceable> au sein de la parbox. Les valeurs possibles sont : -<literal>t</literal> pour le centrer verticalement, <literal>b</literal> pour le place en bas de -la boîte, et <literal>s</literal> pour le dilater verticalement (pour cela, le texte -doit contenir de l’espace vertical eslastique). +<replaceable>contenu</replaceable> au sein de la parbox. Sa valeur par défaut est la valeur +de <replaceable>position</replaceable>. Les valeurs possibles sont : <literal>t</literal> pour placer le +<replaceable>contenu</replaceable> en haut de la boîte, <literal>c</literal> pour le centrer +verticalement, <literal>b</literal> pour le place en bas de la boîte, et <literal>s</literal> +pour le dilater verticalement (pour cela, le texte doit contenir de +l’espace vertical elastique). </para> </sect1> -<sect1 label="20.6" id="_005craisebox"> +<sect1 label="20.4" id="_005craisebox"> <title><literal>\raisebox</literal></title> <indexterm role="fn"><primary>\raisebox</primary></indexterm> -<para>Synopsis : +<para>Synopsis, l’un parmi les suivants : </para> -<screen>\raisebox{<replaceable>distance</replaceable>}[<replaceable>hauteur</replaceable>][<replaceable>profondeur</replaceable>]{<replaceable>texte</replaceable>} +<screen>\raisebox{<replaceable>distance</replaceable>}{<replaceable>texte</replaceable>} +\raisebox{<replaceable>distance</replaceable>}[<replaceable>hauteur</replaceable>]{<replaceable>texte</replaceable>} +\raisebox{<replaceable>distance</replaceable>}[<replaceable>hauteur</replaceable>][<replaceable>profondeur</replaceable>]{<replaceable>texte</replaceable>} </screen> -<para>La commande <literal>\raisebox</literal> élève ou abaisse du <replaceable>texte</replaceable>. Le -premier argument obligatoire spécifie la longueur dont le <replaceable>texte</replaceable> -doit être élevé (ou abaissé si c’est une longueur négative). Le -<replaceable>texte</replaceable> lui-même est traité en mode LR. +<para>La commande <literal>\raisebox</literal> élève ou abaisse du <replaceable>texte</replaceable>. Cette +commande est fragile (voir <link linkend="_005cprotect">\protect</link>). +</para> +<para>L’exemple suivant fabrique une commande pour noter la restriction d’une +fonction en abaissant le symbole barre verticale. +</para> +<!-- credit: egreg https://tex.stackexchange.com/a/278631/121234 --> +<screen>\newcommand*\restreinte[1]{\raisebox{-.5ex}{$|$}_{#1}} +$f\restreinte{A}$ +</screen> +<para>Le premier argument obligatoire spécifie la longueur dont le <replaceable>texte</replaceable> +doit être élevé. C’est une longueur rigide (voir <link linkend="Lengths">Lengths</link>). Si elle +est négative alors <replaceable>texte</replaceable> est abaissé. Le <replaceable>texte</replaceable> lui-même est +traité en mode LR, aussi il ne doit pas contenir de saut de ligne +(voir <link linkend="Modes">Modes</link>). </para> <para>Les arguments optionnels <replaceable>hauteur</replaceable> et <replaceable>profondeur</replaceable> sont des -longueurs. S’ils sont spécifiés, &latex; traite <replaceable>texte</replaceable> comme s’il -s’étendait une certaine distance (<replaceable>hauteur</replaceable>) au-dessus de la ligne -de base, ou au dessous (<replaceable>profondeur</replaceable>), en ignorant ses hauteur et -profondeur naturelles. +dimensions. S’ils sont spécifiés, ils l’emportent sur les hauteur et +profondeur naturelles de la boîte que &latex; obtient en composant +<replaceable>texte</replaceable>. +</para> +<anchor id="raisebox-depth"/><anchor id="raisebox-height"/><anchor id="raisebox-width"/><anchor id="raisebox-totalheight"/><para>Au sein des arguments <replaceable>distance</replaceable>, <replaceable>hauteur</replaceable>, et <replaceable>profondeur</replaceable> +vous pouvez utiliser les longueurs suivantes qui font référence à la +dimension de la boîte que &latex; obtient en composant <replaceable>texte</replaceable> : +<literal>\depth</literal>, <literal>\height</literal>, <literal>\width</literal>, <literal>\totalheight</literal> (qui +est la somme de la hauteur et de la profondeur de la boîte). +</para> +<para>L’exemple suivant aligne deux graphiques sur leur bord supérieur (voir <link linkend="Graphics">Graphics</link>). +</para> +<!-- credit: FAQ https://texfaq.org/FAQ-topgraph --> +<screen>\usepackage{graphicx,calc} % dans le préambule + ... +\begin{center} + \raisebox{1ex-\height}{% + \includegraphics[width=0.4\linewidth]{lion.png}} + \qquad + \raisebox{1ex-\height}{% + \includegraphics[width=0.4\linewidth]{meta.png}} +\end{center} +</screen> +<para>Le premier <literal>\height</literal> est la hauteur de <filename>lion.png</filename> alors que le +second est celle de <filename>meta.png</filename>. </para> + </sect1> -<sect1 label="20.7" id="_005csavebox"> -<title><literal>\savebox</literal></title> +<sect1 label="20.5" id="_005csbox-_0026-_005csavebox"> +<title><literal>\sbox</literal> & <literal>\savebox</literal></title> +<indexterm role="fn"><primary>\sbox</primary></indexterm> <indexterm role="fn"><primary>\savebox</primary></indexterm> +<indexterm role="cp"><primary>boîte, sauvegarde</primary></indexterm> -<para>Synopsis : + +<para>Synopsis, l’un parmi les suivants : </para> -<screen>\savebox{<replaceable>\boxcmd</replaceable>}[<replaceable>largeur</replaceable>][<replaceable>pos</replaceable>]{<replaceable>texte</replaceable>} +<screen>\sbox{<replaceable>cmd-boîte</replaceable>}{<replaceable>texte</replaceable>} +\savebox{<replaceable>cmd-boîte</replaceable>}{<replaceable>texte</replaceable>} +\savebox{<replaceable>cmd-boîte</replaceable>}[<replaceable>largeur</replaceable>]{<replaceable>texte</replaceable>} +\savebox{<replaceable>cmd-boîte</replaceable>}[<replaceable>largeur</replaceable>][<replaceable>pos</replaceable>]{<replaceable>texte</replaceable>} </screen> <para>Cette commande compose <replaceable>texte</replaceable> dans une boîte de la même façon -qu’avec <literal>\makebox</literal> (see <link linkend="_005cmakebox">\makebox</link>), à ceci près qu’au lieu -d’imprimer la boîte résultante, elle la sauvegarde dans une boîte -étiquettée <replaceable>\boxcmd</replaceable>, ce qui doit avoir été déclaré avec -<literal>\newsavebox</literal> (see <link linkend="_005cnewsavebox">\newsavebox</link>). +qu’avec <literal>\makebox</literal> (voir <link linkend="_005cmbox-_0026-_005cmakebox">\mbox & \makebox</link>), à ceci près qu’au +lieu de sortir la boîte résultante, elle la sauvegarde dans un registre +boîte référencé par la variable nommée <replaceable>cmd-boîte</replaceable>. Le nom de +variable <replaceable>cmd-boîte</replaceable> commence avec une contr’oblique, <literal>\</literal>. Vous +devez préalablement avoir alloué le registre boîte <replaceable>cmd-boîte</replaceable> avec avec +<literal>\newsavebox</literal> (voir <link linkend="_005cnewsavebox">\newsavebox</link>). La commande <literal>\sbox</literal> est +robuste, alors que <literal>\savebox</literal> est fragile (voir <link linkend="_005cprotect">\protect</link>). +</para> +<para>L’exemple suivant crée et utilise un registre boîte. +</para> +<screen>\newsavebox{\nomcomplet} +\sbox{\nomcomplet}{Cadet Rousselle} + ... +\usebox{\nomcomplet} a trois maisons qui n'ont ni poutres, ni chevrons ! +C'est pour loger les hirondelles, +Que direz-vous d'\usebox{\nomcomplet} ? +</screen> +<para>Un avantage de l’usage répété d’un registre boîte par rapport à une +variable macro <literal>\newcommand</literal> est l’efficacité, c-à-d. que +&latex; n’a pas besoin de répeter la composition du contenu. Voir +l’exemple plus bas. +</para> +<para>Les deux invocations de commande +<literal>\sbox{<replaceable>cmd-boîte</replaceable>}{<replaceable>texte</replaceable>}</literal> et +<literal>\savebox{<replaceable>cmd-boîte</replaceable>}{<replaceable>texte</replaceable>}</literal> sont sensiblement +équivalentes. Quant à la troisième et la quatrième, les arguments +optionnels vous permettent de spécifier la largeur de la boîte comme +<replaceable>largeur</replaceable>, et la position du texte au sein de cette boîte comme +<replaceable>position</replaceable>. Voir <link linkend="_005cmbox-_0026-_005cmakebox">\mbox & \makebox</link>, pour une description complète. +</para> +<para>Dans les commandes <literal>\sbox</literal> et <literal>\savebox</literal> le <replaceable>texte</replaceable> est +composé en mode LR, aussi il n’a pas de sauts de lignes (voir <link linkend="Modes">Modes</link>). +Si vous utilisez ce qui suit alors &latex; ne produit pas d’erreur mais +ignore ce que vous voulez faire : si vous entrez +<literal>\sbox{\nouvreg}{test \\ test}</literal> et <literal>\usebox{\nouvreg}</literal> +alors vous obtenez ‘<literal>testtest</literal>’, et si vous entrez +<literal>\sbox{\nouvreg}{test \par test}</literal> et <literal>\usebox{\nouvreg}</literal> +alors vous obtenez ‘<literal>test test</literal>’, mais ni erreur ni avertissement. +La solution est d’utiliser une <literal>\parbox</literal> ou une <literal>minipage</literal> +comme dans l’exemple qui suit : +</para> +<!-- credit: egreg https://tex.stackexchange.com/a/41668/121234 --> +<screen>\savebox{\unreg}{% + \begin{minipage}{\linewidth} + \begin{enumerate} + \item Premier article + \item Second article + \end{enumerate} + \end{minipage}} + ... +\usebox{\unreg} +</screen> +<para>En exemple de l’efficacité de réutiliser le contenu d’un registre boîte, +ce qui suit place la même image sur chaque page du document en le +plaçant dans l’en-tête. &latex; ne la compose qu’une fois. +</para> +<screen>\usepackage{graphicx} % tout cela dans le préambule +\newsavebox{\cachetreg} +\savebox{\cachetreg}{% + \setlength{\unitlength}{2.5cm}% + \begin{picture}(0,0)% + \put(1.5,-2.5){% + \begin{tabular}{c} + \includegraphics[height=5cm]{companylogo.png} \\ + Bureau du Président + \end{tabular}} + \end{picture}% +} +\markright{\usebox{\cachetreg}} +\pagestyle{headings} +</screen> +<para>L’environnment <literal>picture</literal> est bien adapté pour régler finement le +placement. +</para> +<para>Si le registre <literal>\noreg</literal> n’a pas déjà été défini alors vous obtenez +quelque-chose du genre de ‘<literal>Undefined control sequence. <argument> +\noreg</literal>’. </para> - </sect1> -<sect1 label="20.8" id="_005csbox"> -<title><literal>\sbox{<replaceable>\boxcmd</replaceable>}{<replaceable>texte</replaceable>}</literal></title> -<indexterm role="fn"><primary>\sbox</primary></indexterm> +<sect1 label="20.6" id="lrbox"> +<title><literal>lrbox</literal></title> +<indexterm role="fn"><primary>lrbox</primary></indexterm> <para>Synopsis : </para> -<screen>\sbox{<replaceable>\boxcmd</replaceable>}{<replaceable>texte</replaceable>} +<screen>\begin{lrbox}{<replaceable>cmd-boîte</replaceable>} + <replaceable>texte </replaceable> +\end{lrbox} +</screen> +<para>ACeci est la forme par environnement des commandes <literal>\sbox</literal> et +<literal>\savebox</literal>, et leur est équivalent. Voir <link linkend="_005csbox-_0026-_005csavebox">\sbox & \savebox</link>, pour +une description complète. +</para> +<para>Le <replaceable>texte</replaceable> au sein de l’environnement est sauvegardé dans un +registre boîte auquel la vartiable <literal><replaceable>cmd-boîte</replaceable></literal> fait +référence. Le nom de variable <replaceable>cmd-boîte</replaceable> doit commencer par une +contr’oblique, <literal>\</literal>. Vous devez avoir alloué ce registre boîte +préalablement avec <literal>\newsavebox</literal> (voir <link linkend="_005cnewsavebox">\newsavebox</link>). Dans +l’exemple suivannt l’environnement est commode pour entrer le +<literal>tabular</literal> : +</para> +<screen>\newsavebox{\jhreg} +\begin{lrbox}{\jhreg} + \begin{tabular}{c} + \includegraphics[height=1in]{jh.png} \\ + Jim Hef{}feron + \end{tabular} +\end{lrbox} + ... +\usebox{\jhreg} </screen> -<para><literal>\sbox</literal> tape <replaceable>texte</replaceable> au sein d’une boîte tout comme <literal>\mbox</literal> -(see <link linkend="_005cmbox">\mbox</link>) à 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 <replaceable>\boxcmd</replaceable>. <replaceable>\boxcmd</replaceable> doit avoir été préalablement -déclarée avec <literal>\newsavebox</literal> (see <link linkend="_005cnewsavebox">\newsavebox</link>). -</para> + </sect1> -<sect1 label="20.9" id="_005cusebox"> -<title><literal>\usebox{<replaceable>\boxcmd</replaceable>}</literal></title> +<sect1 label="20.7" id="_005cusebox"> +<title><literal>\usebox</literal></title> <indexterm role="fn"><primary>\usebox</primary></indexterm> +<indexterm role="cp"><primary>boîte, utilise une boîte sauvegardée</primary></indexterm> <para>Synopsis : </para> -<screen>\usebox{<replaceable>\boxcmd</replaceable>} +<screen>\usebox{<replaceable>cmd-boîte</replaceable>} </screen> -<para><literal>\usebox</literal> produit la boîte la plus récemment sauvegardée dans le -bac <replaceable>\boxcmd</replaceable> par une commande <literal>\savebox</literal> (see <link linkend="_005csavebox">\savebox</link>). +<para>La commande <literal>\usebox</literal> produit la boîte la plus récemment +sauvegardée dans le registre boîte <replaceable>cmd-boîte</replaceable> par une commande +<literal>\sbox</literal> ou <literal>\savebox</literal>, ou l’environnement +<literal>lrbox</literal>. Voir <link linkend="_005csbox-_0026-_005csavebox">\sbox & \savebox</link>, pour plus ample information et +des exemples. (Notez que le nom de la variable <replaceable>cmd-boîte</replaceable> commence +par une contr’oblique, <literal>\</literal>). Cette commande est robuste +(voir <link linkend="_005cprotect">\protect</link>). </para> </sect1> </chapter> @@ -10853,7 +11959,7 @@ coup par coup. C’est le cas d’usage des secondes forme du synopsis. <screen>Des couleurs de \textcolor[rgb]{0.33,0.14,0.47}{violet} et {\color[rgb]{0.72,0.60,0.37}doré} pour l'équipe </screen> <para>Le format de <replaceable>spécification de couleur</replaceable> dépend du modèle de couleur -(see <link linkend="Color-models">Color models</link>). Par exemple, alors que <literal>rgb</literal> prend trois +(voir <link linkend="Color-models">Color models</link>). Par exemple, alors que <literal>rgb</literal> prend trois nombbres, <literal>gray</literal> n’en prend qu’un. </para> <screen>La sélection a été \textcolor[gray]{0.5}{grisée}. @@ -10900,7 +12006,7 @@ bleu : <screen>\colorbox{blue}{\textcolor{white}{Welcome to the machine.}} </screen> <para>La commande <literal>\fcolorbox</literal> utilise les mêmes paramètres que -<literal>\fbox</literal> (see <link linkend="_005cfbox-and-_005cframebox">\fbox and \framebox</link>), à savoir <literal>\fboxrule</literal> et +<literal>\fbox</literal> (voir <link linkend="_005cfbox-_0026-_005cframebox">\fbox & \framebox</link>), à savoir <literal>\fboxrule</literal> et <literal>\fboxsep</literal>, pour régler l’épaisseur du filet et de la séparation entre l’intérieur de la boîte et le filet l’entourant. Les valeurs par défaut de &latex; sont <literal>0.4pt</literal> et <literal>3pt</literal> respectivement. @@ -10929,7 +12035,7 @@ en vigueur à la fin de la seconde ligne. </screen> <para>Les deux premières commandes règlent l’arrière-plan de la page, et de toutes les pages suivantes, à la couleur indiquée. Pour une explication -de la spécification dans la seconde forme see <link linkend="Colored-text">Colored text</link>. La +de la spécification dans la seconde forme voir <link linkend="Colored-text">Colored text</link>. La troisième fait revenir l’arrière-plan à la normale, c-à-d. un arrière-plan transparent. (Si cela n’est pas pris en charge, alors utilisez <literal>\pagecolor{white}</literal>, bien que cela produit un @@ -10978,7 +12084,7 @@ ils ont une taille plus petites. <para>Il y a des systèmes particulièrement bien adapté pour produire des graphiques pour un document &latex;. Par exemple, qui vous permettent d’utiliser les mêmes polices que dans votre document. &latex; comprend -un environnement <literal>picture</literal> (see <link linkend="picture">picture</link>) qui a des possibilités +un environnement <literal>picture</literal> (voir <link linkend="picture">picture</link>) qui a des possibilités de base. En plus de cela, il y a d’autres façons d’inclure des commandes de production de graphiques dans le document. Deux systèmes pour cela sont les paquetages PSTricks et TikZ. Il y a aussi des @@ -11116,7 +12222,7 @@ graphiques. Ceci permet d’écrire plus tard quelque chose du genre de </para> <para>&latex; recherche toujours en premier les fichiers graphiques dans le répertoire courant (et dans le répertoire de sortie, si spécifié ; -see <link linkend="output-directory">output directory</link>). La déclaration ci-dessous dit au système de +voir <link linkend="output-directory">output directory</link>). La déclaration ci-dessous dit au système de regarder ensuite dans le sous-répertoire <filename>img</filename>, et ensuite <filename>../img</filename>. </para> @@ -11201,7 +12307,7 @@ avant les fichiers PDF. </screen> <para>Du fait que le nom <filename>lion</filename> ne contient pas de point, &latex; utilise la liste d’extension. Pour chacun des répertoires dans la liste -de chemins graphiques (see <link linkend="_005cgraphicspath">\graphicspath</link>), &latex; essaie les +de chemins graphiques (voir <link linkend="_005cgraphicspath">\graphicspath</link>), &latex; essaie les extensions dans l’ordre donné. S’il ne trouve aucun fichier correspondant après avoir essayé tous les répertoires et toutes les extensions, alors il renvoie une erreur ‘<literal>! LaTeX Error: File @@ -11218,8 +12324,13 @@ votre document ; le pilote d’impression a une valeur par défaut raisonnable. Par exemple, la version la plus récente de <filename>pdftex.def</filename> a cette liste d’extensions. </para> -<screen>.png,.pdf,.jpg,.mps,.jpeg,.jbig2,.jb2,.PNG,.PDF,.JPG,.JPEG,.JBIG2,.JB2 +<screen>.pdf,.png,.jpg,.mps,.jpeg,.jbig2,.jb2,.PDF,.PNG,.JPG,.JPEG,.JBIG2,.JB2 </screen> +<indexterm role="fn"><primary>paquetage <literal>grfext</literal></primary></indexterm> +<indexterm role="fn"><primary><literal>grfext</literal>, paquetage</primary></indexterm> + +<para>Pour modifier cet ordre, utilisez le paquetage <literal>grfext</literal>. +</para> <para>Vous pouvez utiliser cette commande n’importe où dans le document. Vous pouvez l’utiliser plus d’une fois. On peut afficher la valeur courante avec <literal>\makeatletter\typeout{\Gin@extensions}\makeatother</literal>. @@ -11369,7 +12480,7 @@ spécifiée se superpose à ce qui l’entoure. et à sa taille nominale. Vous pouvez aussi donner un chemin au fichier, comme dans <literal>\includegraphics{graphiques/trace.pdf}</literal>. Pour spécifier une liste de répertoire ou rechercher le fichier, -see <link linkend="_005cgraphicspath">\graphicspath</link>. +voir <link linkend="_005cgraphicspath">\graphicspath</link>. </para> <para>Si votre nom de fichier comprend des espaces, alors placer le entre guillemets anglais. Par exemple comme dans @@ -11381,7 +12492,7 @@ de graphique en segmentant <replaceable>nomfichier</replaceable> sur le premier de fihcier, comme dans <literal>\includegraphics{turing}</literal> et &latex; essaie une séquence d’extension telle que <literal>.png</literal> et <literal>.pdf</literal> jusqu’à ce qu’il trouve un fichier avec cette extension -(see <link linkend="_005cDeclareGraphicsExtensions">\DeclareGraphicsExtensions</link>). +(voir <link linkend="_005cDeclareGraphicsExtensions">\DeclareGraphicsExtensions</link>). </para> <para>Si votre fichier comprend des points avantr l’extension alors vous pouvez les cacher avec des accolades, comme dans @@ -11394,7 +12505,7 @@ noms de fichiers, et d’autres sont aussi traités par le paquetage <para>L’exemple ci-après place un graphique dans un environnement <literal>figure</literal> de sorte que &latex; puisse le déplacer sur la page suivante si le faire rentrer dans la page courante rend mal -(see <link linkend="figure">figure</link>). +(voir <link linkend="figure">figure</link>). </para> <screen>\begin{figure} \centering @@ -11434,7 +12545,7 @@ disponibles concernent la taille du graphique (mais voir <link linkend="_005crotatebox">\rotatebox</link> et <link linkend="_005cscalebox">\scalebox</link>). Quand un argument optionnel est présent alors c’est <literal>[<replaceable>urx</replaceable>,<replaceable>ury</replaceable>]</literal> et il donne les coordonnées du coin en haut à droite de l’image, comme une paire de -dimensions &tex; (see <link linkend="Units-of-length">Units of length</link>). Si les unités sont omises, +dimensions &tex; (voir <link linkend="Units-of-length">Units of length</link>). Si les unités sont omises, alors par défaut l’unité considérée est le <literal>bp</literal>. Dans ce cas, le coin en bas à gaéuche de l’image est supposée être à (0,0). Si deux arguments optionnels sont présents alors le premier est @@ -11475,9 +12586,9 @@ boîtes, et celle-ci est la boîte allouée pour le graphique. </term><listitem><para>Le graphique est affiché de sorte que sa boîte englobante ait cette largeur. Un exemple est <literal>\includegraphics[width=2.5cm]{trace}</literal>. Vous pouvez utiliser les unités de longueur standardes de &tex; -(see <link linkend="Units-of-length">Units of length</link>) et également il est commode d’utiliser +(voir <link linkend="Units-of-length">Units of length</link>) et également il est commode d’utiliser <literal>\linewidth</literal>, ou, dans un document recto-verso, <literal>\columnwidth</literal> -(see <link linkend="Page-layout-parameters">Page layout parameters</link>). Un exemple est qu’en utilisant le +(voir <link linkend="Page-layout-parameters">Page layout parameters</link>). Un exemple est qu’en utilisant le paquetage <filename>calc</filename> vous pouvez rendre le graphique 1cm plus étroit que la largeur du texte avec <literal>\includegraphics[width=\linewidth-1.0cm]{hefferon.jpg}</literal>. @@ -11486,8 +12597,8 @@ paquetage <filename>calc</filename> vous pouvez rendre le graphique 1cm plus </term><listitem><anchor id="includegraphics-height"/> <para>Le graphique est affiché de sorte que sa boîte englobante est de cette hauteur. Vous pouvez utiliser les unités de longueur standardes de -&tex; (see <link linkend="Units-of-length">Units of length</link>), et également il est commode d’utiliser -<literal>\pageheight</literal> et <literal>\textheight</literal> (see <link linkend="Page-layout-parameters">Page layout +&tex; (voir <link linkend="Units-of-length">Units of length</link>), et également il est commode d’utiliser +<literal>\pageheight</literal> et <literal>\textheight</literal> (voir <link linkend="Page-layout-parameters">Page layout parameters</link>). Par exemple, la commande <literal>\includegraphics[height=0.25\textheight]{godel}</literal> rend le graphique d’une hauteur d’un quart de celle de la zone de texte. @@ -11522,7 +12633,7 @@ graphique n’est ni plus large que <literal>width</literal> ni plus haut qu dans le sens anti-horaire. La rotation est effectuée autour de l’origine donnée par l’option <literal>origin</literal> ; s’y référer. Pour une descrition complète de la compositiion de matériel ayant subi une -rotation, see <link linkend="_005crotatebox">\rotatebox</link>. +rotation, voir <link linkend="_005crotatebox">\rotatebox</link>. </para> </listitem></varlistentry><varlistentry><term><literal>origin</literal> </term><listitem><para>Le point du graphique autour duquel la rotation s’effectue. Les valeurs @@ -11540,7 +12651,7 @@ le centre vertical dans <literal>lc</literal> <literal>rc</literal>). Le réglag <literal>lB</literal>. </para> <para>Pour faire une rotation autour d’un point arbitraire, -see <link linkend="_005crotatebox">\rotatebox</link>. +voir <link linkend="_005crotatebox">\rotatebox</link>. </para> </listitem></varlistentry></variablelist> <para>Voici maintenant des options moins usuelles. @@ -11665,7 +12776,7 @@ méthode par laquelle &latex; choisit le type d’un graphique en fonction de son extension de nom de fichier. Par exemple avec <literal>\includegraphics[type=png,ext=.xxx,read=.xxx]{lion}</literal> le fichier <filename>lion.xxx</filename> est lu comme s’il s’agissait de <filename>lion.png</filename>. Pour -plus ample information, see <link linkend="_005cDeclareGraphicsRule">\DeclareGraphicsRule</link>. +plus ample information, voir <link linkend="_005cDeclareGraphicsRule">\DeclareGraphicsRule</link>. </para> <variablelist><anchor id="includegraphics-type"/><varlistentry><term><literal>type</literal> </term><listitem><para>Spécifie le type de graphique. @@ -11680,7 +12791,7 @@ l’option <literal>type</literal>. </para> <anchor id="includegraphics-command"/></listitem></varlistentry><varlistentry><term><literal>command</literal> </term><listitem><para>Spécifie une commande à appliquer à ce fichier. À n’utiliser qu’en -conjonction avec l’option <literal>type</literal>. See <link linkend="Command-line-options">Command line options</link>, +conjonction avec l’option <literal>type</literal>. Voir <link linkend="Command-line-options">Command line options</link>, pour une discussion sur l’activation de la fonctionalité <literal>\write18</literal> pour exécuter des commandes externes. </para> @@ -11719,7 +12830,7 @@ pour exécuter des commandes externes. <screen> \rotatebox[origin=c]{45}{\includegraphics[width=1in]{lion}} </screen> <para>You can get the same effect using the <filename>graphicx</filename> package alone -(see <link linkend="_005cincludegraphics">\includegraphics</link>). +(voir <link linkend="_005cincludegraphics">\includegraphics</link>). </para> <para>To place the rotated material, the first step is that &latex; sets <replaceable>material</replaceable> in a box, with a reference point on the left baseline. @@ -11750,7 +12861,7 @@ vertical center in <literal>lc</literal> or <literal>rc</literal>.) The default </listitem></varlistentry><varlistentry><term><literal>x, y</literal> </term><listitem><para>Specify an arbitrary point of rotation with <literal>\rotatebox[x=<replaceable>&tex; dimension</replaceable>,y=<replaceable>&tex; -dimension</replaceable>]{...}</literal> (see <link linkend="Units-of-length">Units of length</link>). These give the offset +dimension</replaceable>]{...}</literal> (voir <link linkend="Units-of-length">Units of length</link>). These give the offset from the box’s reference point. </para> </listitem></varlistentry><varlistentry><term><literal>units</literal> @@ -11793,7 +12904,7 @@ defaults to the same value as the <replaceable>horizontal factor</replaceable>. <literal>\scalebox{0.5}{\includegraphics{lion}}</literal>. If you use the <filename>graphicx</filename> package then you can accomplish the same thing with optional arguments to <literal>\includegraphics</literal> -(see <link linkend="_005cincludegraphics">\includegraphics</link>). +(voir <link linkend="_005cincludegraphics">\includegraphics</link>). </para> <para>The <literal>\reflectbox</literal> command abbreviates <literal>\scalebox{-1}[1]{<replaceable>material</replaceable>}</literal>. Thus, <literal>Able was @@ -11925,7 +13036,7 @@ sauter à la ligne. caractères accessibles par des commandes telles que <literal>\ae</literal> ou <literal>\aa</literal>. Ces commandes <literal>\MakeUppercase</literal> et <literal>\MakeLowercase</literal> sont robustes, mais elles ont des arguments -mouvants (see <link linkend="_005cprotect">\protect</link>). +mouvants (voir <link linkend="_005cprotect">\protect</link>). </para> <para>Ces commandes ne changent pas la casse des lettres utilisées dans le nom d’une commande au sein de <replaceable>texte</replaceable>. Mais par contre elles changent la @@ -11986,11 +13097,12 @@ aperçu du sujet, passé et présent. <para>Vous pouvez accéder à n’importe quel caractère de la police courante en utilisant son numéro avec la commande <literal>\symbol</literal>. Par exemple, le caractère espace visible utilisé dans la commande <literal>\verb*</literal> a le -code décimal 32, ainsi on peut le taper avec <literal>\symbol{32}</literal>. +code décimal 32 dans la police standarde tapuscrite Compuer Modern, +ainsi on peut le taper avec <literal>\symbol{32}</literal>. </para> <para>Vous pouvez également spécifier le numéro en octal (base 8) en utilisant un préfixe <literal>'</literal>, ou en hexadécimal (base 16) avec un préfixe -<literal>"</literal>, ainsi l’exemple précédent pourrait tout aussi bien être écrit +<literal>"</literal>, ainsi l’espace visible de code 32 en décimal pourrait tout aussi bien être écrit comme <literal>\symbol{'40}</literal> ou <literal>\symbol{"20}</literal>. </para> @@ -12000,10 +13112,14 @@ comme <literal>\symbol{'40}</literal> ou <literal>\symbol{"20}</literal>. <indexterm role="cp"><primary>symboles texte</primary></indexterm> <indexterm role="fn"><primary>textcomp, paquetage</primary></indexterm> +<indexterm role="cp"><primary>TS1, codage</primary></indexterm> <para>&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 <literal>textcomp</literal>. +en particulier les plus obscures, ne sont pas disponible en OT1. Depuis +la parution de février 2020 de &latex; tous ces symboles sont disponibles +par défaut ; avant cela, il était nécessaire d’utiliser le paquetage +<literal>textcomp</literal> pour certains d’enter eux (techniquement, ce qui sont +dans le codage de police <literal>TS1</literal>). </para> <variablelist> <varlistentry><term><indexterm role="fn"><primary>\copyright</primary></indexterm><literal>\copyright</literal> @@ -12177,17 +13293,23 @@ hauteur de capitale de la fonte, alors que la forme </para> </listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\textemdash (ou <literal>---</literal>)</primary></indexterm><literal>\textemdash (ou <literal>---</literal>)</literal> </term><listitem><indexterm role="cp"><primary>cadratin</primary></indexterm> -<para>Cadratin : — (pour la ponctuation). +<para>Cadratin : —. Utilisé pour la ponctuation, d’ordinaire similaire à une virugules ou des parenthèse comme dans « <literal>Les éliminatoires --- si vous assez de chance pour y arriver --- c'est comme si ça se passait d'un trait.</literal> » </para> </listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\textendash (ou <literal>--</literal>)</primary></indexterm><literal>\textendash (ou <literal>--</literal>)</literal> </term><listitem><indexterm role="cp"><primary>cadratin, demi</primary></indexterm> <indexterm role="cp"><primary>demi-cadratin</primary></indexterm> -<para>Demi cadratin : – (pour les plages en anglais). +<para>Demi cadratin : –. Utilisé pour les plages en anglais comme dans « <literal>see pages 12--14</literal> ». </para> </listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\texteuro</primary></indexterm><literal>\texteuro</literal> </term><listitem><indexterm role="cp"><primary>euro, symbole</primary></indexterm> <indexterm role="cp"><primary>monnaie, euro</primary></indexterm> -<para>Le symbole Euro : €. +<para>Le symbole monétaire Euro : €. +<indexterm role="fn"><primary>paquetage <literal>eurosym</literal></primary></indexterm> +<indexterm role="fn"><primary><literal>eurosym</literal>, paquetage</primary></indexterm> +</para> +<para>Pour un dessin alternatif du glyphe, essayez le paquetage +<filename>eurosym</filename> ; de plus, la plupart des polices de nos jour sont +fournies avec leur propre symbole Euro (Unicode U+20AC). </para> </listitem></varlistentry><varlistentry><term><indexterm role="fn"><primary>\textexclamdown (ou <literal>!`</literal>)</primary></indexterm><literal>\textexclamdown (ou <literal>!`</literal>)</literal> </term><listitem><indexterm role="cp"><primary>point d’exclamation culbuté</primary></indexterm> @@ -12332,7 +13454,7 @@ disponible avec l’OT1. <indexterm role="cp"><primary>diacrtique accent aigu</primary></indexterm> <para>Produit un accent aigu, comme dans ó. Dans l’environnement <literal>tabbing</literal>, pousse la colonne courante à droite de la colonne -précédente (see <link linkend="tabbing">tabbing</link>). +précédente (voir <link linkend="tabbing">tabbing</link>). </para> </listitem></varlistentry><varlistentry><term><literal>\.</literal> </term><listitem><indexterm role="fn"><primary>\. (dot-over accent)</primary></indexterm> @@ -12373,7 +13495,7 @@ dans ō. <indexterm role="cp"><primary>grave accent</primary></indexterm> <para>Produit un accent grave suscrit à la lettre qui suit, comme dans ò. Au sein de l’environnement <literal>tabbing</literal>, déplace le texte qui -suit à la marge de droite (see <link linkend="tabbing">tabbing</link>). +suit à la marge de droite (voir <link linkend="tabbing">tabbing</link>). </para> </listitem></varlistentry><varlistentry><term><literal>\~</literal> </term><term><literal>\capitaltilde</literal> @@ -12632,7 +13754,7 @@ un rectangle. Les arguments sont : <para>La commande <literal>\today</literal> produit la date d’aujourd’hui, par défaut dans le format ‘<literal><replaceable>mois</replaceable> <replaceable>jj</replaceable>, <replaceable>aaaa</replaceable></literal>’ ; par exemple, ‘July 4, 1976’. Elle utilise les compteurs prédéfinis <literal>\day</literal>, -<literal>\month</literal>, et <literal>\year</literal> (see <link linkend="_005cday-_005cmonth-_005cyear">\day \month \year</link>) pour faire +<literal>\month</literal>, et <literal>\year</literal> (voir <link linkend="_005cday-_005cmonth-_005cyear">\day \month \year</link>) pour faire cela. Elle n’est pas mise à jour durant l’execution de la compilation. </para> <para>Les extensions multilingues comme entre autres le paquetage <filename>babel</filename> @@ -12706,7 +13828,7 @@ de la commande <literal>\includeonly</literal> est que &latex; retient les numé de page et toute l’information de renvoi des autres parties du document de sorte qu’elles apparaissent correctement en sortie. </para> -<para>See <link linkend="Larger-book-template">Larger book template</link> pour un autre exemple de <literal>\includeonly</literal>. +<para>Voir <link linkend="Larger-book-template">Larger book template</link> pour un autre exemple de <literal>\includeonly</literal>. </para> <!-- xxx Pourquoi avoir supprimer cette ref. --> <!-- @xref{filecontents}, pour un environnement qui permet de grouper un --> @@ -12771,7 +13893,7 @@ fermer un <literal>\if...</literal> par un <literal>\fi</literal>. dans un document &latex;. </para> <para>La commande <literal>\include</literal> fait trois choses : elle exécute -<literal>\clearpage</literal> (see <link linkend="_005cclearpage-_0026-_005ccleardoublepage">\clearpage & \cleardoublepage</link>), puis elle +<literal>\clearpage</literal> (voir <link linkend="_005cclearpage-_0026-_005ccleardoublepage">\clearpage & \cleardoublepage</link>), puis elle insère le matériel à partir du fichier <filename><replaceable>nomfichier</replaceable>.tex</filename> dans le document, ensuite fait encore un <literal>\clearpage</literal>. Cette commande ne peut apparaître que dans le corps du document. @@ -12812,7 +13934,7 @@ l’Homme et aux principes de la souveraineté nationale tels qu’ils ont matériel issu de ces trois fichiers dans le document mais génère également les fichiers auxiliaires <filename>preamble.aux</filename>, <filename>articles.aux</filename>, et <filename>amendements.aux</filename>. Ceux-ci contiennent de -l’information telle que les numéros de page et les renvois (see <link linkend="Cross-references">Cross +l’information telle que les numéros de page et les renvois (voir <link linkend="Cross-references">Cross references</link>). Si maintenant vous mettez en commentaire les lignes de <literal>\includeonly</literal> contenant <literal>preambule</literal> et <literal>amendements</literal> et exécutez &latex; de nouveau alors le document résultant ne contiendra @@ -12829,7 +13951,7 @@ alors &latex; inclut tous les fichiers demandés par des commandes cela, voir <link linkend="_005cinput">\input</link> (ce qui, cependant, ne retient pas l’information auxiliaire). </para> -<para>See <link linkend="Larger-book-template">Larger book template</link> pour un autre exemple utilisant +<para>Voir <link linkend="Larger-book-template">Larger book template</link> pour un autre exemple utilisant <literal>\include</literal> et <literal>\includeonly</literal>. Cet exemple utilise également <literal>\input</literal> pour certain matériel qui ne débute pas nécessairement sur une nouvelle page. @@ -12965,9 +14087,9 @@ première page du livre. <para>En décommentant la deuxième ligne on peut limiter la table à ne lister que les rubriques issues de <literal>\chapter</literal> et <literal>\section</literal>, mais pas celle issue de <literal>\subsection</literal>, parce que la commande <literal>\section</literal> -a pour niveau 1. See <link linkend="Sectioning">Sectioning</link> pour les numéros de niveaux des +a pour niveau 1. Voir <link linkend="Sectioning">Sectioning</link> pour les numéros de niveaux des rubriques. Pour plus ample information sur <literal>tocdepth</literal> -see <link linkend="Sectioning_002ftocdepth">Sectioning/tocdepth</link>. +voir <link linkend="Sectioning_002ftocdepth">Sectioning/tocdepth</link>. </para> <para>Un autre exemple de l’utilisation de <literal>\tableofcontents</literal> est dans <link linkend="Larger-book-template">Larger book template</link>. @@ -12977,7 +14099,7 @@ see <link linkend="Sectioning_002ftocdepth">Sectioning/tocdepth</link>. </para> <para>Pour fabriquer la table des matières, &latex; stocke l’information dans un fichier auxiliaire nommé <filename><replaceable>fichier-racine</replaceable>.toc</filename> -(see <link linkend="Splitting-the-input">Splitting the input</link>). Par exemple, le fichier +(voir <link linkend="Splitting-the-input">Splitting the input</link>). Par exemple, le fichier &latex; <filename>test.tex</filename> ci-dessous : </para> <screen>\documentclass{article} @@ -13361,7 +14483,7 @@ individuel. </para> <para>Cette commande est optionnelle : sans la déclaration <literal>\address</literal> la lettre est formatée avec un espace à blanc en haut de sorte à pouvoir -être imprimée sur du papier à en-tête pré-imprimé. (See <link linkend="Overview">Overview</link>, +être imprimée sur du papier à en-tête pré-imprimé. (Voir <link linkend="Overview">Overview</link>, pour les détails concernant votre implémentation locale). Avec la déclaration <literal>\address</literal>, elle est formatée comme une lettre personnelle. @@ -13693,7 +14815,7 @@ ni espace. <para>Pour <literal>\openin</literal>, si &tex; ne peut pas trouver le fichier alors il ne produit pas une erreur. Il ne fait que considérer que ce flux n’est pas ouvert (ce qu’on peut vérifier avec <literal>\ifeof</literal> ; on peut -également recourir à la commande <literal>\InputIfFileExists</literal>, see <link linkend="Class-and-package-commands">Class +également recourir à la commande <literal>\InputIfFileExists</literal>, voir <link linkend="Class-and-package-commands">Class and package commands</link>). Si vous essayer d’utiliser le même numéro deux fois, &latex; ne produit pas d’erreur. Si vous essayer d’utiliser un mauvais numéro, alors vous obtiendrez un message d’erreur du genre de @@ -13729,10 +14851,10 @@ ensuite ferme le fichier. avec ce numéro n’est ouvert, ou si le fichier est à sa fin, alors <literal>\read</literal> prend son entrée à partir du terminal. Notez, cependant, que la méthode naturelle en &latex; de prendre en entrée à partir du -terminal est <literal>\typein</literal> (see <link linkend="_005ctypein">\typein</link>). +terminal est <literal>\typein</literal> (voir <link linkend="_005ctypein">\typein</link>). </para> <para>Pour lire un fichier entier en une fois utilisez <literal>\input</literal> -(see <link linkend="_005cinput">\input</link>) ou <literal>\include</literal> (see <link linkend="_005cinclude-_0026-_005cincludeonly">\include & \includeonly</link>). +(voir <link linkend="_005cinput">\input</link>) ou <literal>\include</literal> (voir <link linkend="_005cinclude-_0026-_005cincludeonly">\include & \includeonly</link>). </para> <indexterm role="fn"><primary>paquetage <literal>datatool</literal></primary></indexterm> <indexterm role="fn"><primary><literal>datatool</literal>, paquetage</primary></indexterm> @@ -13747,6 +14869,7 @@ du publipostage. CTAN a plusieurs paquetage pour cela ; parmi lesquels <title><literal>\typein[<replaceable>cmd</replaceable>]{<replaceable>msg</replaceable>}</literal></title> <indexterm role="fn"><primary>\typein</primary></indexterm> +<!-- xxx Realigner sur l'anglais --> <para>Synopsis : </para> <screen>\typein[<replaceable>\cmd</replaceable>]{<replaceable>msg</replaceable>} @@ -13754,7 +14877,7 @@ du publipostage. CTAN a plusieurs paquetage pour cela ; parmi lesquels <para><literal>\typein</literal> tape <replaceable>msg</replaceable> 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 <replaceable>\cmd</replaceable> est -omis, l’netrée tapée est traitée comme si elle avec été incluse dans le +omis, l’entrée tapée est traitée comme si elle avec été incluse dans le fichier d’entrée à la place de la commande <literal>\typein</literal>. Si l’argument <replaceable>\cmd</replaceable> 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 @@ -13825,7 +14948,7 @@ si il n’est pas associé à un fichier ouvert alors &latex; écrit ne plus &latex; écrit <replaceable>chaîne</replaceable> vers le terminal. Ainsi, <literal>test \write-1{Bonjour tout le monde !}</literal> place ‘<literal>Bonjour tout le monde !</literal>’ suivi d’un saut de ligne dans le fichier journal (c’est cez que -la commande <literal>\wlog</literal> fait ; see <link linkend="_005cwlog">\wlog</link>). Et +la commande <literal>\wlog</literal> fait ; voir <link linkend="_005cwlog">\wlog</link>). Et <literal>\write100{Bonjour tout le monde !}</literal> met la même chose dans le fichier jornal mais aussi met ‘<literal>Bonjour tout le monde !</literal>’ suivi d’un saut de ligne dans la sortie terminal. (Mais 16, 17, et 18 sont des @@ -13833,7 +14956,7 @@ valeurs spéciales de <replaceable>numéro</replaceable> ; voir ci-dessous.) </para> <indexterm role="cp"><primary>Lua&tex;, 256 flux de sortie dans</primary></indexterm> <para>Dans Lua&tex;, au lieu de 16 flux de sortie il y en a 256 -(see <link linkend="TeX-engines">&tex; engines</link>). +(voir <link linkend="TeX-engines">&tex; engines</link>). </para> <indexterm role="fn"><primary>\@auxout</primary></indexterm> <indexterm role="fn"><primary>\@mainaux</primary></indexterm> @@ -13902,9 +15025,9 @@ l’intervalle de 0 à 15 qu’on a déjà décrit plus haut, dans Plain <literal>\write16</literal> et <literal>\write17</literal> étaient parfois utilisés pour écrire dans le fichier journal et le terminal ; toutefois, dans &latex;, la façon naturelle de faire ceci est d’utiliser <literal>\typeout</literal> -(see <link linkend="_005ctypeout">\typeout</link>). La commande <literal>\write18</literal> est encore plus +(voir <link linkend="_005ctypeout">\typeout</link>). La commande <literal>\write18</literal> est encore plus spéciale ; les systèmes &tex; modernes l’utilisent pour passer des -commandes au système d’exploitation (see <link linkend="_005cwrite18">\write18</link>). +commandes au système d’exploitation (voir <link linkend="_005cwrite18">\write18</link>). </para> <indexterm role="cp"><primary>saut de ligne, dans <literal>\write</literal></primary></indexterm> <indexterm role="cp"><primary><literal>^^J</literal>, dans <literal>\write</literal></primary></indexterm> @@ -13968,8 +15091,8 @@ racine, ou dans des sous-répertoires. terminal. </para> <para>Typiquement, les auteurs &latex; utilisent <literal>\typeout</literal> -(see <link linkend="_005ctypeout">\typeout</link>) qui permet d’utiliser <literal>\protect</literal> sur toute -commande fragile au sein de <replaceable>chaîne</replaceable> (see <link linkend="_005cprotect">\protect</link>). Mais la +(voir <link linkend="_005ctypeout">\typeout</link>) qui permet d’utiliser <literal>\protect</literal> sur toute +commande fragile au sein de <replaceable>chaîne</replaceable> (voir <link linkend="_005cprotect">\protect</link>). Mais la commande <literal>\typeout</literal> insère un saut de ligne à la fin de <replaceable>chaîne</replaceable> contrairement à <literal>\message</literal>, aussi cette dernière peut être utile. @@ -14062,13 +15185,13 @@ est bloquée jusqu’à ce que cela soit fini. </screen> <para>exécute Asymptote (le programme <literal>asy</literal>) sur le fichier <filename>pix/figure1.asy</filename>, de sorte que le document peut par la suite lire -le graphique en résultant (see <link linkend="_005cincludegraphics">\includegraphics</link>). Comme pour tout +le graphique en résultant (voir <link linkend="_005cincludegraphics">\includegraphics</link>). Comme pour tout <literal>\write</literal>, ici &latex; développe les macros contenues dans <replaceable>commande_shell</replaceable> de sorte que <literal>\numerofig</literal> est remplacé par ‘<literal>1</literal>’. </para> <para>Un autre exemple est que vous pouvez exécuter automatiquement Bib&tex; -au début de chaque exécution de &latex; (see <link linkend="Using-BibTeX">Using BibTeX</link>) en +au début de chaque exécution de &latex; (voir <link linkend="Using-BibTeX">Using BibTeX</link>) en incluant <literal>\immediate\write18{bibtex8 \jobname}</literal> comme première ligne du fichier. Notez que <literal>\jobname</literal> se développe par défaut en le nom de base du fichier racine, ou bien l’argument de l’option @@ -14084,7 +15207,7 @@ tous les fichiers PDF du répertoire courant (voir aussi </screen> <para>Le comportement standard de tout <literal>\write</literal> est d’attendre jusqu’à la prochaine éjection de page avant de développer les macros ou d’écrire -dans le flux (see <link linkend="_005cwrite">\write</link>). Mais il se peut que vous désiriez que +dans le flux (voir <link linkend="_005cwrite">\write</link>). Mais il se peut que vous désiriez que cela soit immédiat. Pour cela, utilisez <literal>\immediate\write18{<replaceable>commande_shell</replaceable>}</literal>. </para> @@ -14095,7 +15218,7 @@ fichier, cela vous rendrait bien malheureux. Le réglage standard dans les distributions modernes est d’interdire l’accès complet à l’interpréteur de commande du système d’exploitation. Vous pouvez l’autoriser, si vous êtes sûr qu’il n’y a pas de danger, en compilant -avec <literal>latex --enable-write18 <replaceable>nomfichier</replaceable></literal> (see <link linkend="Command-line-options">Command line +avec <literal>latex --enable-write18 <replaceable>nomfichier</replaceable></literal> (voir <link linkend="Command-line-options">Command line options</link>). (L’option <literal>--shell-escape</literal> est un synonyme dans &tex; Live.) </para> @@ -14107,7 +15230,7 @@ fonctionner, telles que celles qui font tourner Metafont pour générer les polices manquantes, même si vous n’utilisez pas l’option <literal>enable-write18</literal>. Par défaut cette liste de commandes autorisées est courte et ne fait figurer que les commandes qui sont sous contrôle -des mainteneurs de la distribution (see <link linkend="Command-line-options">Command line options</link>). +des mainteneurs de la distribution (voir <link linkend="Command-line-options">Command line options</link>). </para> <para>Certains paquetage ont besoin d’exécuter des commandes système externes. Par exemple <filename>sagetex</filename> vous permet de faire faire des @@ -14143,9 +15266,11 @@ exemples donnés plus haut utilisant <literal>\write18</literal> à l’éta </sect2> </sect1> </chapter> -<chapter label="28" id="Command-line"> -<title>Ligne de commande</title> +<chapter label="28" id="Command-line-interface"> +<title>Interface ligne de commande</title> +<anchor id="Command-line"/><!-- ancien nom --> <indexterm role="cp"><primary>ligne de commande</primary></indexterm> +<indexterm role="cp"><primary>CLI</primary></indexterm> <para>Synopsis (depuis la ligne de commande d’un terminal) : </para> @@ -14164,7 +15289,7 @@ produisant en sortie <filename>these.pdf</filename>. Notez que <filename>.tex</filename> est l’extension par défault des noms de fichier. </para> <para>pdf&tex; est une évolution du programme original &tex;, comme le sont -Xe&tex; et Lua&tex; (see <link linkend="TeX-engines">&tex; engines</link>). Ils sont complètement +Xe&tex; et Lua&tex; (voir <link linkend="TeX-engines">&tex; engines</link>). Ils sont complètement rétrocompatibles. Mais le programme original avait son propre format de sortie, DVI, alors que les plus récents peuvent produire directement un PDF en sortie. Ceci leur permet de profiter des fonctions @@ -14177,20 +15302,20 @@ modernes. Si vous exécutez <command>latex</command>, ou <literal>dvilualatex</ alors vous obtenez un DVI. La description faite ici suppose pdf&latex;. </para> -<para>See <link linkend="Command-line-options">Command line options</link>, pour une sélection des options de ligne de +<para>Voir <link linkend="Command-line-options">Command line options</link>, pour une sélection des options de ligne de commande les plus utiles. Quant à <replaceable>argument</replaceable>, le cas habituel est qu’il ne commence pas par une contr’oblique, dans ce cas le système le prend pour un nom de fichier, et compile ce fichier. Si <replaceable>argument</replaceable> commence avec une contr’oblique, alors le système l’interprète comme une ligne d’entrée à &latex;, ce qui peut être utilisé pour obtenir -certains effets spéciaux (see <link linkend="Command-line-input">Command line input</link>). +certains effets spéciaux (voir <link linkend="Command-line-input">Command line input</link>). </para> <para>Si vous ne donnez aucun arguments ni options alors <command>pdflatex</command> invite à saisir à partir du terminal. Vous pouvez vous échapper de cela en entrant <userinput>CTRL-D</userinput>. </para> <para>Si &latex; trouve une erreur dans votre document alors par défaut il -s’arrête et vous interroge à ce propos. See <link linkend="Recovering-from-errors">Recovering from errors</link> +s’arrête et vous interroge à ce propos. Voir <link linkend="Recovering-from-errors">Recovering from errors</link> pour un aperçu de quoi faire. </para> @@ -14249,19 +15374,10 @@ d’entrée clavier, mais pour nulle autre raison. <indexterm role="cp"><primary>nom de fichier de la tâche courante</primary></indexterm> <indexterm role="fn"><primary>--jobname ligne de commande, option</primary></indexterm> </listitem></varlistentry><varlistentry><term><literal>-jobname=<replaceable>chaîne</replaceable></literal> -</term><listitem><para>Règle la valeur du <firstterm>nom de tâche</firstterm> de &tex; à la chaîne de +</term><listitem><para>Règle la valeur du <firstterm>nom d’ouvrage</firstterm> de &tex; à la chaîne de caractères <replaceable>chaîne</replaceable>. Le fichier journal et le fichier de sortie -s’appeleront <filename><replaceable>chaîne</replaceable>.log</filename> et <filename><replaceable>chaîne</replaceable>.pdf</filename>. -</para> -<para>Quand vous exécutez <literal><command>pdflatex</command> <replaceable>options</replaceable> -<replaceable>argument</replaceable></literal>, si <replaceable>argument</replaceable> ne commence pas par une contr’oblique -alors &tex; considère que c’est le nom d’un fichier à lire en -entrée. Autrement il attend la première instruction <literal>\input</literal> et le -nom du fichier en entrée devient le nom de tâche -(<literal>\jobname</literal>). Celui-ci est utilisé pour nommer le fichier journal -et le fichier de sortie. L’option <literal>jobname</literal> l’emporte et spécifie -directement le nom. See <link linkend="Command-line-input">Command line input</link>, pour un examples -d’usage. +s’appeleront <filename><replaceable>chaîne</replaceable>.log</filename> et +<filename><replaceable>chaîne</replaceable>.pdf</filename>. voir <link linkend="Jobname">Jobname</link>. </para> <anchor id="output-directory"/><indexterm role="cp"><primary>répertoire de sortie pour tous les fichiers externes</primary></indexterm> <indexterm role="cp"><primary>sortie, pour tous les fichiers externes, répertoire de</primary></indexterm> @@ -14291,7 +15407,7 @@ entrée. </term><term><literal>--shell-escape</literal> </term><term><literal>--no-shell-escape</literal> </term><listitem><para>Activation et desactivation <literal>\write18{<replaceable>commande_shell</replaceable>}</literal> -(see <link linkend="_005cwrite18">\write18</link>). Les deux premières options sont prises en charge à +(voir <link linkend="_005cwrite18">\write18</link>). Les deux premières options sont prises en charge à la fois par &tex; Live et MiK&tex;, alors que les deux suivantes sont des synonymes pris en charge par &tex; Live. </para> @@ -14331,7 +15447,7 @@ Mac&tex;. <para>Au sein de l’invocation de ligne de commande <literal>pdflatex <replaceable>options</replaceable> <replaceable>argument</replaceable></literal> vous pouvez spécifier du code &latex; arbitraire en entrée en commençant <replaceable>argument</replaceable> par une -contr’oblique. Ceci permet de faire certains effet spéciaux. +contr’oblique. Ceci permet de faire certains effets spéciaux. </para> <indexterm role="fn"><primary>paquetage <literal>hyperref</literal></primary></indexterm> <indexterm role="fn"><primary><literal>hyperref</literal>, paquetage</primary></indexterm> @@ -14369,21 +15485,138 @@ pdflatex -jobname=professeurs "\def\profs{}\input{principal}" sortie s’appeleraient <filename>principal.pdf</filename> et le second écraseraient le premier. </para> -<para>Dans ce dernier exemple on charge le paquetage <filename>graphicx</filename> avec l’option -<literal>draft</literal> +<para>Dans cet exemple on passe l’option <literal>draft</literal> au paquetage +<filename>graphicx</filename> : </para> -<!-- credit Herbert Voss: https://tex.stackexchange.com/a/17236/121234 --> -<screen>pdflatex -jobname=aa "\RequirePackage[draft]{graphicx}\input{aa.tex}" +<screen>pdflatex "\PassOptionsToPackage{draft}{graphicx}\input{aa.tex}" </screen> <para>de sorte que les fichiers graphiques ne sont lus que pour l’information -de dimension de boîte englobante, mais non incorporés dans le PDF. -(L’option <literal>jobname</literal> est la parce que sinon autrement le fichier de -sortie s’appelerait <filename>graphicx.pdf</filename>, comme <literal>\RequirePackage</literal> -fait lui-même un <literal>\input</literal>). +de dimension de boîte englobante, mais remplacés dans le PDF par une +boîte de même taille ne contenant que le nom de fichier, ce qui accélère +le temps de compilation, et économise l’encre d’imprimante. +</para> +<para>Un autre exemple classique est de cribler certains chapitres à la +compilation en les passant à <literal>\includeonly</literal> dans la ligne de +commande. Ainsi, supposons qu’on a un fichier racine <filename>livre.tex</filename> +ainsi formé : </para> +<screen>\documentclass{book} +\begin{document} +\frontmatter +\include{pref} +\mainmatter +\include{chap1} +\include{chap2} +\appendix +\include{append} +\backmatter +\include{bib} +\end{document} +</screen> +<para>En compilant <filename>livre.tex</filename> avec la ligne de commande suivante : +</para> +<screen>pdflatex '\includeonly{chap1}\input{livre} +</screen> +<para>seul le chapitre contenu dans <filename>chap1.tex</filename> sera produit en +sortie. Voir <link linkend="Splitting-the-input">Splitting the input</link>. +</para> +<para>Dans ce dernier exemple, on force la date au 14 juillet 1789 : +</para> +<screen>pdflatex '\day=14 \month=7 \year=1789 \input revolution' +</screen> +<para>Ainsi, si le fichier <filename>revolution.tex</filename> contient ceci : +</para> +<screen>\documentclass[french]{minimal} +\usepackage{babel} +\begin{document} +\today\ c'est la révolution ! +\end{document} +</screen> +<para>alors vous aurez en sortie un truc du genre : +</para> +<screen>14 juillet 1789 c’est la révolution ! +</screen> +</sect1> +<sect1 label="28.3" id="Jobname"> +<title>Nom d’ouvrage de &tex;</title> +<para>Quand vous exécutez <literal><command>pdflatex</command> <replaceable>options</replaceable> +<replaceable>argument</replaceable></literal>, si <replaceable>argument</replaceable> ne commence pas par une contr’oblique +alors &tex; considère que c’est le nom du fichier racine à lire en +entrée. Le nom du fichier racine, sans l’extension <filename>.tex</filename> si elle +est donnée, définit alors le <firstterm>nom d’ouvrage</firstterm>, celui-ci est utilisé pour +nommer le fichier journal et le fichier de sortie. +</para> +<para>Autrement, si <replaceable>argument</replaceable> commence par une contr’oblique, il attend +la première instruction <literal>\input</literal> et le nom du fichier en entrée +devient le nom d’ouvrage. +</para> +<para>Au sein du document, la variable <literal>\jobname</literal> se développe dans le +nom d’ouvrage, avec la particularité que tous les caractères sont de +catcode 11 (lettre). Ainsi, si vous voulez utilisez le nom d’ouvrage +comme une condition, la solution la plus simple est d’utiliser une macro +de text du paquetage <filename>xtring</filename> dans sa variante étoilée pour être +insensible au catcode. Dans le texte suivant par exemple, la note en bas +de page « dont la Respublica Bananensis Francorum. » n’est présente que +si le nom de tâche commence par <filename>moi-meme</filename>. +</para> +<screen>Si une démocratie est juste un régime où les citoyens votent alors +toutes les républiques bananières\IfBeginWith*{\jobname}{moi-meme}% +{\footnote{dont la Respublica Bananensis Francorum.}}{} sont des +démocraties. +</screen> +<para>Cela ne fonctionnerait pas si la version non étoilée de +<literal>\IfBeginWith</literal> était utilisée, parce que le <literal>-</literal> dans +‘<literal>moi-meme</literal>’ a un catcode 12, alors que dans <literal>\jobname</literal>, s’il +s’y trouve, il a nécessairement un catcode 11. +</para> +<para>Dans certains cas il peut être utile de fixer le nom de tâche à une +autre valeur que celle par défaut, l’option <literal>--jobname</literal> permet de +faire cela, elle l’emporte sur le premier <literal>\input</literal> et spécifie +directement le nom. Voir <link linkend="Command-line-input">Command line input</link>, pour un exemple d’usage, +où l’on génère deux fichiers <filename>etudiants.pdf</filename> et +<filename>professeurs.pdf</filename> à partir d’un même code source <filename>principal.tex</filename>. +</para> +<para>En l’absence d’option <literal>--jobname</literal>, la valeur initiale de +<literal>\jobname</literal> est <literal>texput</literal>, de sorte que si la compilation +s’arrête avant le premier <literal>\input</literal>, le journal produit sera nommé +<filename>texput.log</filename>. Par exemple la commande suivante : +</para> +<screen>pdflatex "\nonstopmode\errmessage{\string\jobname\space vaut \jobname}" +</screen> +<para>produira un journal <filename>textput.log</filename> contenant le message d’erreur +‘<literal>! \jobname vaut texput.</literal>’. +</para> +<para>Attention, le nom de tâche est également forcé à <filename>texput</filename> si le +premier <literal>\input</literal> est indirectement appelé par <literal>\documentclass</literal> +ou <literal>\RequirePackage</literal>. Ainsi l’exemple suivant produira un fichier +nommé <filename>texput.pdf</filename> avec une version raisonnablement récente de +&latex; : +</para> +<screen>pdflatex "\documentclass{minimal}\begin{document}Bonjour !\end{document}" +</screen> +<para>mais avec une version plus ancienne le fichier de sortie se serait nommé +<filename>minimal.pdf</filename>, parce que le premier <literal>\input</literal> appelé +indirectement par <literal>\documentclass</literal> aurait été traité de la même +façon que s’il chargeait le fichier source racine. +</para> +<para>Voici un autre exemple de cela, ici on reprend l’exemple donné dans +<link linkend="Command-line-input">Command line input</link> où l’on passe sur la ligne de commande l’option +<literal>draft</literal> au paquetage <filename>graphicx</filename>. Mais au lieu de le faire avec +<literal>\PassOptionToPackage</literal>, on le fait avec <literal>\RequirePackage</literal>, ce +qui a également pour effet que le paquetage <filename>graphicx</filename> sera chargé +en premier, si ce n’était pas déjà le cas. +</para> +<!-- credit Herbert Voss: https://tex.stackexchange.com/a/17236/121234 --> +<screen>pdflatex --jobname=aa "\RequirePackage[draft]{graphicx}\input{aa.tex}" +</screen> +<para>L’option <literal>--jobname=aa</literal> est nécessaire, car elle garantit que le +fichier de sortie se nommera bien <filename>aa.pdf</filename>, et non +<filename>texput.pdf</filename> avec une version récente de &latex;, ni +<filename>graphicx.pdf</filename> avec une version plus ancienne. +</para> </sect1> -<sect1 label="28.3" id="Recovering-from-errors"> +<sect1 label="28.4" id="Recovering-from-errors"> <title>Quand quelque chose se passe mal</title> <para>Si &latex; trouve une erreur dans votre document alors il vous produit @@ -14510,7 +15743,7 @@ Et du texte. <indexterm role="cp"><primary>patron, <literal>book</literal></primary></indexterm> -<para>Voici un patron simple pour un livre. See <link linkend="Larger-book-template">Larger book template</link> pour +<para>Voici un patron simple pour un livre. Voir <link linkend="Larger-book-template">Larger book template</link> pour un patron plus élaboré. </para> <screen>\documentclass{book} @@ -14538,16 +15771,16 @@ La fin. <indexterm role="cp"><primary>patron <literal>book</literal></primary></indexterm> -<para>Voici un patron quelque peu élaboré pour un livre. See <link linkend="book-template">book template</link> +<para>Voici un patron quelque peu élaboré pour un livre. Voir <link linkend="book-template">book template</link> pour un patron plus simple. </para> <para>Ce patron utilise un <literal>\frontmatter</literal>, <literal>\mainmatter</literal>, et <literal>\backmatter</literal> pour contrôler la typographie des trois zones -principales d’un livre (see <link linkend="_005cfrontmatter-_0026-_005cmainmatter-_0026-_005cbackmatter">\frontmatter & \mainmatter & +principales d’un livre (voir <link linkend="_005cfrontmatter-_0026-_005cmainmatter-_0026-_005cbackmatter">\frontmatter & \mainmatter & \backmatter</link>). Le livre a une bibliographie et un index. </para> <para>Il est également à noter qu’il utilise <literal>\include</literal> et -<literal>\includeonly</literal> (see <link linkend="Splitting-the-input">Splitting the input</link>). Lorsque vous +<literal>\includeonly</literal> (voir <link linkend="Splitting-the-input">Splitting the input</link>). Lorsque vous travaillez sur un chapitre vous pouvez ne pas compiler tous les autres chapitres en mettant en commentaire les entrées correspondantes dans les arguments de <literal>\includeonly</literal>. Ceci accélère la compilation sans @@ -14563,10 +15796,10 @@ bénéfice de maintenir les valeurs de renvois). \author{Alex Author} \includeonly{% - frontcover, +% frontcover, preface, chap1, - ... +% appenA, } \begin{document} @@ -14581,7 +15814,7 @@ bénéfice de maintenir les valeurs de renvois). \include{chap1} ... \appendix -\include{appena} +\include{appenA} ... \backmatter |