[latexrefman-commits] [SCM] latexrefman updated: r625 - trunk
pathe at gnu.org.ua
pathe at gnu.org.ua
Mon May 21 17:59:01 CEST 2018
Author: pathe
Date: 2018-05-21 18:59:01 +0300 (Mon, 21 May 2018)
New Revision: 625
Modified:
trunk/latex2e-fr.pdf
trunk/latex2e-fr.texi
Log:
update fr - sections 1 and 2
Modified: trunk/latex2e-fr.pdf
===================================================================
(Binary files differ)
Modified: trunk/latex2e-fr.texi
===================================================================
--- trunk/latex2e-fr.texi 2018-05-19 19:34:10 UTC (rev 624)
+++ trunk/latex2e-fr.texi 2018-05-21 15:59:01 UTC (rev 625)
@@ -24,6 +24,21 @@
@c xx fusionner style mathématique hors texte
@c xx mode veritical, mode horizontal
@c
+ at c
+ at c
+ at c xx Notes de P. Bideault
+ at c
+ at c xx Il est écrit ‹ dans sa version « @value{UPDATED} » › ;
+ at c xx il serait plus élégant d'écrire dans sa version de tel mois.
+ at c xx Le problème est que la chaîne @value{UPDATED} renvoie un nom de mois
+ at c xx commençant par une capitale. Ne pourrait-on écrire celui-ci sans capitale ?
+ at c
+ at c xx Le sommaire précède immédiatement la table des matières. C'est curieux,
+ at c xx C'est curieux, et perturbant.
+ at c xx Cette table des matières ne serait-elle mieux située en fin de document ?
+ at c
+ at c
+ at c
@c xx Le source2e typographie a un index avec tous noyau
@c commandes xx, même si certains sont internes et ne devraient pas être inclus.
@c xx classes.dtx et al. définir des commandes supplémentaires.
@@ -45,23 +60,23 @@
système de préparation de documents, version « @value{UPDATED} ».
Ce manuel a été traduit du fichier @file{LATEX.HLP} v1.0a de la
-bibliothèque d'aide VMS. La version pré-traduction a été rédigé par
-George D. Greenwade de Sam Houston State University. La version
+bibliothèque d'aide VMS. La version pré-traduction a été rédigée par
+George D. Greenwade de l'université d'État Sam Houston, au Texas (USA). La version
@LaTeX{} 2.09 a été rédigée par Stephen Gilmore. La version @LaTeX{}2e a
-été adapté à partir de cellce-ci par Torsten Martinsen. Karl Berry a
+été adaptée à partir de celle-ci par Torsten Martinsen. Karl Berry a
fait d'autres mises à jour et ajouts, et reconnaît avec gratitude avoir
utilisé @cite{Hypertext Help with @LaTeX{}}, de Sheldon Green, et
@cite{@LaTeX{} Command Summary} (pour @LaTeX{}2.09) de L. Botway et
C. Biemesderfer (publié par le @TeX{} Users Group en tant que
- at cite{@TeX{}niques} numéro 10), il l'a utilisé en tant que matériel de
-référence (aucun texte n'était directement copié).
+ at cite{@TeX{}niques} numéro 10)i ; il a utilisé ces documents en tant que matériel de
+référence et n'en a copié aucun texte directement.
Tous droits réservés @copyright{} 2015-2018 Vincent Belaïche --- traduction.@*
Tous droits réservés @copyright{} 2007-2018 Karl Berry. @*
Tous droits réservés @copyright{} 1988, 1994, 2007 Stephen Gilmore. @*
Tous droits réservés @copyright{} 1994, 1995, 1996 Torsten Martinsen.
-Ci-après se trouve la licence sous laquelle est distribuée ce manuel,
+Ci-après se trouve la licence sous laquelle est distribuée ce manuel ;
une traduction en est donnée en annexe, voir @ref{License translation}.
@comment start of License
@@ -186,12 +201,12 @@
@findex @url{@value{LTXREFMAN_HOME_PAGE}} @r{page d'accueil}
Ceci est un manuel de référence officieux pour le système @LaTeX{}2e de
-préparation de document, ce système est mis en oeuvre sous forme d'un
+préparation de document. Ce système est mis en oeuvre sous forme d'un
paquet de macros pour le programme de composition @TeX{}
(@pxref{Overview}). La page d'accueil de ce document est
@url{@value{LTXREFMAN_HOME_PAGE}}. Cette page contient des liens vers
-les produits courants de fabrication du document dans différents
-formats, les sources, les listes de diffusion, et d'autres
+différentes versions de ce document, dans différents
+formats et langues, mais aussi vers ses sources, vers les archives des listes de diffusion qui lui sont consacrées ainsi que vers d'autres
infrastructures.
@cindex @LaTeX{} ou @LaTeX{}2e, que choisir ?
@@ -212,11 +227,14 @@
@cindex bogues, rapports
@cindex anomalies, rapports
Ne leur envoyez donc pas de rapports d'anomalie ou quoi que ce soit
-d'autre. Au lieu de cela, s'il vous plaît envoyez tous commentaires à
+d'autre.
+
+En revanche, n'hésitez pas à adresser vos commentaires à
@email{@value{LTXREFMAN_BUGS}}.
-Ce document est un manuel de référence. Il y a une vaste gamme d'autres sources d'information sur
- at LaTeX{}, de tous niveaux. Voici quelques introductions :
+Ce document est un manuel de référence. Il y a d'autres sources d'information sur
+ at LaTeX{} : elles sont très nombreuses, et s'adressent à des utilisateurs de tous niveaux.
+Voici quelques introductions :
@c voir http://mirror.ctan.org/help/ctan/CTAN-upload-addendum.html#urls
@table @url
@@ -256,28 +274,34 @@
@cindex Knuth, Donald E.
@cindex Lamport, Leslie
@cindex @LaTeX{} aperçu
- at LaTeX{} est un système de composition de document. Il fut à l'origine
-créé par Leslie Lamport et est desormais maintenu par un groupe de
+ at LaTeX{} est un système de composition de documents. Il fut à l'origine
+créé par Leslie Lamport ; il est désormais maintenu par un groupe de
volontaires (@url{http://latex-project.org}). Il est largement utilisé,
en particulier pour les documents complexes et techniques, tels que ceux
impliquant des mathématiques.
+ at c - Au début, ajout de « à l'aide d'un simple éditeur de texte ».
+ at c - Emploi d'italiques pour les notions principales.
+ at c - À la fin, ajout de « qui contient son texte mis en page ».
@cindex paquet de macro, @LaTeX{} en tant que
-Un utilisateur @LaTeX{} écrit un fichier d'entrée contenant le texte
-d'un document avec des commandes qui y sont intercalées pour décrire
-comment le texte doit être formaté. @LaTeX{} est mis en œuvre comme un
+À l'aide d'un simple éditeur de texte,
+un utilisateur @LaTeX{} écrit un fichier, dit @emph{fichier d'entrée},
+qui contient son texte ; des @emph{commandes} y sont intercalées :
+ce sont des instructions servant à décrire la manière dont le texte
+doit être formaté. En effet, @LaTeX{} est mis en œuvre comme un
ensemble de commandes liées s'interfaçant avec le programme de
composition @TeX{} de Donald E. Knuth (le terme technique est que
@LaTeX{} est un @dfn{paquet de macros} pour le moteur @TeX{}).
-L'utilisateur produit le document de sortie en donnant ce fichier
-d'entrée au moteur @TeX{}.
+En donnant le fichier d'entrée au moteur @TeX{},
+l'utilisateur produit le @emph{document de sortie}
+qui contient son texte mis en page.
@c - Les fichiers @LaTeX{} sont des fichiers texte ordinaires qui
@c - peuvent être écrits avec n'importe quel éditeur de texte aux
@c - performances raisonnables.
Le terme @LaTeX{} est aussi parfois utilisé pour signifier le langage à
-balises dans lequel le code source du document est écrit, c.-à-d.@: pour
+balises dans lequel le code source du document est écrit, c'est-à-dire pour
signifier l'ensemble des commandes à la disposition d'un utilisateur de
@LaTeX{}.
@@ -286,7 +310,7 @@
Le nom @LaTeX{} est l'abréviation de ``Lamport @TeX{}''. On le prononce
LA-TÈQUE. Au sein du document, on produit le logo avec @code{\LaTeX}.
Là où l'utilisation du logo n'est pas raisonnable, comme dans du texte
-brut, écrivez le @samp{LaTeX}.
+brut, écrivez-le @samp{LaTeX}.
@menu
@@ -305,7 +329,8 @@
@cindex Bonjour le monde
Les fichiers @LaTeX{} ont une structure globale simple, avec un début et
-une fin standards. Voici un exemple « Bonjour le monde » :
+une fin standards. Voici un exemple : il s'agit d'obtenir un document
+contenant la phrase « Bonjour le monde ».
@example
\documentclass@{article@}
@@ -316,8 +341,8 @@
@cindex classe de document, définition
@noindent
-Ici @samp{article} et ce qu'on appelle la @dfn{classe de document},
-implémentée dans une fichier @file{article.cls}. N'importe quelle classe
+Ici @samp{article} eist ce que l'on appelle la @dfn{classe de document} ;
+elle est implémentée dans une fichier @file{article.cls}. N'importe quelle classe
de document peut être utilisée. Quelques classes de document sont
définies par @LaTeX{} lui-même, et un grand nombre d'autres sont
largement disponibles. @xref{Document classes}.
@@ -335,8 +360,9 @@
d'environnements, et bien plus encore sont définis séparément.
@xref{Environments}.
-Les rubriques suivantes discutent de la façon de produire des PDF et
-d'autres format de sortie à partir d'un fichier d'entrée @LaTeX{}.
+Les rubriques suivantes sont consacrées aux façons de produire,
+à partir d'un fichier d'entrée @LaTeX{}, des documents PDF ou
+d'autres formats.
@node Output files
@@ -354,25 +380,25 @@
@findex @r{commande} dvips
@findex @r{commande} dvipdfmx
@findex @r{commande} dvitype
-Si il est invoqué avec la commande système @command{latex}, alors il
+S'il est invoqué avec la commande système @command{latex}, alors il
produit un fichier « DeVice Independent at footnote{Indépendant du
périphérique de sortie, ce n'est toutefois pas un format portable de
document} » (@file{.dvi}). Vous pouvez visualiser ce fichier avec une
commande comme @command{xdvi}, ou le convertir en fichier PostScript
@code{.ps} avec @command{dvips} ou en fichier « Portable Document
Format at footnote{Format portable de document} » @code{.pdf} avec
- at command{dvipdfmx}. Un grand nombre d'autres progammes utilitaires DVI
-sont disponibles (@url{http://mirror.ctan.org/dviware}).
+ at command{dvipdfmx}. Un grand nombre d'autres progammes utilitaires
+pour fichiers DVI sont disponibles (@url{http://mirror.ctan.org/dviware}).
@item .pdf
@findex .pdf @r{fichier}
@cindex pdf at TeX{}
@findex @r{commande} pdflatex
Si @LaTeX{} est invoqué avec la commande système @command{pdflatex},
-parmi d'autres commandes (@pxref{@TeX{} engines}), alors la sortie
-principale est un fichier ``Portable Document Format''
+alors la sortie principale est un fichier ``Portable Document Format''
(@file{.pdf}). Typiquement, il s'agit d'un fichier autonome, avec toutes
les polices et images incorporées.
+D'autres commandes (@pxref{@TeX{} engines}) produisent des fichiers PDF.
@c - Cela peut être très utile, mais cela rend le fichier de sortie beaucoup
@c - plus grand que le fichier @file{.dvi} produit à partir du même document.
@@ -403,7 +429,7 @@
informations sommaires telles que la liste des paquetages chargés. Il
contient aussi des messages de diagnostic
@c - pour toutes les erreurs découvertes dans le fichier d'entrée.
-et possiblement des informations supplémentaires concernant toutes
+et, possiblement, des informations supplémentaires concernant toutes
erreurs.
@item .aux
@@ -415,12 +441,12 @@
De l'information auxiliaire est utilisée par @LaTeX{} pour des choses
telles que les doubles renvois. Par exemple, la première fois que
@LaTeX{} trouve un renvoi en aval --- une double référence à
-quelque-chose qui n'est pas encore apparu dans le code source --- il
+quelque chose qui n'est pas encore apparu dans le code source --- il
apparaîtra dans la sortie comme un double point d'interrogation
@code{??}. Quand l'endroit auquel le renvoi fait référence finit par
-appraître dans le code source, alors @LaTeX{} écrit son information de
+apparaître dans le code source, alors @LaTeX{} écrit son information de
localisation dans ce fichier @code{.aux}. À l'invocation suivante,
- at LaTeX{} lit l'inforlation de localisation à partir de ce fichier et
+ at LaTeX{} lit l'information de localisation à partir de ce fichier et
l'utilise pour résoudre le renvoi, en remplaçant le double point
d'interrogation avec la localisation mémorisée.
@@ -454,9 +480,9 @@
@cindex entrée Unicode, native
@cindex polices TrueType
@cindex polices OpenType
- at LaTeX{} est défini comme un ensemble de commande qui sont exécutées par
+ at LaTeX{} est défini comme un ensemble de commandes qui sont exécutées par
une implémentation @TeX{} (@pxref{Overview}). Cette section donne une
-vue d'ensemble laconique des principaux programmes.
+brève vue d'ensemble des principaux programmes.
@table @code
@item latex
@@ -490,9 +516,9 @@
Si @LaTeX{} est invoqué avec la commandes systèmes @command{lualatex},
alors le moteur Lua at TeX{} est exécuté
(@url{http://ctan.org/pkg/luatex}). Ce programme permet que du code
-écrit dans le langage script Lua (@url{http://luatex.org}) intéragisse
+écrit dans le langage script Lua (@url{http://luatex.org}) interagisse
avec la compostion faite par @TeX{}. Lua at TeX{} traite nativement
-l'entrée en Unicode UTF-8, peut traiter les polices OpenType et
+l'entrée en codage Unicode UTF-8, peut traiter les polices OpenType et
TrueType, et produit un fichier @file{.pdf} par défaut. Il y a aussi
@command{dvilualatex} pour produire un fichier @file{.dvi}, mais cela
est rarement utilisé.
@@ -504,10 +530,10 @@
@findex xdvipdfmx
Si @LaTeX{} est invoqué avec la commandes système @command{xelatex}, le
moteur Xe at TeX{} est exécuté (@url{http://tug.org/xetex}). Comme
-Lua at TeX{}, Xe at TeX{} prend en charge nativement UTF-8 Unicode et les
-polices TrueType et OpenType, bien que l'implementation soit
-complètement différente, utilisant principalement des bibliothèque
-externe plutôt que du code interne. Xe at TeX{} produit un fichier @file{.pdf}
+Lua at TeX{}, Xe at TeX{} prend en charge nativement le codage Unicode UTF-8 et les
+polices TrueType et OpenType, bien que leur implémentation soit
+complètement différente, en utilisant principalement des bibliothèques
+externes plutôt que du code interne. Xe at TeX{} produit un fichier @file{.pdf}
en sortie ; il ne prend pas en charge la sortie DVI.
En interne, Xe at TeX{} crée un fichier @code{.xdv} file, une variante de
@@ -517,8 +543,8 @@
@end table
-D'autres vairantes de @LaTeX{} et @TeX{} existent, par ex. pour fournir
-une prise en charge supplémentaires du japonais des d'autres langages
+D'autres variantes de @LaTeX{} et @TeX{} existent, par exemple pour fournir
+une prise en charge supplémentaire du japonais et d'autres langages
([u]p at TeX{}, @url{http://ctan.org/pkg/ptex},
@url{http://ctan.org/pkg/uptex}).
@@ -531,37 +557,37 @@
@findex [...] @r{pour les arguments optionnels}
@findex @{...@} @r{pour les arguments obligatoires}
Dans le fichier d'entrée @LaTeX{}, un nom de commande commence avec une
-contr'oblique, @code{\}. Le nom lui-même consiste soit en (a) une
-chaîne de lettres ou (b) une unique non-lettre.
+contre-oblique, @code{\}. Le nom lui-même consiste soit en (a) une
+chaîne de lettres ou (b) un unique caractère, qui dans ce cas n'est pas une lettre.
Les noms de commandes @LaTeX{} sont sensibles à la casse de sorte que
@code{\pagebreak} diffère de @code{\Pagebreak} (ce dernier n'est pas une
-commande standarde). La plupart des noms de commandes sont en bas de
-casse, mais en tout cas vous devez saisir toutes les commandes dans la
-même casse où elles sont définies.
+commande standard). La plupart des noms de commandes sont en bas de
+casse, mais elles sont sensibles à la casse : vous devez toujours saisir
+les commandes en respectant la casse où elles ont été définies.
Une commande peut être suivie de zéro, un ou plus d'arguments. Ces
arguments peuvent être soit obligatoires, soit optionnels. Les
arguments obligatoires sont entre accolades, @code{@{...@}}. Les
-arguments optionnels sont entre crochets, @code{[...]}. En général,
-mais ce n'est pas universel, si la commande prend un argument optionnel,
+arguments optionnels sont entre crochets, @code{[...]}. En général
+(mais ce n'est pas universel), si la commande prend un argument optionnel,
il vient en premier, avant tout argument obligatoire.
Au sein d'un argument optionnel, pour utiliser le crochet
-fermant (@code{]}) cachez le au sein d'accolades, comme
+fermant (@code{]}) cachez-le au sein d'accolades, comme
dans @code{\item[crochet fermant @{]@}]}. De même, si un argument
optionnel vient en dernier, sans argument obligatoire à sa suite, alors
-pour qie le premier caractère dans le texte suivant soit un crochet
-ouvrant, cachez le entre accolades.
+pour que le premier caractère dans le texte suivant soit un crochet
+ouvrant, cachez-le entre accolades.
- at LaTeX{} a la convetion que certaines commandes ont une forme en a
- at code{*} qui est en relation avec la forme sans le @code{*}, telles que
+ at LaTeX{} obéit à la convention selon laquelle certaines commandes ont une forme étoilée
+(@code{*}) qui est en relation avec la forme sans le @code{*}, telles que
@code{\chapter} et @code{\chapter*}. La différence exacte de
comportement dépend de la commande.
-Ce manuel décrit toutes les options accepté et les formes en @code{*}
-pour les commandes dont il traite (à l'exeption des omissions
-involontaires, ou bogues de ce manuel).
+Ce manuel décrit toutes les options acceptées et les formes en @code{*}
+pour les commandes dont il traite (à l'exception des omissions
+involontaires ou bogues de ce manuel).
@menu
* Environnement: Environment. Zone du code source avec un comportement distinct.
@@ -587,23 +613,23 @@
@example
\begin@{verse@}
- There once was a man from Nantucket \\
+ Plus ne suis ce que j'ai été \\
...
\end@{verse@}
@end example
Voir @ref{Environments} pour une liste des environnements.
-Le @var{nom environnement} au début doit s'accorder exactement avec
-celui à la fin. Ceci comprend le cas où @var{nom environnement} se
-termine par une étoile(@code{*}) ; l'argument à la fois de
+Le @var{nom environnement} du début doit s'accorder exactement avec
+celui de la fin. Cela vaut aussi dans le cas où @var{nom environnement} se
+termine par une étoile (@code{*}) ; l'argument à la fois de
@code{\begin} et @code{\end} doit comprendre l'étoile.
Les environnements peuvent avoir des arguments, y compris des arguments
optionnels. L'exemple ci-dessous produit un tableau. Le premier
-argument est optionnel (et implique de la table est alignée
-verticalement sur sa première ligne) alors que le second argument et
-obligatoire (il spécifie le format des colonnes).
+argument est optionnel (il aligne verticalement le tableau
+sur sa première ligne) alors que le second argument est
+obligatoire (il spécifie le format des colonnes du tableau).
@example
\begin@{tabular@}[t]@{r|l@}
@@ -615,10 +641,10 @@
@node Declaration
@subsection Les déclarations de commandes
-Une commande qui change la valeur, ou change la signification, d'une
-autre commande ou paramètre. Par exemple, la commande @code{\mainmatter}
-change le réglage de la numérotation des pages en passant de numéros
-romains à des numéros arabes.
+Certaines commandes changent la valeur ou la signification d'une
+autre commande ou d'un paramètre. Par exemple, la commande @code{\mainmatter}
+change le réglage de la numérotation des pages en passant de chiffres
+romains à des chiffres arabes.
@node \makeatletter and \makeatother
@subsection @code{\makeatletter} et @code{\makeatother}
@@ -632,7 +658,7 @@
@end example
Utilisé pour redéfinir des commandes internes de @LaTeX{}.
- at code{\makeatletter} a pour effet que le caractère arobe @code{@@} ait
+ at code{\makeatletter} a pour effet que le caractère arobase @code{@@} ait
le code de catégorie des lettres, c.-à-d.@: 11. @code{\makeatother}
règle de code de catégorie de @code{@@} à 12, sa valeur d'origine.
@@ -641,31 +667,31 @@
@cindex catcode
@cindex code de catégorie de caractère
@cindex catégorie, code de @dots{} de caractère
- at dfn{catcode} pour faire court. Par exemple, la contr'oblique @code{\}
-reçoit le catcode 0, qui correspond aux catactères qui commencent une
+ at dfn{catcode} pour faire court. Par exemple, la contre-oblique @code{\}
+reçoit le catcode 0i : celui-ci correspond aux caractères qui commencent une
commande. Ces deux commandes altèrent le catcode assigné à @code{@@}.
Cette altération est nécessaire parce que beaucoup des commandes de
- at LaTeX{} utilisent @code{@@} dans leur nom, de sorte à empécher les
+ at LaTeX{} utilisent @code{@@} dans leur nom, de manière à empêcher les
utilisateurs de définir accidentellement une commande qui remplacerait
l'une des commandes privées de @LaTeX{}. Les noms de commandes
consistent en un caractère de catégorie 0, d'ordinaire une
-contr'oblique, suivi de lettres, c.-à-d.@: des caractères de
-catégorie 11 (à ceci près q'un nom de commande peut aussi consister d'un
-catactère de catégorie 0 suivi d'un seul symbole non-lettre). Ainsi sous
+contre-oblique, suivi de lettres, c'est-à-dire des caractères de
+catégorie 11 (à ceci près qu'un nom de commande peut aussi consister en un
+catactère de catégorie 0 suivi d'un seul symbole non-lettre). Ainsi, sous
le régime par défaut de codes de catégorie, les commandes définies par
l'utilisateur ne peuvent pas contenir de @code{@@}. Mais
@code{\makeatletter} et @code{\makeatother} permettent aux utilisateurs
de définir et re-définir des commandes dont le nom comprend un
@code{@@}.
-À utiliser dans un fichier @file{.tex}, dans le préambule. Ne pas
-utiliser dans des fichiers @file{.sty} ou @file{.cls} puisque les
-commandes @code{\usepackage} et @code{\documentclass} règlent le code de
-catégorie de l'arobe à celui d'une lettre.
+Ces commandes sont à utiliser dans le préambule d'un fichier @file{.tex}.
+Il ne faut pas les utiliser dans des fichiers @file{.sty} ou @file{.cls}
+puisque les commandes @code{\usepackage} et @code{\documentclass} règlent
+le code de catégorie de l'arobase à celui d'une lettre.
@PkgIndex{macros2e}
-Pour une liste complète des macros contenant un arobe dans leur nom,
+Pour une liste complète des macros contenant une arobase dans leur nom,
voir le document @url{http://ctan.org/pkg/macros2e}. Ces macros sont
surtout à l'intention des auteurs de classes et de paquetages.
@@ -703,14 +729,14 @@
Notez que le paquetage @file{titlesec} rend la manipulation du rubricage
plus facile. De plus, bien que la plupart des exigences concernant les
commandes de rubricage peuvent être remplies avec
- at code{\@@startsection}, ce n'est pas le cas de toutes. Par exemple,
-dans les classes @LaTeX{} standardes @code{book} et @code{report} les
-commandes @code{\chapter} et @code{\report} ne sont pas construite de
-cette manière. Pour fabriquer une telle commande il est possible
+ at code{\@@startsection}, ce n'est pas le cas de chacune d'entre elles. Par exemple,
+dans les classes @LaTeX{} standards @code{book} et @code{report}, les
+commandes @code{\chapter} et @code{\report} ne sont pas construites de
+cette manière. Pour fabriquer une telle commande, il est possible
d'utiliser la commande @code{\secdef}.
@c xx define, and make a cross reference to, secdef.
-Techniquement, cette commande a la forme :
+Techniquement, cette commande a la forme suivante :
@example
\@@startsection@{@var{nom}@}@{@var{niveau}@}@{@var{retrait}@}@{@var{avant}@}@{@var{après}@}@{@var{style}@}
*[@var{titretdm}]@{@var{titre}@}
@@ -720,53 +746,53 @@
\renewcommand@{\section@}@{\@@startsection@{@var{nom}@}@{@var{niveau}@}@{@var{retrait}@}%
@{@var{avant}@}@{@var{après}@}@{@var{style}@}@}
@end example
- at noindent redéfinit @code{\section} en gardant sa forme standarde d'appel
+ at noindent redéfinit @code{\section} en gardant sa forme standard d'appel
@code{\section*[@var{titretdm}]@{@var{titre}@}}. @xref{Sectioning} et
les exemples plus bas.
+Expliquons le rôle des différents paramètres de cette commande :
@table @var
@item nom
@anchor{\@@startsection/name} Nom du compteur (qui doit être défini
-séparément) utilisé pour numéroter le titre de rubrique. Ceux le plus
-communément utilisés sont @code{section}, @code{subsection}, ou
- at code{paragraph}. Bien que dans ces trois cas le nom du compteur soit le
-même que celui de la commande elle-même, utiliser le même nom n'est pas
+séparément) utilisé pour numéroter les titres de rubrique. Ceux qui sont
+utilisés le plus communément sont @code{section}, @code{subsection}, ou
+ at code{paragraph}. Dans ces trois cas, bien que le nom du compteur soit
+identique à celui de la commande elle-même, utiliser le même nom n'est pas
exigé.
-Alors @code{\the}@var{name} affiche le numéro de titre, et
+ at code{\the}@var{name} affiche le numéro de titre, et
@code{\}@var{name}@code{mark} sert aux en-têtes de page.
@item niveau
- at anchor{\@@startsection/level} Un entier donnant la profondeur de la
-commande de rubricage, par ex.@: 0 pour @code{chapter} (ceci ne
-s'applique qu'aux classes standardes @code{book} et @code{report}), 1
+ at anchor{\@@startsection/level} Entier donnant la profondeur de la
+commande de rubricage, par exemple 0 pour @code{chapter} (ceci ne
+s'applique qu'aux classes standards @code{book} et @code{report}), 1
pour @code{section}, 2 pour @code{subsection}, 3 pour
@code{subsubsection}, 4 pour @code{paragraph} et 5 pour
@code{subparagraph}. Dans les classes @code{book} et @code{report},
- at code{part} a pour niveau -1, alors que dans la classe @code{article},
- at code{part} a pour niveau 0.
+la rubrique @code{part} a pour niveau -1, alors que dans la classe @code{article},
+elle a pour niveau 0.
-Si @var{niveau} est inférieur ou égal à la valeur de @code{secnumdepth}
+Si @var{niveau} est inférieur ou égal à la valeur de @code{secnumdepth},
alors les titres pour cette commande de rubricage sont numérotés. Par
-ex.@: dans un @code{article}, si @code{secnumdepth} vaut 1 alors une
-commande @code{\section@{Introduction@}} produira en sortie quelque
-chose du genre de @code{1 Introduction} alors que
- at code{\subsection@{Historique@}} produit en sortie quelque chose du
-genre de @code{Historique}, sans numéro en
-préfixe. @xref{Sectioning/secnumdepth}.
+exemple : dans un @code{article}, si @code{secnumdepth} vaut 1, alors une
+commande @code{\section@{Introduction@}} produira en sortie une chaîne
+du type « @code{1 Introduction} », alors que
+ at code{\subsection@{Historique@}} produira en sortie une chaîne sans
+numéro de préfixe : « @code{Historique} ». @xref{Sectioning/secnumdepth}.
-Si @var{niveau} est inférieur ou égal à la valeur de @code{secnumdepth}
+Si @var{niveau} est inférieur ou égal à la valeur de @code{secnumdepth},
alors la table des matières aura un article pour cette rubrique. Par
-exemple, dans un @code{article}, si @code{tocdepth} vaut 1 alors la
+exemple, dans un @code{article}, si @code{tocdepth} vaut 1, la
table des matières listera les @code{section}s, mais pas les
@code{subsection}s.
@item retrait
@anchor{\@@startsection/indent}Une longueur donnant le renfoncement de
-toutes les lignes du titre relativement à la marge. Pour un
+toutes les lignes du titre par rapport à la marge. Pour un
renfoncement nul, utilisez @code{0pt}.
@c vous pouvez utiliser la macro @code{\z@@} définie à @code{0pt} pour
@c que le code soit plus efficace
@@ -784,7 +810,7 @@
Par exemple si @var{avant} vaut @code{-3.5ex plus -1ex minus -0.2ex}
alors pour commencer la nouvelle rubrique, @LaTeX{} ajoute environ 3,5
-fois la hauteur d'une lettre x en espace veritical, et le premier
+fois la hauteur d'une lettre x en espace vertical, et le premier
paragraphe de la rubrique n'est pas renfoncé. Utiliser une longueur
élastique, c.-à-d.@: comprenant @code{plus} et @code{minus}, est une
bonne pratique ici car cela donne à @LaTeX{} plus de latitude lors de la
@@ -801,7 +827,7 @@
cette page si celle-ci commençait par du texte).
@item après
- at anchor{\@@startsection/afterskip} Longueur. Lorsque elle est positive
+ at anchor{\@@startsection/afterskip} Longueur. Lorsqu'elle est positive
ou nulle, il s'agit de l'espace vertical à insérer après le titre de la
rubrique. Lorsque elle est négative, alors le titre fait corps avec le
paragraphe le suivant immédiatement. Dans ce cas la valeur absolue de
@@ -814,19 +840,21 @@
ici puisque elle donne à @LaTeX{} plus de latitude pour assembler la
page.
-Si @var{après} est positif ou nul alors la quantité totale d'espace
+Si @var{après} est positif ou nul, la quantité totale d'espace
vertical entre la ligne de base du titre de la rubrique et la ligne de
base de la première ligne du paragraphe suivant est la somme du
@code{\parskip} de la police du titre, de @code{\baselineskip} de la
police du corps de texte, et de la valeur de @var{après}. Cet espace est
typiquement élastique de sorte qu'il puisse se dilater ou se
-contracter. (Notez que du fait que le signe d'@var{après} contrôle que
-le titre soit indépendant du texte le suivant, ou fasse corps avec lui,
+contracter.
+
+Notez que, du fait que le signe d'@var{après} contrôle que
+le titre soit indépendant ou non du texte qui le suit,
vous ne pouvez pas utiliser un @var{après} négatif pour annuler une
-partie du @code{\parskip}).
+partie du @code{\parskip}.
@item style
- at anchor{\@@startsection/style} Contrôle le style du titre, voir les
+ at anchor{\@@startsection/style} Contrôle le style du titre : voir les
exemples plus bas. Les commandes typiquement utilisées ici sont
@code{\centering}, @code{\raggedright}, @code{\normalfont},
@code{\hrule}, ou @code{\newpage}. La dernière commande au sein de
@@ -837,14 +865,21 @@
et en capitales.
@end table
-Voici des exemples. Pour les utiliser mettez les soit au sein d'un
-fichier de paquetage ou de classe, ou placez les dans le préambule d'un
-document @LaTeX{} entre des commandes @code{\makeatletter} et
- at code{\makeatother}. (Le message d'erreur @code{You can't use
+ at b{EXEMPLES}
+
+Voici des exemples. Pour les utiliser, mettez-les soit au sein d'un
+fichier de paquetage ou de classe, soit dans le préambule d'un
+document @LaTeX{}, entre des commandes @code{\makeatletter} et
+ at code{\makeatother} : en effet, le message d'erreur @code{You can't use
`\spacefactor' in vertical mode.} est le plus probable lorsque on
-oublie de faire cela). @xref{\makeatletter and \makeatother}.
+oublie de faire cela.
-L'exemple suivant redéfinit la commande de rubricage @code{\section}
+ at xref{\makeatletter and \makeatother}.
+
+
+ at b{Premier exemple}
+
+Ce code redéfinit la commande de rubricage @code{\section}
pour qu'elle centre le titre et le mette en gras :
@example
@@ -857,7 +892,10 @@
@{\centering\normalfont\Large\bfseries@}@}% @ref{\@@startsection/style, at var{style}, at var{style}}.
@end example
-Cet exemple met les titres de @code{subsection} en petites capitales, et
+
+ at b{Deuxième exemple}
+
+Ce code met les titres de @code{subsection} en petites capitales, et
leur fait faire corps avec le paragraphe suivant.
@example
@@ -871,8 +909,11 @@
@}
@end example
-Les exemples précédents redéfinissait les commandes de titre de
-rubriques existantes. celui-ci en définit une nouvelle, illustrant la
+
+ at b{Troisième exemple}
+
+Les exemples précédents redéfinissaient les commandes de titre de
+rubriques existantes. L'exemple suivant définit une nouvelle commande, illustrant la
nécessité d'un compteur et de macros pour son affichage.
@c From https://groups.google.com/forum/#!searchin/comp.text.tex/startsection%7Csort:relevance/comp.text.tex/sB-nTS-oL08/ZZeKYdG0llMJ
@@ -953,18 +994,19 @@
@code{\newcommand*@{\@var{cmd}@}} vérifie que si la commande @code{\@var{cmd}}
n'est pas déjà définie et génère une erreur si c'est le cas.
-Voici un autre exemple où la commande @code{\agentsecret} comporte deux
-arguments et sa variante étoilée @code{\agentsecret*} un seul :
+Voici un autre exemple, où la commande @code{\agentsecret} comporte deux
+arguments, tandis que sa variante étoilée @code{\agentsecret*} n'en présente qu'un seul :
@example
\makeatletter
\newcommand*\agentsecret@@starred[1]@{\textsc@{#1@}@}
\newcommand*\agentsecret@@unstarred[2]@{\textit@{#1@} \textsc@{#2@}@}
-\newcommand\agentsecret@{\@@ifstar@{\agentsecret@@starred@}@{\agentsecret@@unstarred@}@}
+\newcommand\agentsecret@{\@@ifstar@{\agentsecret@@starred@}
+@ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @{\agentsecret@@unstarred@}@}
\makeatother
@end example
- at noindent Avec cette définition la célèbre réplique de l'agent 007 :
+ at noindent Avec cette définition, la célèbre réplique de l'agent 007 :
@example
Je m'appelle \agentsecret*@{Bond@}, \agentsecret@{James@}@{Bond@}.
@@ -976,10 +1018,11 @@
Je m'appelle \textsc@{Bond@}, \textit@{James@} textsc@{Bond@}.
@end example
-Un dernier mot : contrairement aux noms d'environnement où l'étoile fait partie
-du nom lui-même, et pourrait donc être à n'importe quelle position, dans le nom
-d'une commande l'étoile est comme une sorte d'argument optionnel. D'un point de
-vue purement @TeX{}nique il est donc possible de mettre un nombre indéfini
+Un dernier mot :
+dans le nom d'une commande, l'étoile est comme une sorte d'argument optionnel.
+Ceci est différent des noms d'environnement, où l'étoile fait partie
+du nom lui-même, et peut donc être à n'importe quelle position !
+D'un point de vue purement @TeX{}nique il est donc possible de mettre un nombre indéfini
d'espaces entre la commande et l'étoile. Ainsi @code{\agentsecret*@{Bond@}} et
@code{\agentsecret *@{Bond@}} sont équivalents. Toutefois la pratique commune
est de ne jamais insérer de tels espaces.
@@ -1200,7 +1243,7 @@
documents par @code{\documentclass@{cmsnote@}}.
Ce qui distingue un paquetage d'une classe de document c'est que les
-commandes d'une paquatage sont utilisables pour différentes classes
+commandes d'une paquetage sont utilisables pour différentes classes
alors que celles dans une classes de document sont spécifiques à cette
classes. Ainsi, une commande qui permet de régler les en-têtes de pages
irait dans un paquetage alors qu'une commande intitulant en-têtes de
More information about the latexrefman-commits
mailing list