[latexrefman-commits] [SCM] latexrefman updated: r774 - trunk
vincentb1 at gnu.org.ua
vincentb1 at gnu.org.ua
Sun Mar 29 23:19:11 CEST 2020
Author: vincentb1
Date: 2020-03-30 00:19:11 +0300 (Mon, 30 Mar 2020)
New Revision: 774
Modified:
trunk/ChangeLog
trunk/latex2e-fr.texi
Log:
[fr] Insert sectional unit nodes w/o translation yet.
* latex2e-fr.texi (Sectioning): Progress translation alignment on [en].
(\part, \chapter, \section, \subsection)
(\subsubsection & \paragraph & \subparagraph, \appendix)
(\frontmatter & \mainmatter & \backmatter): Insert nodes w/o translation.
Modified: trunk/ChangeLog
===================================================================
--- trunk/ChangeLog 2020-03-29 20:57:37 UTC (rev 773)
+++ trunk/ChangeLog 2020-03-29 21:19:11 UTC (rev 774)
@@ -1,5 +1,12 @@
2020-03-29 Vincent Belaïche <vincentb1 at users.sourceforge.net>
+ * latex2e-fr.texi (Sectioning): Progress translation alignment on [en].
+ (\part, \chapter, \section, \subsection)
+ (\subsubsection & \paragraph & \subparagraph, \appendix)
+ (\frontmatter & \mainmatter & \backmatter): Insert nodes w/o translation.
+
+2020-03-29 Vincent Belaïche <vincentb1 at users.sourceforge.net>
+
* latex2e-fr.texi (\@@startsection): Move node to the same place as in [en].
2020-03-29 Vincent Belaïche <vincentb1 at users.sourceforge.net>
Modified: trunk/latex2e-fr.texi
===================================================================
--- trunk/latex2e-fr.texi 2020-03-29 20:57:37 UTC (rev 773)
+++ trunk/latex2e-fr.texi 2020-03-29 21:19:11 UTC (rev 774)
@@ -2398,6 +2398,7 @@
@findex secnumdepth @r{counter}
@cindex numéros de rubrique, composition
+ at anchor{sectioning secnumdepth}
@anchor{Sectioning/secnumdepth}
Le compteur @code{secnumdepth} contrôle la composition des numéros de
rubrique. le paramètre
@@ -2410,14 +2411,584 @@
supprime le numéros de rubrique à n'importe quelle profondeur @math{> @var{niveau}}, où
@code{chapter} est le niveau zéro. (@xref{\setcounter}.)
+ at findex tocdepth @r{counter}
+ at cindex table des matières, impression des numéros de rubrique
+ at anchor{sectioning tocdepth}
+ at anchor{Sectioning/tocdepth}
+
+Contrôle quelle rubriques sont listées dans la table des matières.
+Régler @code{\setcounter@{tocdepth@}@{@var{niveau}@}} a pour effet que
+les rubriques au niveau @var{niveau} sont celle de plus petit niveau à
+être listées (@pxref{\setcounter}). Voir la table ci-dessus pour les
+numéro de niveau. Par exempe, if @code{tocdepth} vaut 1 alors la table
+des matière contiendra les rubriques issues de @code{\section}, mais pas
+cells de @code{\subsection}. La valeur par défaut de @LaTeX{} pour
+ at code{secnumdepth} vaut 3 dans la classe @file{article} et 2 dans les
+classe @file{book} et @file{report}.
+
+
@menu
-* \@@startsection:: Layout of sectional units.
+* \part:: Start a part.
+* \chapter:: Start a chapter.
+* \section:: Start a section.
+* \subsection:: Start a subsection.
+* \subsubsection & \paragraph & \subparagraph:: Lower divisions.
+* \appendix:: Start appendices.
+* \frontmatter & \mainmatter & \backmatter:: The three parts of a book.
+* \@@startsection:: Redéfinir les commandes de rubricage. at c Layout of sectional units.
@end menu
+ at node \part
+ at c À traduire
+ at section @code{\part}
+
+ at findex \part
+ at cindex part
+ at cindex sectioning, part
+
+Synopsis, one of:
+
+ at example
+\part@{@var{title}@}
+\part*@{@var{title}@}
+\part[@var{toc-title}]@{@var{title}@}
+ at end example
+
+Start a document part. The standard @LaTeX{} classes @code{book},
+ at code{report}, and @code{article}, all have this command.
+
+This produces a document part, in a book.
+
+ at example
+\part@{VOLUME I \\
+ PERSONAL MEMOIRS OF U.\ S.\ GRANT@}
+\chapter@{ANCESTRY--BIRTH--BOYHOOD.@}
+My family is American, and has been for generations,
+in all its branches, direct and collateral.
+ at end example
+
+In each standard class the @code{\part} command outputs a part number
+such as @samp{Part I}, alone on its line, in boldface, and in large
+type. Then @LaTeX{} outputs @var{title}, also alone on its line, in
+bold and in even larger type. In class @code{book}, the @LaTeX{}
+default puts each part alone on its own page. If the book is two-sided
+then @LaTeX{} will skip a page if needed to have the new part on an
+odd-numbered page. In @code{report} it is again alone on a page, but
+ at LaTeX{} won't force it onto an odd-numbered page. In an @code{article}
+ at LaTeX{} does not put it on a fresh page, but instead outputs the part
+number and part title onto the main document page.
+
+The @code{*}@tie{}form shows @var{title}
+but it does not show the part number, does not increment the
+ at code{part} counter, and produces no table of contents entry.
+
+The optional argument @var{toc-title} will appear as the part title in
+the table of contents (@pxref{Table of contents etc.}) and in running
+headers (@pxref{Page styles}). If it is not present then @var{title}
+will be there. This example puts a line break in @var{title} but leaves
+out the break in the table of contents.
+
+ at example
+\part[Up from the bottom; my life]@{Up from the bottom\\ my life@}
+ at end example
+
+For determining which sectional units are numbered and which appear in
+the table of contents, the level number of a part is at tie{}-1
+(@pxref{Sectioning/secnumdepth} and @pxref{Sectioning/tocdepth}).
+
+ at PkgIndex{indentfirst}
+In the class @code{article}, if a paragraph immediately follows the part
+title then it is not indented. To get an indent you can use the package
+ at file{indentfirst}.
+
+ at PkgIndex{titlesec}
+One package to change the behavior of @code{\part} is @file{titlesec}.
+See its documentation on CTAN.
+
+
+ at node \chapter
+ at c À traduire
+ at section @code{\chapter}
+
+ at findex \chapter
+ at cindex chapter
+
+Synopsis, one of:
+
+ at example
+\chapter@{@var{title}@}
+\chapter*@{@var{title}@}
+\chapter[@var{toc-title}]@{@var{title}@}
+ at end example
+
+Start a chapter. The standard @LaTeX{} classes @code{book} and
+ at code{report} have this command but @code{article} does not.
+
+This produces a chapter.
+
+ at example
+\chapter@{Loomings@}
+Call me Ishmael.
+Some years ago---never mind how long precisely---having little or no
+money in my purse, and nothing particular to interest me on shore, I
+thought I would sail about a little and see the watery part of
+the world.
+ at end example
+
+The @LaTeX{} default starts each chapter on a fresh page, an
+odd-numbered page if the document is two-sided. It produces a chapter
+number such as @samp{Chapter 1} in large boldface type (the size is
+ at code{\huge}). It then puts @var{title} on a fresh line, in boldface
+type that is still larger (size @code{\Huge}). It also increments the
+ at code{chapter} counter, adds an entry to the table of contents
+(@pxref{Table of contents etc.}), and sets the running header
+information (@pxref{Page styles}).
+
+The @code{*}@tie{}form shows @var{title} on a fresh line, in boldface.
+But it does not show the chapter number, does not increment the
+ at code{chapter} counter, produces no table of contents entry, and does
+not affect the running header. (If you use the page style
+ at code{headings} in a two-sided document then the header will be from the
+prior chapter.) This example illustrates.
+
+ at example
+\chapter*@{Preamble@}
+ at end example
+
+The optional argument @var{toc-title} will appear as the chapter title
+in the table of contents (@pxref{Table of contents etc.}) and in
+running headers (@pxref{Page styles}). If it is not present then
+ at var{title} will be there. This shows the full name in the chapter
+title,
+
+ at example
+\chapter[Weyl]@{Hermann Klaus Hugo (Peter) Weyl (1885--1955)@}
+ at end example
+
+ at noindent
+but only @samp{Weyl} on the contents page. This puts a line break in
+the title but that doesn't work well with running headers so it omits
+the break in the contents
+
+ at example
+\chapter[Given it all\\ my story]@{Given it all\\ my story@}
+ at end example
+
+For determining which sectional units are numbered and which appear in
+the table of contents, the level number of a chapter is at tie{}0
+(@pxref{Sectioning/secnumdepth} and @pxref{Sectioning/tocdepth}).
+
+ at PkgIndex{indentfirst}
+The paragraph that follows the chapter title is not indented, as is a
+standard typographical practice. To get an indent use the package
+ at file{indentfirst}.
+
+You can change what is shown for the chapter number. To change it to
+something like @samp{Lecture 1}, put in the preamble either
+ at code{\renewcommand@{\chaptername@}@{Lecture@}} or this
+(@pxref{\makeatletter & \makeatother}).
+
+ at example
+\makeatletter
+\renewcommand@{\@@chapapp@}@{Lecture@}
+\makeatother
+ at end example
+
+ at PkgIndex{babel}
+ at noindent To make this change because of the primary language for
+the document, see the package @file{babel}.
+
+In a two-sided document @LaTeX{} puts a chapter on odd-numbered page, if
+necessary leaving an even-numbered page that is blank except for any
+running headers. To make that page completely blank,
+see at tie{}@ref{\clearpage & \cleardoublepage}.
+
+ at PkgIndex{titlesec}
+To change the behavior of the @code{\chapter} command, you can copy its
+definition from the @LaTeX{} format file and make adjustments. But
+there are also many packages on CTAN that address this. One is
+ at file{titlesec}. See its documentation, but the example below gives a
+sense of what it can do.
+
+ at example
+\usepackage@{titlesec@} % in preamble
+\titleformat@{\chapter@}
+ @{\Huge\bfseries@} % format of title
+ @{@} % label, such as 1.2 for a subsection
+ @{0pt@} % length of separation between label and title
+ @{@} % before-code hook
+ at end example
+
+ at noindent
+This omits the chapter number @samp{Chapter 1} from the page but unlike
+ at code{\chapter*} it keeps the chapter in the table of contents and the
+running headers.
+
+
+ at node \section
+ at c À traduire
+ at section @code{\section}
+
+ at findex \section
+ at cindex section
+
+Synopsis, one of:
+
+ at example
+\section@{@var{title}@}
+\section*@{@var{title}@}
+\section[@var{toc-title}]@{@var{title}@}
+ at end example
+
+Start a section. The standard @LaTeX{} classes @code{article},
+ at code{book}, and @code{report} all have this command.
+
+This produces a section.
+
+ at example
+In this Part we tend to be more interested in the function,
+in the input-output behavior,
+than in the details of implementing that behavior.
+
+\section@{Turing machines@}
+Despite this desire to downplay implementation,
+we follow the approach of A~Turing that the
+first step toward defining the set of computable functions
+is to reflect on the details of what mechanisms can do.
+ at end example
+
+For the standard @LaTeX{} classes @code{book} and @code{report} the
+default output is like @samp{1.2 @var{title}} (for chapter at tie{}1,
+section at tie{}2), alone on its line and flush left, in boldface and a
+larger type (the type size is @code{\Large}). The same holds in
+ at code{article} except that there are no chapters in that class so it
+looks like @samp{2 @var{title}}.
+
+The @code{*}@tie{}form shows @var{title}.
+But it does not show the section number, does not increment the
+ at code{section} counter, produces no table of contents entry, and does
+not affect the running header. (If you use the page style
+ at code{headings} in a two-sided document then the header will be from the
+prior section.)
+
+The optional argument @var{toc-title} will appear as the section title
+in the table of contents (@pxref{Table of contents etc.}) and in
+running headers (@pxref{Page styles}). If it is not present then
+ at var{title} will be there. This shows the full name in the title of the
+section,
+
+ at example
+\section[Elizabeth~II]@{Elizabeth the Second,
+ by the Grace of God of the United Kingdom,
+ Canada and Her other Realms and Territories Queen,
+ Head of the Commonwealth, Defender of the Faith.@}
+ at end example
+
+ at noindent
+but only @samp{Elizabeth II} on the contents page and in the headers.
+This has a line break in @var{title} but that does not work with headers
+so it is omitted from the contents and headers.
+
+ at example
+\section[Truth is, I cheated; my life story]@{Truth is,
+ I cheated\\my life story@}
+ at end example
+
+For determining which sectional units are numbered and which appear in
+the table of contents, the level number of a section is at tie{}1
+(@pxref{Sectioning/secnumdepth} and @pxref{Sectioning/tocdepth}).
+
+ at PkgIndex{indentfirst}
+The paragraph that follows the section title is not indented, as is a
+standard typographical practice. One way to get an indent is to use the
+package @file{indentfirst}.
+
+ at PkgIndex{titlesec}
+In general, to change the behavior of the @code{\section} command, there
+are a number of options. One is the @code{\@@startsection} command
+(@pxref{\@@startsection}). There are also many packages on CTAN that
+address this, including @file{titlesec}. See the documentation but the
+example below gives a sense of what they can do.
+
+ at c credit: egreg https://groups.google.com/forum/#!topic/comp.text.tex/tvc8oM5P4y4
+ at example
+\usepackage@{titlesec@} % in preamble
+\titleformat@{\section@}
+ @{\normalfont\Large\bfseries@} % format of title
+ @{\makebox[1pc][r]@{\thesection\hspace@{1pc@}@}@} % label
+ @{0pt@} % length of separation between label and title
+ @{@} % before-code hook
+\titlespacing*@{\section@}
+ @{-1pc@}@{18pt@}@{10pt@}[10pc]
+ at end example
+
+ at noindent
+That puts the section number in the margin.
+
+
+ at node \subsection
+ at c À traduire
+ at section @code{\subsection}
+
+ at findex \subsection
+ at cindex subsection
+
+Synopsis, one of:
+
+ at example
+\subsection@{@var{title}@}
+\subsection*@{@var{title}@}
+\subsection[@var{toc-title}]@{@var{title}@}
+ at end example
+
+Start a subsection. The standard @LaTeX{} classes @code{article},
+ at code{book}, and @code{report} all have this command.
+
+This produces a subsection.
+
+ at example
+We will show that there are more functions than Turing machines and that
+therefore some functions have no associated machine.
+
+\subsection@{Cardinality@} We will begin with two paradoxes that
+dramatize the challenge to our intuition posed by comparing the sizes of
+infinite sets.
+ at end example
+
+For the standard @LaTeX{} classes @code{book} and @code{report} the
+default output is like @samp{1.2.3 @var{title}} (for chapter at tie{}1,
+section at tie{}2, subsection at tie{}3), alone on its line and flush left, in
+boldface and a larger type (the type size is @code{\large}). The same
+holds in @code{article} except that there are no chapters in that class
+so it looks like @samp{2.3 @var{title}}.
+
+The @code{*}@tie{}form shows @var{title}.
+But it does not show the section number, does not increment the
+ at code{section} counter, and produces no table of contents entry.
+
+The optional argument @var{toc-title} will appear as the section title
+in the table of contents (@pxref{Table of contents etc.}). If it is
+not present then @var{title} will be there. This shows the full name in
+the title of the section,
+
+ at example
+\subsection[$\alpha,\beta,\gamma$ paper]@{\textit@{The Origin of
+ Chemical Elements@} by R.A.~Alpher, H.~Bethe, and G.~Gamow@}
+ at end example
+
+ at noindent
+but only @samp{@BES{03B1,\alpha}, at BES{03B2,\beta}, at BES{03B3,\gamma}
+paper} on the contents page.
+
+For determining which sectional units are numbered and which appear in
+the table of contents, the level number of a subsection is at tie{}2
+(@pxref{Sectioning/secnumdepth} and @pxref{Sectioning/tocdepth}).
+
+ at PkgIndex{indentfirst}
+The paragraph that follows the subsection title is not indented, as is a
+standard typographical practice. One way to get an indent is to use the
+package @file{indentfirst}.
+
+ at PkgIndex{titlesec}
+There are a number of ways to change the behavior of the
+ at code{\subsection} command. One is the @code{\@@startsection} command
+(@pxref{\@@startsection}). There are also many packages on CTAN that
+address this, including @file{titlesec}. See the documentation but the
+example below gives a sense of what they can do.
+
+ at example
+\usepackage@{titlesec@} % in preamble
+\titleformat@{\subsection@}[runin]
+ @{\normalfont\normalsize\bfseries@} % format of the title
+ @{\thesubsection@} % label
+ @{0.6em@} % space between label and title
+ @{@} % before-code hook
+ at end example
+
+ at noindent
+That puts the subsection number and @var{title} in the first line of
+text.
+
+
+ at node \subsubsection & \paragraph & \subparagraph
+ at c À traduire
+ at section @code{\subsubsection}, @code{\paragraph}, @code{\subparagraph}
+
+ at findex \subsubsection
+ at cindex subsubsection
+ at findex \paragraph
+ at cindex paragraph
+ at findex \subparagraph
+ at cindex subparagraph
+
+Synopsis, one of:
+
+ at example
+\subsubsection@{@var{title}@}
+\subsubsection*@{@var{title}@}
+\subsubsection[@var{toc-title}]@{@var{title}@}
+ at end example
+
+ at noindent
+or one of:
+
+ at example
+\paragraph@{@var{title}@}
+\paragraph*@{@var{title}@}
+\paragraph[@var{toc-title}]@{@var{title}@}
+ at end example
+
+ at noindent
+or one of:
+
+ at example
+\subparagraph@{@var{title}@}
+\subparagraph*@{@var{title}@}
+\subparagraph[@var{toc-title}]@{@var{title}@}
+ at end example
+
+Start a subsubsection, paragraph, or subparagraph. The standard
+ at LaTeX{} classes @code{article}, @code{book}, and @code{report} all have
+these commands, although they are not commonly used.
+
+This produces a subsubsection.
+
+ at example
+\subsubsection@{Piston ring compressors: structural performance@}
+Provide exterior/interior wall cladding assemblies
+capable of withstanding the effects of load and stresses from
+consumer-grade gasoline engine piston rings.
+ at end example
+
+The default output of each of the three does not change over the
+standard @LaTeX{} classes @code{article}, @code{book}, and
+ at code{report}. For @code{\subsubsection} the @var{title} is alone on
+its line, in boldface and normal size type. For @code{\paragraph} the
+ at var{title} is inline with the text, not indented, in boldface and
+normal size type. For @code{\subparagraph} the @var{title} is inline
+with the text, with a paragraph indent, in boldface and normal size type
+(Because an @code{article} has no chapters its subsubsections are
+numbered and so it looks like @samp{1.2.3 @var{title}}, for
+section at tie{}1, subsection at tie{}2, and subsubsection at tie{}3. The other
+two divisions are not numbered.)
+
+The @code{*}@tie{}form shows @var{title}. But it does not increment the
+associated counter and produces no table of contents entry (and does not
+show the number for @code{\subsubsection}).
+
+The optional argument @var{toc-title} will appear as the division title
+in the table of contents (@pxref{Table of contents etc.}). If it is
+not present then @var{title} will be there.
+
+For determining which sectional units are numbered and which appear in
+the table of contents, the level number of a subsubsection is at tie{}3, of
+a paragraph is at tie{}4, and of a subparagraph is at tie{}5
+(@pxref{Sectioning/secnumdepth} and @pxref{Sectioning/tocdepth}).
+
+ at PkgIndex{indentfirst}
+The paragraph that follows the subsubsection title is not indented, as is a
+standard typographical practice. One way to get an indent is to use the
+package @file{indentfirst}.
+
+ at PkgIndex{titlesec}
+There are a number of ways to change the behavior of the these commands.
+One is the @code{\@@startsection} command (@pxref{\@@startsection}).
+There are also many packages on CTAN that address this, including
+ at file{titlesec}. See the documentation on CTAN.
+
+
+ at node \appendix
+ at c À traduire
+ at section @code{\appendix}
+
+ at findex \appendix
+ at cindex appendix
+ at cindex appendices
+
+Synopsis:
+
+ at example
+\appendix
+ at end example
+
+This does not directly produce any output. But in a book or report it
+declares that subsequent @code{\chapter} commands start an appendix. In
+an article it does the same, for @code{\section} commands. It also
+resets the @code{chapter} and @code{section} counters to at tie{}0 in a
+book or report, and in an article resets the @code{section} and
+ at code{subsection} counters.
+
+In this book
+
+ at example
+\chapter@{One@} ...
+\chapter@{Two@} ...
+ ...
+\appendix
+\chapter@{Three@} ...
+\chapter@{Four@} ...
+ at end example
+
+ at noindent
+the first two will generate output numbered @samp{Chapter 1} and
+ at samp{Chapter 2}. After the @code{\appendix} the numbering will be
+ at samp{Appendix A} and @samp{Appendix B}. @xref{Larger book template}
+for another example.
+
+ at PkgIndex{appendix} The @file{appendix} package adds the command
+ at code{\appendixpage} to put a separate @samp{Appendices} in the document
+body before the first appendix, and the command @code{\addappheadtotoc}
+to do the same in the table of contents. You can reset the name
+ at samp{Appendix} with a command like
+ at code{\renewcommand@{\appendixname@}@{Specification@}}, as well as a
+number of other features. See the documentation on CTAN.
+
+
+ at node \frontmatter & \mainmatter & \backmatter
+ at c À traduire
+ at section @code{\frontmatter}, @code{\mainmatter}, @code{\backmatter}
+
+ at findex \frontmatter
+ at cindex book, front matter
+ at findex \mainmatter
+ at cindex book, main matter
+ at findex \backmatter
+ at cindex book, back matter
+ at cindex book, end matter
+
+Synopsis, one of:
+
+ at example
+\frontmatter
+\mainmatter
+\backmatter
+ at end example
+
+Format a @code{book} class document differently according to which part
+of the document is being produced. All three commands are optional.
+
+Traditionally, a book's front matter contains such things as the title
+page, an abstract, a table of contents, a preface, a list of notations,
+a list of figures, and a list of tables. (Some of these front matter
+pages, such as the title page, are traditionally not numbered.) The
+back matter may contain such things as a glossary, notes, a
+bibliography, and an index.
+
+The @code{\frontmatter} declaration makes the pages numbered in
+lowercase roman, and makes chapters not numbered, although each
+chapter's title appears in the table of contents; if you use other
+sectioning commands here, use the @code{*}-version (@pxref{Sectioning}).
+The @code{\mainmatter} changes the behavior back to the expected
+version, and resets the page number. The @code{\backmatter} leaves the
+page numbering alone but switches the chapters back to being not
+numbered. @xref{Larger book template} for an example using the three.
+
+
@node \@@startsection
@section @code{\@@startsection}
+ at c xxx Revoir la traduction
Synopsis :
@example
More information about the latexrefman-commits
mailing list.