[latexrefman-commits] [SCM] latexrefman updated: r892 - trunk

[vincentb1 at gnu.org.ua]

Author: vincentb1
Date: 2020-12-29 21:06:23 +0200 (Tue, 29 Dec 2020)
New Revision: 892

Modified:
   trunk/ChangeLog
   trunk/latex2e-fr.texi
   trunk/latex2e.texi
Log:
[fr] page layour parameters, add anchors & fix margin description.

* latex2e-fr.texi (Page layout parameters): Add anchors, and fixe
the margin parameters description.

* latex2e.texi (Page layout parameters): Add Texinfo TODO comment
that margin description has to be fixed, point as the French
version for reference.


Modified: trunk/ChangeLog
===================================================================
--- trunk/ChangeLog	2020-12-26 20:22:08 UTC (rev 891)
+++ trunk/ChangeLog	2020-12-29 19:06:23 UTC (rev 892)
@@ -1,3 +1,12 @@
+2020-12-29  Vincent Bela\"iche  <vincentb1 at users.sourceforge.net>
+
+	* latex2e.texi (Page layout parameters): Add Texinfo TODO comment
+	that margin description has to be fixed, point as the French
+	version for reference.
+
+	* latex2e-fr.texi (Page layout parameters): Add anchors, and fixe
+	the margin parameters description.
+
 2020-12-26  Vincent Bela\"iche  <vincentb1 at users.sourceforge.net>
 
 	* latex2e.texi (\twocolumn): Minor rewording and fixes.

Modified: trunk/latex2e-fr.texi
===================================================================
--- trunk/latex2e-fr.texi	2020-12-26 20:22:08 UTC (rev 891)
+++ trunk/latex2e-fr.texi	2020-12-29 19:06:23 UTC (rev 892)
@@ -947,16 +947,12 @@
 @findex \evensidemargin
 @findex \oddsidemargin
 Sélectionne la disposition en recto simple ou recto-verso ; le défaut
-est @code{oneside} pour recto, sauf pour la classe @code{book}.
+est @code{oneside} pour recto simple, sauf pour la classe @code{book}.
 
 Le paramètre @code{\evensidemargin} (@code{\oddsidemargin}) détermine la
-distance sur les pages de numéro pair (impair) entre le côté gauche de
-la page et la marge gauche du texte. Les valeurs par défaut varient en
-fonction de la taille du papier, de la disposition recto ou
-recto-verso sélectionnée. Pour une impression en recto le texte est
-centré, pour recto-verso, @code{\oddsidemargin} vaut 40% de la
-différence entre @code{\paperWidth} et @code{\textwidth},
- at code{\evensidemargin} 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 @ref{page layout
+parameters oddsidemargin}.
 
 @item openright
 @itemx openany
@@ -2292,91 +2288,242 @@
 @cindex mise en page, les paramètres de
 @cindex en-tête, des paramètres pour
 @cindex bas de page, des paramètres pour
- at cindex en-tête et pied de page en cours de traitement
+ at cindex en-tête et pied de page en cours
 
 @ftable @code
+ at item \columnsep
+ at itemx \columnseprule
+ at itemx \columnwidth
+ at findex \columnsep
+ at findex \columnseprule
+ at findex \columnwidth
+ at anchor{page layout parameters columnsep}
+ at anchor{page layout parameters columnseprule}
+ at anchor{page layout parameters columnwidth}
+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 @code{twocolumn} est en vigueur (@pxref{Document class
+options}).  @xref{\twocolumn}.
+
 @item \headheight
-Hauteur de la boîte qui contient la tête en cours de traitement. La
-valeur par défaut est @samp{30pt}, sauf dans la classe @code{book}, où
-elle varie en fonction de la taille de la police.
+ at findex \headheight
+ at anchor{page layout parameters headheight}
+Hauteur de la boîte qui contient l'en-tête de page en cours. La valeur
+par défaut pour les classes @code{article}, @code{report}, et
+ at code{book} est @samp{12pt} quelle que soit la taille de la police.
 
 @item \headsep
-La distance verticale entre le bas de la ligne d'en-tête et la partie
-supérieure du texte principal. La valeur par défaut est @samp{25pt},
-sauf dans la classe @code{book}, où elle varie avec la taille de
-la police.
+ at findex \headsep 
+ at anchor{page layout parameters headsep}
+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 @samp{25pt}. Dans la classe
+ at code{book} la valeur par défaut est @samp{0.25in} pour un document
+réglé en 10pt, et @samp{0.275in} pour un document en 11pt ou 12pt.
 
 @item \footskip
+ at findex \footskip
+ at anchor{page layout parameters footskip}
 Distance de la ligne de base de la dernière ligne de texte à la ligne de
