[latexrefman-commits] r489 - in /trunk: ChangeLog latex2e-fr.texi latex2e.texi
vincent.b.1 at domain.hid
vincent.b.1 at domain.hid
Mon Dec 14 11:43:25 CET 2015
Author: vincentb1
Date: Mon Dec 14 11:43:25 2015
New Revision: 489
URL: http://svn.gna.org/viewcvs/latexrefman?rev=489&view=rev
Log:
* latex2e-fr.texi (Top): section->rubrique, sectionement->rubricage (@LaTeX{} command syntax): Add node ``\makeatletter and \makeatother''. (\makeatletter and \makeatother): New node, translated from English version, plus improvement as changes in latex2e.texi, plus \@startsection example made a separate node with more information. (\@@startsection): New node.
* latex2e.texi (\makeatletter and \makeatother): Change ``read by TeX and LaTeX'' to ``read by TeX for LaTeX''. Change ``character code'' to ``character category code'', and introduce term ``catcode''. Use the term ``private commands'' for commands with an ``@'' in their names. Improve wording about command names with a single non-letter. Suppress chiasmus of ``\documentclass and \usepackage'' w.r.t. ``.sty and .cls files''. Add TODO @comment about making \@startsection a separate node, see French version. (\makelabels) Add reminder TODO comment to align on French version.
Modified:
trunk/ChangeLog
trunk/latex2e-fr.texi
trunk/latex2e.texi
Modified: trunk/ChangeLog
URL: http://svn.gna.org/viewcvs/latexrefman/trunk/ChangeLog?rev=489&r1=488&r2=489&view=diff
==============================================================================
--- trunk/ChangeLog (original)
+++ trunk/ChangeLog Mon Dec 14 11:43:25 2015
@@ -1,3 +1,24 @@
+2015-12-14 Vincent Belaïche <vincentb1 at domain.hid>
+
+ * latex2e-fr.texi (Top): section->rubrique, sectionement->rubricage
+ (@LaTeX{} command syntax): Add node ``\makeatletter and \makeatother''.
+ (\makeatletter and \makeatother): New node, translated from
+ English version, plus improvement as changes in latex2e.texi, plus
+ \@startsection example made a separate node with more information.
+ (\@@startsection): New node.
+
+ * latex2e.texi (\makeatletter and \makeatother): Change ``read by
+ TeX and LaTeX'' to ``read by TeX for LaTeX''. Change ``character
+ code'' to ``character category code'', and introduce term
+ ``catcode''. Use the term ``private commands'' for commands with
+ an ``@'' in their names. Improve wording about command names with
+ a single non-letter. Suppress chiasmus of ``\documentclass and
+ \usepackage'' w.r.t. ``.sty and .cls files''. Add TODO @comment
+ about making \@startsection a separate node, see French version.
+ (\makelabels) Add reminder TODO comment to align on French
+ version.
+
+
2015-12-10 Jim Hefferon <jhefferon at domain.hid>
* latex2e.texi (array, center): Adjust wording, add examples.
Modified: trunk/latex2e-fr.texi
URL: http://svn.gna.org/viewcvs/latexrefman/trunk/latex2e-fr.texi?rev=489&r1=488&r2=489&view=diff
==============================================================================
--- trunk/latex2e-fr.texi (original)
+++ trunk/latex2e-fr.texi Mon Dec 14 11:43:25 2015
@@ -130,7 +130,7 @@
* Classe de documents: Document classes. Certaines des différentes classes disponibles.
* Polices: Fonts. italique, gras, machine à écrire, etc
* Mise en page: Layout. Contrôle de la mise en page.
-* Sectionnement: Sectioning. Comment bien faire des sections.
+* Rubricage: Sectioning. Comment bien faire des rubriques.
* Les références croisées: Cross references. Référencement automatique.
* Environnements: Environments. tels que @code{enumerate} et @code{itemize}.
* Sauts de ligne: Line breaking. Influencer les sauts de ligne.
@@ -522,6 +522,7 @@
@menu
* Environnement: Environment. Zone du code source avec un comportement distinct.
* Déclaration: Declaration. Changer la valeur ou la signification d'une commande.
+* \makeatletter et \makeatother: \makeatletter and \makeatother. Change la catégorie du caractère arobe.
@end menu
@@ -571,6 +572,127 @@
change le réglage de la numérotation des pages en passant de numéros
romains à des numéros arabes.
+ at node \makeatletter and \makeatother
+
+Synopsis :
+
+ at example
+\makeatletter
+ ... définition de commande comprenant @@ dans leur nom ..
+\makeatother
+ at end example
+
+Utilisé pour redéfinir des commandes internes de @LaTeX{}.
+ at code{\makeatletter} a pour effet que le caractère arobe @code{@@} ait
+le code de catégorie des lettres, c.-à -d.@: 11. @code{\makeatother}
+règle de code de catégorie de @code{@@} à 12, sa valeur d'origine.
+
+À mesure que chaque caractère est lu par @TeX{} pour @LaTeX{}, un code
+de catégorie lui est assigné. On appelle aussi ce code
+ at cindex catcode
+ at cindex code de catégorie de caractère
+ at 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
+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
+utilisateur de définir accidentellement une commande qui remplacerait
+l'une des commandes privées de @LaTeX{}. Les noms de commandes
+consistent en un caractère de catégorie 0, d'ordinaire une
+contr'oblique, suivi de lettres, c.-à -d.@: des caractères de
+catégorie 11 (à ceci près q'un nom de commande peut aussi consister d'un
+catactère de catégorie 0 suivi d'un seul symbole non-lettre). Ainsi sous
+le régime par défaut de codes de catégorie, les commandes définies par
+l'utilisateur ne peuvent pas contenir de @code{@@}. Mais
+ at code{\makeatletter} et @code{\makeatother} permettent aux utilisateurs
+de définir et re-définir des commandes dont le nom comprend une
+ at 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.
+
+Des exemple d'utilisation sont donnés ci-après :
+
+ at menu
+* \@@startsection:: Redefinir les commandes de rubricage.
+ at end menu
+
+
+ at node \@@startsection
+
+Synopsis :
+
+ at example
+\@@startsection at domain.hid}@}
+ at end example
+
+Cette commande permet de redéfinir les commandes de rubricage. Par ex.@:
+le code source ci-dessous, si placé dans le préambule, redéfinit la
+commande de rubricage @code{\section} pour qu'elle centre le titre, le
+mette en gras, et ajuste l'espacement :
+
+ at example
+\makeatletter
+\renewcommand\section at domain.hid@}% @ref{\@@startsection/name,Nom}
+ @{1@}% @ref{\@@startsection/level,Niveau} : 0=part, 1=chapter, etc.
+ @{0pt@}% @ref{\@@startsection/indent,Indentation du titre}
+ @{-3.5ex plus -1ex minus -.2ex@}% @ref{\@@startsection/beforeskip,Saut vertical avant (pas d'indentation si négatif)}
+ @{2.3ex plus.2ex@}% @ref{\@@startsection/beforeskip,Saut vertical après (si négatifif at domain.hid{} fait corps avec la suite)}
+ @{\centering\normalfont\Large\bfseries@}@} % @ref{\@@startsection/style,Style du titre}
+\makeatother
+ at end example
+
+La commande @code{\@@startsection} prend six arguments.
+
+ at table @var
+
+ at item nom
+ at anchor{\@@startsection/name}
+Nom de la commande de rubricage, par ex.@: @code{paragraph}
+
+ at item niveau
+ at anchor{\@@startsection/level} Profondeur de la commande de
+rubricage, par ex.@: 0 pour @code{part}, 1 pour @code{chapter}, 2
+pour @code{section}. Cette valeur est comparée aux compteurs
+ at code{secnumdepth} et @code{tocdepth} pour contrôler la numéroation des
+rubriques et la profondeur de la table des matières.
+
+ at item indent
+ at anchor{\@@startsection/indent}Indentation du titre. Pour une
+indentation nulle, vous pouvez utiliser la macro @code{\z@@} définie Ã
+ at code{0pt} pour que le code soit plus efficace.
+
+ at item avant
+ at anchor{\@@startsection/beforeskip}
+Longueur dont la valeur absolue est la longueur de l'espace verticale Ã
+insérer avant le titre. Pour une bonne composition, utilisez une
+longueur élastique.
+
+Si en plus @var{avant} est négatif, alors le premier paragraphe suivant
+immédiatement le titre n'est pas indenté.
+
+ at item après
+ at anchor{\@@startsection/afterskip} Longueur. Lorsque elle est positive,
+il s'agit de l'espace verticale à insérer après le titre. Pour une
+bonne composition, utilisez dans ce cas une longueur élastique.
+
+
+Lorsque elle est négative, alors le titre fait corps avec le paragraphe
+le suivant immédiatement, comme c'est le cas pour les rubriques
+ at code{\paragraph} dans la classe de document @code{article}, et la
+valeur absolue d'@var{après} donne l'espace horizontale entre la fin du
+dernier mot du titre et le début du premier mot du paragraphe avec
+lequel il fait corps.
+
+
+ at item style
+ at anchor{\@@startsection/style} Les commandes qui règlent le style du
+titre, par ex.@: @code{\bfseries} pour des caractères gras.
+ at end table
@node Document classes
@@ -1489,10 +1611,11 @@
@LaTeX{}? » @url{http://latex-project.org/papers/tb111mitt-float.pdf}.
@node Sectioning
- at domain.hid Des sections
- at domain.hid sectionnement
-
-Les commandes de sectionnement fournissent les moyens de structurer
+ at chapter Des rubriques
+
+ at cindex rubricage
+
+Les commandes de rubricage fournissent les moyens de structurer
votre texte en unités sectionnelles, ou rubriques :
@ftable @code
@@ -1522,13 +1645,13 @@
@end enumerate
Vous ne voudrez peut-être pas le même texte dans ces endroits que dans
-le texte principal. Pour gérer cela, les commandes de sectionnement ont
+le texte principal. Pour gérer cela, les commandes de rubricage ont
un argument optionnel @var{titretdm} qui, lorsqu'il est fourni, précise
le texte de ces autres endroits.
- at domain.hid forme étoilée de commandes de sectionnement
- at domain.hid forme en * de commandes de sectionnement
-En outre, toutes les commandes de sectionnement ont des formes en
+ at cindex forme étoilée de commandes de rubricage
+ at cindex forme en * de commandes de rubricage
+En outre, toutes les commandes de rubricage ont des formes en
@code{*}, aussi appelée étoilée, qui compose @var{titre} comme
d'habitude, mais ne comprennent pas de numéro et ne produisent pas
d'entrée dans la table des matières. Par exemple :
@@ -1608,7 +1731,7 @@
@item ch
pour les chapitres
@item sec
-les commandes de sectionnement de niveau inférieur
+les commandes de rubricage de niveau inférieur
@item fig
pour les figures
@item tab
@@ -3851,16 +3974,16 @@
est composé à sa longueur normale, c.-à -d.@: qu'il n'est pas dilaté pour
remplir la largeur de la ligne.
-Les saut de ligne explicite au sein du corps de texte sont inhabituel en
- at domain.hid{}. en particulier, pour commencer un nouveau paragraphe laissez
-plutôt une ligne à blanc. Cette commande est utilisée principalement en
-dehors du flux principal de texte comme dans un environnement
- at domain.hid} ou @code{array}.
-
-Dans des circonstances ordinaires (par ex.@: en dehors d'un colonne
-spécifiée par @code{p@{..@}} dans une environnement @code{tabular} in a
-tabular environment) la commande @code{\newline} est un synonyme de
- at domain.hid{\\} (@pxref{\newline}).
+Les sauts de ligne explicites au sein du corps de texte sont inhabituels
+en @LaTeX{}. en particulier, pour commencer un nouveau paragraphe
+laissez plutôt une ligne à blanc. Cette commande est utilisée
+principalement en dehors du flux principal de texte comme dans un
+environnement @code{tabular} ou @code{array}.
+
+Dans des circonstances ordinaires (par ex.@: en dehors d'une colonne
+spécifiée par @code{p@{..@}} dans un environnement @code{tabular}) la
+commande @code{\newline} est un synonyme de @code{\\}
+(@pxref{\newline}).
En plus de commencer une nouvelle ligne, la forme étoilée @code{\\*} dit
à @LaTeX{} de ne pas commencer une nouvelle parge entre les deux lignes,
@@ -3876,10 +3999,10 @@
@section @code{\obeycr} & @code{\restorecr}
@findex \obeycr
@findex \restorecr
- at domain.hid new line, output as input
+ at cindex saut de ligne, sortie semblable à l'entrée pour le
La commande @code{\obeycr} a pour effet qu'un retour chariot dans le
-fichier d'entrée (@samp{^^M}, internement) soit traté de la même façon
+fichier d'entrée (@samp{^^M}, internement) soit traité de la même façon
que @code{\\} (suivi d'un @code{\relax}). Ainsi chaque passage à la
ligne dans l'entrée est aussi un passage à la ligne dans la sortie.
@@ -5224,7 +5347,7 @@
--- des lignes ne contenant même pas un @code{%}. Une ligne à blanc ne
devrait pas apparaître là où un nouveau paragraphe n'a pas le droit de
commencer, tel que en mode mathématique ou dans l'argument d'une
-commande de sectionnement.
+commande de rubricage.
@menu
* \indent:: Indenter ce paragraphe.
Modified: trunk/latex2e.texi
URL: http://svn.gna.org/viewcvs/latexrefman/trunk/latex2e.texi?rev=489&r1=488&r2=489&view=diff
==============================================================================
--- trunk/latex2e.texi (original)
+++ trunk/latex2e.texi Mon Dec 14 11:43:25 2015
@@ -544,31 +544,35 @@
11. @code{\makeatother} sets the category code of at domain.hid{@@} to 12,
its original value.
-As each character is read by @TeX{} and @LaTeX{}, it is assigned a
-character code (for instance, the backslash at domain.hid{\} is assigned
-the character code 0, for characters that start a command). These two
-commands alter the code assigned to @code{@@}.
+As each character is read by @TeX{} for @LaTeX{}, it is assigned a
+character categorty code, or
+ at cindex catcode
+ at cindex character category code
+ at cindex category code, character
+ at dfn{catcode} for shorter. For instance, the backslash at domain.hid{\} is
+assigned the catcode 0, for characters that start a command. These two
+commands alter the catcode assigned to @code{@@}.
The alteration is needed because many of @LaTeX{}'s commands use
@code{@@} in their name, to prevent users from accidentally defining a
command that replaces one of @LaTeX{}'s own. Command names consist of a
category at domain.hid character, ordinarily backslash, followed by letters,
-category at domain.hid characters (except that a command name can consist of a
-single category at domain.hid character followed by a single non-letter
-symbol). So under the default category codes, user-defined commands
-cannot contain an @code{@@}. But @code{\makeatletter} and
- at domain.hid} allow users to define or redefine commands named
-with @code{@@}.
+category at domain.hid characters (except that a command name can also consist
+of a category at domain.hid character followed by a single non-letter symbol).
+So under the default category codes, user-defined commands cannot
+contain an @code{@@}. But @code{\makeatletter} and @code{\makeatother}
+allow users to define or redefine commands named with @code{@@}.
Use these inside a @file{.tex} file, in the preamble. Don't use them
-inside @file{.sty} or @file{.cls} files since the @code{\documentclass}
-and @code{\usepackage} commands set the at sign to have the character
+inside @file{.sty} or @file{.cls} files since the @code{\usepackage}
+and @code{\documentclass} commands set the at sign to have the character
code of a letter.
The example code below, if put in the preamble, redefines the
section command to center the section title, put it in bold type,
and adjust the spacing.
+ at c xxx TODO, make \@startsection a separate node, see latex2e-fr.texi
@c From http://zoonek.free.fr/LaTeX/LaTeX_samples_section/0.html
@example
\makeatletter
@@ -9675,6 +9679,8 @@
in the argument to the @code{letter} environment. By default
@code{\mlabel} ignores the first argument, the @var{sender address}.
+ at c xxx TODO, align on latex2e-fr.texi, see https://mail.gna.org/public/latexrefman-discuss/2015-10/msg00000.html
+
@node \name
@section @code{\name}
More information about the latexrefman-commits
mailing list