summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/koma-script/source-doc/english/scrbookreportarticle.tex
diff options
context:
space:
mode:
Diffstat (limited to 'macros/latex/contrib/koma-script/source-doc/english/scrbookreportarticle.tex')
-rw-r--r--macros/latex/contrib/koma-script/source-doc/english/scrbookreportarticle.tex65
1 files changed, 42 insertions, 23 deletions
diff --git a/macros/latex/contrib/koma-script/source-doc/english/scrbookreportarticle.tex b/macros/latex/contrib/koma-script/source-doc/english/scrbookreportarticle.tex
index b20b18726b..881f61b7a1 100644
--- a/macros/latex/contrib/koma-script/source-doc/english/scrbookreportarticle.tex
+++ b/macros/latex/contrib/koma-script/source-doc/english/scrbookreportarticle.tex
@@ -46,13 +46,13 @@
% ============================================================================
\KOMAProvidesFile{scrbookreportarticle.tex}
- [$Date: 2019-01-14 14:29:39 +0100 (Mon, 14 Jan 2019) $
+ [$Date: 2019-10-10 09:50:23 +0200 (Thu, 10 Oct 2019) $
KOMA-Script guide (chapter: scrbook, scrreprt, scrartcl)]
\translator{Jens-Uwe Morawski\and Gernot Hassenpflug\and Markus Kohm\and
Krickette Murabayashi\and Jana Schubert\and Jens H\"uhne\and Karl Hagen}
-% Date of the translated German file: 2019-01-14
+% Date of the translated German file: 2019-10-09
\chapter{The Main Classes: \Class{scrbook}, \Class{scrreprt}, and
\Class{scrartcl}}
@@ -279,7 +279,7 @@ tables and figures, after the table of contents (see
\DescRef{maincls-experts.cmd.DeclareNewSectionCommand},
\DescRef{maincls-experts.cmd.RedeclareSectionCommand}, and
\DescRef{maincls-experts.cmd.ProvideSectionCommand} can also affect the
- table of contents. See \autoref{sec:maincls-experts.experts},
+ table of contents. See \autoref{sec:maincls-experts.sections},
\DescPageRef{maincls-experts.cmd.DeclareSectionCommand}.%
\else%
In addition to the options documented in this section, the
@@ -299,7 +299,7 @@ tables and figures, after the table of contents (see
\IndexCmd{DeclareNewSectionCommand} and
\DescRef{maincls-experts.cmd.RedeclareSectionCommand}%
\IndexCmd{RedeclareSectionCommand} documented in
- \autoref{sec:maincls-experts.experts},
+ \autoref{sec:maincls-experts.sections},
\DescPageRef{maincls-experts.cmd.DeclareSectionCommand} can also affect the
table of contents.%
\fi
@@ -1002,9 +1002,10 @@ You can redefine the page styles with the \Macro{renewcommand} macro.
example. Of course, you can also use a user-defined page style.
Suppose you have defined your own page style for initial chapter pages with
- the \hyperref[cha:scrlayer]{\Package{scrlayer}} (see \autoref{cha:scrlayer})
- or the \hyperref[cha:scrlayer-scrpage-experts]{\Package{scrlayer-scrpage}}
- package (see \autoref{cha:scrlayer-scrpage-experts}). You have given this
+ the \hyperref[cha:scrlayer]{\Package{scrlayer}} (see
+ \autoref{sec:scrlayer.pagestyles}) or the
+ \hyperref[cha:scrlayer-scrpage]{\Package{scrlayer-scrpage}} package (see
+ \autoref{sec:scrlayer-scrpage-experts.pagestyle.pairs}). You have given this
page style the fitting name of \PValue{chapter}. To actually use this style,
you must redefine \Macro{chapterpagestyle} in this way:
\begin{lstcode}
@@ -1414,7 +1415,7 @@ You can find additional settings for chapter headings in the explanation for
\DescRef{maincls-experts.cmd.RedeclareSectionCommand} and the commands
\DescRef{maincls-experts.cmd.chapterlineswithprefixformat} and
\DescRef{maincls-experts.cmd.chapterlinesformat} in
-\autoref{sec:maincls-experts.experts}, \autoref{part:forExperts}.%
+\autoref{sec:maincls-experts.sections}, \autoref{part:forExperts}.%
\EndIndexGroup
@@ -1782,25 +1783,28 @@ extended interpretation of the optional argument \PName{short version}, which
is not active by default.
The \ChangedAt{v3.10}{\Class{scrbook}\and \Class{scrreprt}\and
- \Class{scrartcl}} extended interpretation of the optional argument
-checks to see if there is an equals sign in \PName{short version}. If so,
-the optional argument will be interpreted as an \PName{option list}.
+ \Class{scrartcl}} extended interpretation of the optional argument checks to
+see if there is an equals sign in \PName{short version}. If so, the optional
+argument will be interpreted as an \PName{option list}.
Three options\,---\,\OptionVName{head}{running head}\important{\Option{head}\\
\Option{tocentry}\\
- \Option{reference}}, \OptionVName{tocentry}{table of contents entry}, and
+ \Option{reference}\\
+ \Option{nonumber}}, \OptionVName{tocentry}{table of contents entry},
\OptionVName{reference}{reference title}%
-\ChangedAt{v3.22}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}}%
-\,---\,are supported with this format. To use commas or equals signs
-within the values of those options, you must enclose them in braces.
+\ChangedAt{v3.22}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}},
+and \OptionVName{nonumber}{simple switch}\ChangedAt{v3.27}{\Class{scrbook}\and
+ \Class{scrreprt}\and \Class{scrartcl}}\,---\,are supported with this
+format. To use commas or equals signs within the values of those options, you
+must enclose them in braces.
Please\textnote{Attention!} note that this mechanism only works as long as
\KOMAScript{} controls the sectioning commands. If you use package that
redefines the \KOMAScript{}'s or the internal \LaTeX{} kernel's sectioning
commands, \KOMAScript{} can no longer provide this extended mechanism. This
-also applies to a \KOMAScript{} that is always active: sectioning commands
-with no heading text\textnote{empty headings} do not create entries in the
-table of contents. If you really want an entry with empty heading text, you
-can use an invisible entry like \lstinline|\mbox{}|.
+also applies to a \KOMAScript{} extension that is always active: sectioning
+commands with no heading text\textnote{empty headings} do not create entries
+in the table of contents. If you really want an entry with empty heading text,
+you can use an invisible entry like \lstinline|\mbox{}|.
\begin{Example}
Suppose you have a document with very long chapter headings. These headings
@@ -1888,6 +1892,18 @@ option, or setting the title of a table-of-contents entry with the
performance is poor compared to the other two, and it is not fully compatible
with \Package{hyperref}\IndexPackage{hyperref}\important{\Package{hyperref}}.
+You can deactivate the numbering using
+\OptionValue{nonumber}{true}\important{\Option{nonumber}}%
+\ChangedAt{v3.27}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}}
+in the extended optional argument. In contrast to the
+\hyperref[desc:maincls.cmd.part*]{starred versions of the sectioning commands}
+explained below, the titles will still be added to the table of contents and,
+if applicable, used for the running head. For \Macro{part}, \Macro{chapter},
+and \Macro{section}, using \OptionValue{nonumber}{true} this essentially
+corresponds to the \DescRef{\LabelBase.cmd.addpart},
+\DescRef{\LabelBase.cmd.addchap}, and \DescRef{\LabelBase.cmd.addsec}
+commands, which are explained on \DescPageRef{\LabelBase.cmd.addpart}.
+
The part-level title\important{\Macro{part}} (\Macro{part}) differs from other
sectioning levels by being numbered independently. This means that the chapter
level (in \Class{scrbook} or \Class{scrreprt}), or the section level (in
@@ -2160,7 +2176,10 @@ similar to the standard commands \DescRef{\LabelBase.cmd.part}\IndexCmd{part}%
\DescRef{\LabelBase.cmd.chapter}\IndexCmd{chapter} and
\DescRef{\LabelBase.cmd.section}\IndexCmd{section} except that they are
unnumbered. They thus produce both a running head and an entry in the table of
-contents.
+contents which take into account the \DescRef{\LabelBase.option.headings}%
+\important{\DescRef{\LabelBase.option.headings}} option settings, especially
+the handling of the optional argument. However, enabling or disabling the
+\Option{nonumber} switch will have no effect.
The starred variants \Macro{addchap*} and \Macro{addsec*} are similar to the
standard commands \DescRef{\LabelBase.cmd.chapter*} and
@@ -2553,7 +2572,7 @@ as well as
\DescRef{maincls-experts.cmd.sectionlinesformat}\IndexCmd{sectionlinesformat}
and its \DescRef{maincls-experts.cmd.sectioncatchphraseformat}%
\IndexCmd{sectioncatchphraseformat} format in
-\autoref{sec:maincls-experts.experts}, starting from
+\autoref{sec:maincls-experts.sections}, starting from
\DescPageRef{maincls-experts.cmd.partlineswithprefixformat}.%
\EndIndexGroup
@@ -2837,7 +2856,7 @@ heading will not be moved down. You are therefore responsible for ensuring
that the \PName{preamble} is not too large and that the space above the
heading is sufficient. See also the \Option{beforeskip} setting for
\DescRef{maincls-experts.cmd.RedeclareSectionCommand} in
-\autoref{sec:maincls-experts.experts},
+\autoref{sec:maincls-experts.sections},
\autoref{tab:maincls-experts.declarechapterstyle.keys},
\autopageref{tab:maincls-experts.declarechapterstyle.keys}.
%
@@ -4355,7 +4374,7 @@ modern and open kind of bibliography. The name comes from the fact that the
bibliography entries appear more structured. They are less compact and seem
more relaxed or open. Information about defining new bibliography styles can
be found in the description of the \DescRef{maincls-experts.cmd.newbibstyle}
-command in \autoref{sec:maincls-experts.experts},
+command in \autoref{sec:maincls-experts.bibliography},
\DescPageRef{maincls-experts.cmd.newbibstyle}.
In addition to the formatting style, you can select one more feature using