-base du bas de page. La valeur par défaut est @samp{30pt}, sauf dans la
-classe @code{book} où elle varie avec la taille de la police.
+base du pied de page. La valeur par défaut dans les classe
+ at code{article} et @code{report} est @samp{30pt}. Dans la classe
+ at code{book} la valeur par défaut est @samp{0.35in} pour les documents
+réglés en 10pt, @samp{0.38in} en 11pt, et @samp{30pt} en 12pt.
 
 @item \linewidth
+ at findex \linewidth
+ at anchor{page layout parameters linewidth}
 Largeur de la ligne actuelle, diminuée pour chaque @code{list} imbriquée
-(@pxref{list}). Plus précisément, elle est inférieure à
- at code{\textwidth} par la somme de @code{\leftmargin} et
- at code{\rightmargin} (@pxref{itemize}). La valeur par défaut varie en
-fonction de la taille de la police, la largeur du papier, le mode à deux
-colonnes, etc. Pour un document de classe @code{article} en taille de
-police @samp{10pt}, elle vaut @samp{345pt} ; dans le mode à deux
-colonnes, elle passe à @samp{229.5pt}.
+(@pxref{list}). C-à-d.@: que la valeur nominale @code{\linewidth} vaut
+ at code{\textwidth} mais que pour chaque liste imbriquée la largeur
+ at code{\linewidth} est diminuée de la somme de @code{\leftmargin} et
+ at code{\rightmargin} pour cette liste (@pxref{itemize}).
+ at c La valeur par défaut varie en fonction de la taille de la police, la
+ at c largeur du papier, le mode à deux colonnes, etc. Pour un document de
+ at c classe @code{article} en taille de police @samp{10pt}, elle vaut
+ at c @samp{345pt} ; dans le mode à deux colonnes, elle passe à
+ at c @samp{229.5pt}.
 
- at item \textheight
-La hauteur verticale normale du corps de la page ; la valeur par défaut
-varie en fonction de la taille de la police, de la classe du document,
-etc. Pour un document de classe @code{article} ou @code{report} en
-taille de police @samp{10pt}, elle vaut @samp{43\baselineskip} ; pour
-une classe @code{book}, elle vaut @samp{41\baselineskip}.  Pour
- at samp{11pt}, c'est @samp{38\baselineskip} et pour @samp{12pt} c'est
- at samp{36\baselineskip}.
+ at item \marginparpush
+ at itemx \marginsep
+ at itemx \marginparwidth
+ at findex \marginparpush
+ at findex \marginsep
+ at findex \marginparwidth
+ at anchor{page layout parameters marginparpush}
+ at anchor{page layout parameters marginsep}
+ at anchor{page layout parameters marginparwidth}
+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.
 
+Normalement les notes en marginales apparaissent à l'extérieur de la
+page, mais la déclaration @code{\reversemarginpar} change cela (et
+ at code{\normalmarginpar} le rétablit).
+
+La valeur par défaut pour @code{\marginparpush} à la fois dans un
+document de classe @code{book} ou @code{article} est : @samp{7pt} si le
+document est réglé à 12pt, et @samp{5pt} s'il l'est à 11pt ou 10pt.
+
+Pour @code{\marginsep}, dans la classe @code{article} la valeur par
+défaut est @samp{10pt} sauf si le document est réglé à 10pt et en mode en
+deux colonne où la valeur par défaut est @samp{11pt}.
+
+Pour @code{\marginsep} dans la classe @code{book} la valeur par défaut
+est @samp{10pt} en mode deux colonnes, et @samp{7pt} en mode
+mono-colonne.
+
+Pour @code{\marginparwidth} aussi bien dans les classes @code{book} que
+ at code{article}, en mode à deux colonnes la valeur par défaut est 60% ou
+ at code{\paperwidth @minus{} \textwidth}, alors qu'en mode monocolonne
+c'est 50% de cette distance.
+
+ at item \oddsidemargin
+ at itemx \evensidemargin
+ at findex \oddsidemargin
+ at findex \evensidemargin
+ at anchor{page layout parameters oddsidemargin}
+ at anchor{page layout parameters evensidemargin}
+ at cindex marge gauche
+La @dfn{marge gauche} est la bande entre le bord gauche de la page et le
+corps du texte.
+
+ at cindex marge gauche nominale
+La @dfn{marge gauche nominale} est la marge gauche lorsque les
+paramètres @code{\oddsidemargin} et @code{\eventsidemargin} sont à
+ at samp{0pt}. Sa frontière est une ligne verticale imaginaire située
+à une distance de @code{1in + \hoffset} du bord gauche de la page en
+allant vers le côté droit. La longueur @code{\hoffset} vaut @code{0pt},
+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.
+
+La longueur @code{\oddsidemargin} 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
+ at code{\evensidemargin} 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.
+
+En d'autres termes @code{\oddsidemargin} ou @code{\evensidemargin}
+donnent la différence entre la largeur de la marge gauche réel et la
+marge gauche nominale. Ces distances @code{\oddsidemargin} et
+ at code{\evensidemargin} 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.
+
+Dans une document en recto-verso le @dfn{côté intérieur} 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 @dfn{côté extérieur} est le côté opposé au
+côté intérieur : la longueur @code{\oddsidemargin} règle donc la
+position de la marge intérieure des pages de numéro impair, alors que
+ at code{\evensidemargin} règle la position la marge extérieur des pages de
+numéro pair.
+
+Pour une marge intérieure de 4cm dans un document en recto-verso, mettre
+le code suivant dans le préambule :
+
+ at example
+\evensidemargin\dimexpr\paperwidth-\textwidth-1in-4cm
+\oddsidemargin\dimexpr4cm-1in
+ at end example
+
+Vice-versa, pour une marge extérieure de 5cm dans un document en
+recto-verso, mettre le code suivant dans le préambule :
+
+ at example
+\evensidemargin\dimexpr5cm-1in
+\oddsidemargin\dimexpr\paperwidth-\textwidth-1in-5cm
+ at end example
+
 @item \paperheight
