[latexrefman-commits] [SCM] latexrefman updated: r868 - trunk
vincentb1 at gnu.org.ua
vincentb1 at gnu.org.ua
Tue Dec 22 14:15:32 CET 2020
Author: vincentb1
Date: 2020-12-22 15:15:32 +0200 (Tue, 22 Dec 2020)
New Revision: 868
Modified:
trunk/ChangeLog
trunk/latex2e-fr.texi
trunk/latex2e.texi
Log:
[fr] itemize, catch-up, [en] itemize, improve.
* latex2e-fr.texi (itemize): Align on English.
* latex2e.texi (itemize): ``itemized'' -> ``unordered'' +
@dfn{...}. Mention ``default'' means no locale through
e.g. babel. Nesting on a separate paragraph. ``note'' first and
``also use'' second for the roman numerals convention. Make it
clear that reference to list node concerns parameters related to
itemize.
Modified: trunk/ChangeLog
===================================================================
--- trunk/ChangeLog 2020-12-22 10:56:01 UTC (rev 867)
+++ trunk/ChangeLog 2020-12-22 13:15:32 UTC (rev 868)
@@ -1,5 +1,16 @@
2020-12-22 Vincent Bela\"iche <vincentb1 at users.sourceforge.net>
+ * latex2e.texi (itemize): ``itemized'' -> ``unordered'' +
+ @dfn{...}. Mention ``default'' means no locale through
+ e.g. babel. Nesting on a separate paragraph. ``note'' first and
+ ``also use'' second for the roman numerals convention. Make it
+ clear that reference to list node concerns parameters related to
+ itemize.
+
+ * latex2e-fr.texi (itemize): Align on English.
+
+2020-12-22 Vincent Bela\"iche <vincentb1 at users.sourceforge.net>
+
* latex2e.texi (flushright): Add ``interword'' concerning
shrinking/stretching space.
(flushright, \raggedleft): Mark references to flushleft examples
Modified: trunk/latex2e-fr.texi
===================================================================
--- trunk/latex2e-fr.texi 2020-12-22 10:56:01 UTC (rev 867)
+++ trunk/latex2e-fr.texi 2020-12-22 13:15:32 UTC (rev 868)
@@ -4788,52 +4788,85 @@
@example
\begin@{itemize@}
-\item @var{item1}
-\item @var{item2}
-...
+ \item[@var{étiquette optionnelle du 1er article}] @var{texte du 1er article}
+ \item[@var{étiquette optionnelle du 2e article}] @var{texte du 2e article}
+ ...
\end@{itemize@}
@end example
-L'environnement @code{itemize} produit une liste « non ordonnée », « à
-puces ». Les environnement @code{itemize} peuvent être imbriqués l'un
-dans l'autre, jusqu'à quatre niveaux de profondeur. Ils peuvent aussi
-être imbriqués avec d'autre environnements fabriquant des paragraphes,
-comme @code{enumerate} (@pxref{enumerate}).
+L'environnement @code{itemize} produit une @dfn{liste non ordonnée}, qu'on
+appelle parfois liste à puces. Il doit y avoir au moins une commande
+ at code{\item} au sein de l'environnement ; sans quoi @LaTeX{} produit
+l'erreur @samp{Something's wrong--perhaps a missing \item}.
-Chaque article d'une liste @code{itemize} commence avec une commande
- at code{\item}. Il doit y avoir au moins une commande @code{\item} au
-sein de l'environnement.
+L'exemple suivant donne une liste à deux articles.
-Par défaut, les marques de chaque niveau ressemblent à cela :
+ at example
+\begin@{itemize@}
+ \item Esquisse au crayon et aquarelle par Cassandra
+ \item Portrait Rice
+\end@{itemize@}
+ at end example
+ at noindent
+Par défaut --- sans charger par ex.@: le paquetage @file{babel} avec une
+autre langue que USenglish --- dans une liste au premier niveau
+d'imbrication l'étiquette est rendue par une puce, @bullet{}. Le format
+des étiquettes dépend du niveau d'imbrication ; voir plus bas.
+
+
+ at findex \item
+On démarre les article de liste avec la commande @code{\item}
+(@pxref{\item}). Si vous passez à @code{\item} un argument optionnel en
+le faisant suivre de crochets, comme dans @code{\item[@var{étiquette
+optionnelle}]}, alors par défaut @var{étiquette optionnelle} 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
+ at ref{description}. À la suite @code{\item} se trouve le texte que
+l'article qui peut être vide ou contenir plusieurs paragraphes.
+
+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
+ at code{enumerate} (@pxref{enumerate}).
+
+ at findex \labelitemi
+ at findex \labelitemii
+ at findex \labelitemiii
+ at findex \labelitemiv
+ at anchor{itemize labelitemi}
+ at anchor{itemize labelitemii}
+ at anchor{itemize labelitemiii}
+ at anchor{itemize labelitemiv}
+L'environnement @code{itemize} utilise les commandes de
+ at code{\labelitemi} jusqu'à @code{\labelitemiv} pour produire les
+é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 :
+
@enumerate
- at item @bullet{} (puce)
- at item @b{- at w{-}} (tiret demi-cadratin gras)
- at item * (asterisque)
+ at item @bullet{} (puce, issue de @code{\textbullet})
+ at item @b{- at w{-}} (tiret demi-cadratin gras, issu du @code{\normalfont\bfseries\textendash})
+ at item * (asterisque, issu de @code{\textasteriskcentered})
@iftex
- at item @math{\cdot} (point centré verticalement)
+ at item @math{\cdot} (point centré verticalement, issu de @code{\textperiodcentered})
@end iftex
@ifnottex
- at item . (point centré verticalement, rendu ici comme un point final)
+ at item . (point centré verticalement, rendu ici comme un point final, issu de @code{\textperiodcentered})
@end ifnottex
@end enumerate
@c vincentb1 cette information n'est pas dans l'original, vérifiez avec Karl :
-Si vous utilisez l'environnement @code{babel} avec la langue
+Si vous utilisez le paquetage @file{babel} avec la langue
@code{french}, alors il y a des tirets pour tous les niveaux comme c'est
l'habitude des Français.
- at findex \labelitemi
- at findex \labelitemii
- at findex \labelitemiii
- at findex \labelitemiv
-L'environnement @code{itemize} utilise les commandes de
- at code{\labelitemi} jusqu'à @code{\labelitemiv} pour produire les
-étiquettes par défaut. Ainsi, vous pouvez utiliser @code{\renewcommand}
-pour changer les étiquettes. Par exemple, pour que le premier niveau
-utilise des losanges :
+
+Utilisez @code{\renewcommand} pour changer les étiquettes. Par exemple,
+pour que le premier niveau utilise des losanges :
+
@example
\renewcommand@{\labelitemi@}@{$\diamond$@}
@end example
@@ -4854,7 +4887,7 @@
@anchor{itemize leftmarginvi}
Les paramètres de @code{\leftmargini} jusqu'à @code{\leftmarginvi}
définissent la distance entre la marge de gauche de l'environnement
-surjacent et la marge de gauche de la liste. (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 :
@code{2.5em} pour le niveau 1 (@code{2em} en mode deux-colonnes),
@@ -4864,20 +4897,22 @@
@PkgIndex{enumitem}
Pour les autres environnements majeurs de listes à étiquettes de
- at LaTeX{}, voir @ref{description} et @ref{enumerate}. 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 @ref{list}. La paquetage @file{enumitem} est utile
-pour personaliser les listes.
+ at LaTeX{}, voir @ref{description} et @ref{enumerate}. Les environnements
+ at code{itemize}, @code{enumerate} et @code{description} 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 @ref{list}. Le paquetage
+ at file{enumitem} est utile pour personaliser les listes.
Dans cet exemple on réduit grandement l'espace de marge pour la liste à
-puces la plus externe~:
+puces la plus externe :
@example
\setlength@{\leftmargini@}@{1.25em@} % valeur par défaut 2.5em
@end example
- at c xx should be in its own generic section
+ at c xx TODO vérifier que tout cela se retouve bien dans node list.
+ at ignore
Quelques paramètres qui affectent le formatage des listes :
@ftable @code
@@ -4936,7 +4971,9 @@
@code{12pt}.
@end ftable
+ at end ignore
+
@findex \parskip @r{exemple}
En particulier pour les listes avec des articles courts, il peut être
désirable d'élider l'espace entre les articles. Voici un exemple
@@ -5138,7 +5175,7 @@
and @code{0pt}. La valeurs par défaut à la taille de 11 point sont :
@code{4.5pt plus2pt minus1pt}, @code{2pt plus1pt minus1pt}, et
@code{0pt}. La valeurs par défaut à la taille de 12 point sont :
- at code{5pt plus2.5pt minus1pt}, @code{2.5pt plus1pt minus1pt}, and
+ at code{5pt plus2.5pt minus1pt}, @code{2.5pt plus1pt minus1pt}, et
@code{0pt}.
@item \partopsep
Modified: trunk/latex2e.texi
===================================================================
--- trunk/latex2e.texi 2020-12-22 10:56:01 UTC (rev 867)
+++ trunk/latex2e.texi 2020-12-22 13:15:32 UTC (rev 868)
@@ -5393,8 +5393,8 @@
\end@{itemize@}
@end example
-Produce a list that is unordered, sometimes called a bullet list. The
-environment must have at least one @code{\item}; having none causes the
+Produce an @dfn{unordered list}, sometimes called a bullet list. There
+must be at least one @code{\item} within the environment; having none causes the
@LaTeX{} error @samp{Something's wrong--perhaps a missing \item}.
This gives a two-item list.
@@ -5407,18 +5407,24 @@
@end example
@noindent
-As a top-level list each label would come out as a bullet, @bullet{}.
-The format of the labeling depends on the nesting level; see below.
+With the default locale---without loading e.g.@: @file{babel} package
+with another language than USenglish---as a top-level list each label
+would come out as a bullet, @bullet{}. The format of the labeling
+depends on the nesting level; see below.
@findex \item
Start list items with the @code{\item} command (@pxref{\item}). If you
give @code{\item} an optional argument by following it with square
-brackets, as in @code{\item[Optional label]}, then by default it will
-appear in bold and be flush right, so it could extend into the left
-margin. For labels that are flush left see the @ref{description}
-environment. Following the @code{\item} is optional text, which may
-contain multiple paragraphs.
+brackets, as in @code{\item[@var{Optional label}]}, then by default
+ at var{Optional label} will appear in bold and be flush right, so it could
+extend into the left margin. For labels that are flush left see the
+ at ref{description} environment. Following the @code{\item} is the text of
+the item, which may be empty or contain multiple paragraphs.
+Unordered lists can be nested within one another, up to four levels deep.
+They can also be nested within other paragraph-making environments, such
+as @code{enumerate} (@pxref{enumerate}).
+
@findex \labelitemi
@findex \labelitemii
@findex \labelitemiii
@@ -5427,23 +5433,21 @@
@anchor{itemize labelitemii}
@anchor{itemize labelitemiii}
@anchor{itemize labelitemiv}
-Itemized lists can be nested within one another, up to four levels deep.
-They can also be nested within other paragraph-making environments, such
-as @code{enumerate} (@pxref{enumerate}). The @code{itemize} environment
-uses the commands @code{\labelitemi} through @code{\labelitemiv} to
-produce the default label (this also uses the convention of lowercase
-roman numerals at the end of the command names that signify the nesting
-level). These are the default marks at each level.
+The @code{itemize} environment uses the commands @code{\labelitemi}
+through @code{\labelitemiv} to produce the default label (note the
+the convention of lowercase roman numerals at the end of the command
+names that signify the nesting level). These are the default marks at
+each level.
@enumerate
@item @bullet{} (bullet, from @code{\textbullet})
@item @b{- at w{-}} (bold en-dash, from @code{\normalfont\bfseries\textendash})
@item * (asterisk, from @code{\textasteriskcentered})
@iftex
- at item @math{\cdot} (centered dot, from @code{\textperiodcentered})
+ at item @math{\cdot} (vertically centered dot, from @code{\textperiodcentered})
@end iftex
@ifnottex
- at item . (centered dot, rendered here as a period, from @code{\textperiodcentered})
+ at item . (vertically centered dot, rendered here as a period, from @code{\textperiodcentered})
@end ifnottex
@end enumerate
@@ -5470,19 +5474,20 @@
@anchor{itemize leftmarginvi}
The distance between the left margin of the enclosing environment and
the left margin of the @code{itemize} list is determined by the
-parameters @code{\leftmargini} through @code{\leftmarginvi}. (Note the
-convention of using lowercase roman numerals a the end of the command
-name to denote the nesting level.) The defaults are: @code{2.5em} in
-level 1 (@code{2em} in two-column mode), @code{2.2em} in level 2,
- at code{1.87em} in level 3, and @code{1.7em} in level 4, with smaller
-values for more deeply nested levels.
+parameters @code{\leftmargini} through @code{\leftmarginvi}. (This also
+uses the convention of using lowercase roman numerals a the end of the
+command name to denote the nesting level.) The defaults are:
+ at code{2.5em} in level 1 (@code{2em} in two-column mode), @code{2.2em} in
+level 2, @code{1.87em} in level 3, and @code{1.7em} in level 4, with
+smaller values for more deeply nested levels.
@PkgIndex{enumitem}
For other major @LaTeX{} labeled list environments, see
- at ref{description} and @ref{enumerate}. For information about list
-layout parameters, including the default values, and for information
-about customizing list layout, see @ref{list}. The package
- at file{enumitem} is useful for customizing lists.
+ at ref{description} and @ref{enumerate}. The @code{itemize},
+ at code{enumerate} and @code{description} environment use the same list
+layout parameters. For a description, including the default values, and
+for information about customizing list layout, see @ref{list}. The
+package @file{enumitem} is useful for customizing lists.
This example greatly reduces the margin space for outermost itemized
lists.
More information about the latexrefman-commits
mailing list.