+ at anchor{page layout parameters paperheight}
 La hauteur du papier, à ne pas confondre avec la hauteur de la zone
 d'impression.  Elle est normalement réglée avec une option de classe de
 document, comme dans @code{\documentclass[a4paper]@{article@}}
 (@pxref{Document class options,Options de classe de document}).
 
 @item \paperwidth
+ at anchor{page layout parameters paperwidth}
 La largeur du papier, à ne pas confondre avec la largeur de la zone
 d'impression.  Elle est normalement réglée avec une option de classe de
 document, comme dans @code{\documentclass[a4paper]@{article@}}
 (@pxref{Document class options,Options de classe de document}).
 
+ at item \textheight
+ at anchor{page layout parameters textheight}
+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
+ at code{article} ou @code{report}, elle vaut @samp{43\baselineskip} ; pour
+une classe @code{book}, elle vaut @samp{41\baselineskip}.  Pour 11pt,
+c'est @samp{38\baselineskip} pour toutes les classes de document. Pour
+ at samp{12pt} c'est @samp{36\baselineskip} pour toutes les classes aussi.
+
 @item \textwidth
-La largeur horizontale totale de l'ensemble du corps de la page; la
-valeur par défaut varie comme d'habitude. Pour un document de classe
- at code{article} ou @code{report}, elle vaut @samp{345pt} à @samp{10pt} de
-taille de police, @samp{360pt} à @samp{11pt}, et @samp{390pt} à
- at samp{12pt}. Pour un document @code{book}, elle veut @samp{4.5in} à
- at samp{10pt} et @samp{5in} à @samp{11pt} ou @samp{12pt}.
+ at anchor{page layout parameters textwidth}
+La largeur horizontale totale de l'ensemble du corps de la page. Pour un
+document de classe @code{article} ou @code{report}, elle vaut
+ at samp{345pt} à 10pt de taille de police, @samp{360pt} à
+11pt, et @samp{390pt} à 12pt. Pour un document
+ at code{book}, elle veut @samp{4.5in} à 10pt et @samp{5in} à
+11pt ou 12pt.
 
 En sortie multi-colonne, @code{\textwidth} reste de la largeur de tout
 le corps de la page, tandis que @code{\columnwidth} est la largeur d'une
 colonne (@pxref{\twocolumn}).
 
-Dans les listes (@pxref{list}), @code{\textwidth} est le reste la
-largeur du corps corps de la page entière (et @code{\columnwidth} est la
-largeur d'une colonne entière), alors que @code{\linewidth} peut
-diminuer au sein de listes imbriquées.
+Dans les listes (@pxref{list}), @code{\textwidth} demeure la largeur du
+corps de la page entière (et @code{\columnwidth} est la largeur d'une
+colonne entière), alors que @code{\linewidth} peut diminuer au sein de
+listes imbriquées.
 
 À l'intérieur d'une minipage (@pxref{minipage} ) ou @code{\parbox}
 (@pxref{\parbox}), tous les paramètres liés à la largeur sont mis à la
 largeur spécifiée, et de reviennent à leurs valeurs normales à la fin du
 @code{minipage} ou @code{\parbox}.
 
+ at item \hsize
 @findex \hsize
+ at anchor{page layout parameters hsize}
 Par souci d'exhaustivité : @code{\hsize} est le paramètre @TeX{}
 primitif utilisé lorsque le texte est divisé en lignes. Il ne devrait
 pas être utilisé dans des documents @LaTeX{} en conditions normales.
 
 @item \topmargin
-L'espace entre le haut de la page @TeX{} (un pouce à partir du haut de
-la feuille, par défaut) et le sommet de l'en-tête de page. La valeur par
-défaut est calculée sur la base de nombreux autres paramètres :
- at code{\paperheight @minus{} 2in @minus{} \headheight @minus{} \headsep
- at minus{} \textheight @minus{} \footskip}, et ensuite divisé par deux.
+ at findex topmargin
+ at anchor{page layout parameters topmargin}
+ at cindex marge supérieure
+La @dfn{marge supérieure} est la bande entre le bord supérieur de la page et le
+bord supérieure de l'en-tête de page.
 
+ at cindex marge supérieure nominale
+La @dfn{marge supérieure nominale} est la marge supérieur lorsque
+ at code{\topmargin} vaut @samp{0pt}. Sa frontière est une ligne
+horizontale imaginaire située à une distance de @code{1in + \voffset} du
+bord supérieur de la page en allant vers le bas. La longueur
+ at code{\voffset} vaut @code{0pt}, 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.
+
+La distance @code{\topmargin} 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 @code{\topmargin} 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 @code{\topmargin}
+est la différence entre la largeur de la marge supérieure réelle et la
+marge supérieure nominale.
+
+L'espace le haut de la page @TeX{} et le haut du corps de texte est
+ at code{1in + \voffset + \topmargin + \headheight + \headsep}. La marge
+inférieure vaut donc @code{\paperheight -\textheight -\footskip - 1in -
+\voffset - \topmargin - \headheight - \headsep}.
+
 @item \topskip
+ at findex \topskip
+ at anchor{page layout parameters topskip}
 La distance minimale entre le sommet du corps de la page et la ligne de base de
 la première ligne de texte. Pour les classes standard, la valeur par défaut est la
 même que la taille de la police, par exemple, @samp{10pt} à @samp{10pt}.

Modified: trunk/latex2e.texi
===================================================================
--- trunk/latex2e.texi	2020-12-26 20:22:08 UTC (rev 891)
+++ trunk/latex2e.texi	2020-12-29 19:06:23 UTC (rev 892)
@@ -863,6 +863,7 @@
 @itemx twoside
 @findex \evensidemargin
 @findex \oddsidemargin
+ at c xx TODO re-align on the French version which is more accurate.
 Selects one- or two-sided layout; default is @code{oneside}, except
 that in the @code{book} class the default is @code{twoside}.
 
@@ -2838,7 +2839,7 @@
 Vertical distance between the bottom of the header line and the top of
 the main text.  The default in the @code{article} and @code{report}
 classes is @samp{25pt}.  In the @code{book} class the default is: if the
-document is set at 10pt then it is @samp{0.25in}, and at 11pt and 12pt
+document is set at 10pt then it is @samp{0.25in}, and at 11pt or 12pt
 it is @samp{0.275in}.
 
 @item \footskip
@@ -2901,12 +2902,13 @@
 @findex \evensidemargin
 @anchor{page layout parameters oddsidemargin}
 @anchor{page layout parameters evensidemargin}
-The @code{\oddsidemargin} is the extra distance between the left side of
+ at c xx TODO re-align on French version that is more complete/accurate.
+The @code{\oddsidemargin} length is the extra distance between the left side of
 the page and the text's left margin, on odd-numbered pages when the
 document class option @code{twoside} is chosen and on all pages when
 @code{oneside} is in effect.  When @code{twoside} is in effect, on
 even-numbered pages the extra distance on the left is
- at code{evensidemargin}.
+ at code{\evensidemargin}.
 
 @LaTeX{}'s default is that @code{\oddsidemargin} is 40% of the
 difference between @code{\paperwidth} and @code{\textwidth}, and
@@ -2960,9 +2962,9 @@
 specified width, and revert to their normal values at the end of the
 @code{minipage} or @code{\parbox}.
 
+ at item \hsize
 @findex \hsize
 @anchor{page layout parameters hsize}
- at item \hsize
 This entry is included for completeness: @code{\hsize} is the @TeX{}
 primitive parameter used when text is broken into lines.  It should not
 be used in normal @LaTeX{} documents.
@@ -2970,6 +2972,7 @@
 @item \topmargin
 @findex topmargin
 @anchor{page layout parameters topmargin}
+ at c xxx TODO re-align on French version that is more accurate.
 Space between the top of the @TeX{} page (one inch from the top of the
 paper, by default) and the top of the header.  The value is computed
 based on many other parameters: @code{\paperheight @minus{} 2in @minus{}
@@ -11163,8 +11166,9 @@
 @ftable @code
 @item \marginparpush
 @anchor{marginal notes marginparpush}
-Minimum vertical space between notes; default @samp{7pt} for
- at samp{12pt} documents, @samp{5pt} else.
+Minimum vertical space between notes; default @samp{7pt} for @samp{12pt}
+documents, @samp{5pt} else. See also at tie{}@ref{page layout parameters
+marginparpush}.
 
 @item \marginparsep
 @anchor{marginal notes marginparsep}